The document discusses Dockerized system testing using Arquillian Cube. It provides an overview of Arquillian Cube, which allows testing applications running in Docker containers or container-less environments. It demonstrates configuring Arquillian XML to specify Docker containers and properties, as well as writing tests that target applications deployed to Docker containers using Arquillian resources.

2. D O C K E R I Z E D S Y S T E M T E S T I N G ,
W I T H A D A S H O F C H A O S

3. S O F T W A R E I S
E A T I N G T H E W O R L D

4. I F D E B U G G I N G I S T H E P R O C E S S O F
R E M O V I N G S O F T W A R E B U G S,
T H E N P R O G R A M M I N G M U S T B E T H E P R O C E S S O F
P U T T I N G T H E M I N.
Edsger W. Dijkstra

8. A U T O M A T E D T E S T S A R E T H E S O L U T I O N

9. U N I T T E S T S A R E N O T E N O U G H

10. S O C I A B L E U N I T T E S T S

11. W I L L I T W O R K I N P R O D U C T I O N ?

12. H I G H - L E V E L T E S T S R U N N I N G I N
P R O D U C T I O N - L I K E E N V I R O N M E N T

13. W H Y D O N ' T W E W R I T E H I G H - L E V E L
T E S T S ?

16. W H A T I S A R Q U I L L I A N ?
Middleware for your tests

17. W H A T I S A R Q U I L L I A N ?
Middleware for your tests
Fills the gap between Unit/Integration tests

18. W H A T I S A R Q U I L L I A N ?
Middleware for your tests
Fills the gap between Unit/Integration tests
Java EE and beyond

19. W H A T I S A R Q U I L L I A N ?
Middleware for your tests
Fills the gap between Unit/Integration tests
Java EE and beyond
Any kind of high-level tests

20. W H A T I S A R Q U I L L I A N ?
Middleware for your tests
Fills the gap between Unit/Integration tests
Java EE and beyond
Any kind of high-level tests
Open Source

21. apply pluginapply plugin:: "io.spring.dependency-management""io.spring.dependency-management"
dependencyManagement dependencyManagement {{
imports imports {{
mavenBom mavenBom 'org.jboss.arquillian:arquillian-bom:...''org.jboss.arquillian:arquillian-bom:...'
}}
}}
B U I L D . G R A D L E

22. apply pluginapply plugin:: "io.spring.dependency-management""io.spring.dependency-management"
dependencyManagement dependencyManagement {{
imports imports {{
mavenBom mavenBom 'org.jboss.arquillian:arquillian-bom:...''org.jboss.arquillian:arquillian-bom:...'
}}
}}
dependencies dependencies {{
testCompile group testCompile group:: 'org.jboss.arquillian.junit''org.jboss.arquillian.junit',, name name:: 'arquillian-junit-container''arquillian-junit-container'
B U I L D . G R A D L E

23. apply pluginapply plugin:: "io.spring.dependency-management""io.spring.dependency-management"
dependencyManagement dependencyManagement {{
imports imports {{
mavenBom mavenBom 'org.jboss.arquillian:arquillian-bom:...''org.jboss.arquillian:arquillian-bom:...'
}}
}}
dependencies dependencies {{
testCompile group testCompile group:: 'org.jboss.arquillian.junit''org.jboss.arquillian.junit',, name name:: 'arquillian-junit-container''arquillian-junit-container'
testCompile testCompile 'org.apache.tomee:arquillian-tomee-remote:7.0.0''org.apache.tomee:arquillian-tomee-remote:7.0.0'
}}
B U I L D . G R A D L E

24. publicpublic classclass VolumeUnitsConverterResourceTestVolumeUnitsConverterResourceTest {{
@Test @Test
publicpublic voidvoid should_convert_ounces_to_millilitersshould_convert_ounces_to_milliliters(()) {{
givengiven(())..
baseUribaseUri(("http://localhost:8080/""http://localhost:8080/"))..
pathParampathParam(("amount""amount",, "8.0""8.0"))..
whenwhen(())..
getget(("/convert/volume/fl/ml/{amount}""/convert/volume/fl/ml/{amount}"))..
thenthen(())..
assertThatassertThat(())..bodybody((isis((equalToequalTo(("236.5882368""236.5882368"))))));;
}}
}}

25. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass VolumeUnitsConverterResourceTestVolumeUnitsConverterResourceTest {{
@ @DeploymentDeployment((testable testable == falsefalse))
publicpublic staticstatic Archive Archive<<??>> createDeploymentcreateDeployment(()) {{
returnreturn ShrinkWrap ShrinkWrap..createcreate((WebArchiveWebArchive..classclass,, "test.war""test.war"))
..addPackagesaddPackages((truetrue,, VolumeUnitsConverter VolumeUnitsConverter..classclass..getPackagegetPackage(())))
..addAsWebInfResourceaddAsWebInfResource((EmptyAssetEmptyAsset..INSTANCEINSTANCE,, "beans.xml""beans.xml"));;
}}
@Test @Test
publicpublic voidvoid should_convert_ounces_to_millilitersshould_convert_ounces_to_milliliters((@ArquillianResource URL applicationPath@ArquillianResource URL applicationPath)) {{
givengiven(())..
baseUribaseUri((applicationPathapplicationPath..toStringtoString(())))..
pathParampathParam(("amount""amount",, "8.0""8.0"))..
whenwhen(())..
getget(("/convert/volume/fl/ml/{amount}""/convert/volume/fl/ml/{amount}"))..
thenthen(())..
assertThatassertThat(())..bodybody((isis((equalToequalTo(("236.5882368""236.5882368"))))));;
}}
}}

26. D E M O

27. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests

28. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests
Executable from IDE and build tool

29. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests
Executable from IDE and build tool
Skip the build

30. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests
Executable from IDE and build tool
Skip the build
Reuse existing frameworks

31. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests
Executable from IDE and build tool
Skip the build
Reuse existing frameworks
Flexible and Extensible

32. P R I N C I P L E S O F A R Q U I L L I A N
Portable tests
Executable from IDE and build tool
Skip the build
Reuse existing frameworks
Flexible and Extensible
Makes writing high-level tests a breeze

34. I N S A N I T Y : D O I N G T H E S A M E T H I N G O V E R A N D O V E R A G A I N A N D
E X P E C T I N G D I F F E R E N T R E S U L T S .
Albert Einstein

35. D O C K E R

37. A R Q U I L L I A N C U B E

38. W H A T I S C U B E ?
Manage lifecycle of docker containers

39. W H A T I S C U B E ?
Manage lifecycle of docker containers
Orchestrates containers

40. W H A T I S C U B E ?
Manage lifecycle of docker containers
Orchestrates containers
Provides container objects

41. W H A T I S C U B E ?
Manage lifecycle of docker containers
Orchestrates containers
Provides container objects
Support for non-app server systems

42. W H A T I S C U B E ?
Manage lifecycle of docker containers
Orchestrates containers
Provides container objects
Support for non-app server systems
Ready for OpenShift v3

43. W H A T I S C U B E ?
Manage lifecycle of docker containers
Orchestrates containers
Provides container objects
Support for non-app server systems
Ready for OpenShift v3
Ready for Docker Machine

44. dependencies dependencies {{
testCompile testCompile 'org.arquillian.cube:arquillian-cube-docker:...''org.arquillian.cube:arquillian-cube-docker:...'
}}
B U I L D . G R A D L E

45. <<arquillianarquillian>>
<<extensionextension qualifierqualifier==""dockerdocker"">>
<<propertyproperty namename==""machineNamemachineName"">>devdev</</propertyproperty>>
<<propertyproperty namename==""definitionFormatdefinitionFormat"">>COMPOSECOMPOSE</</propertyproperty>>
<<propertyproperty namename==""dockerContainersFiledockerContainersFile"">>docker-compose.ymldocker-compose.yml</</propertyproperty>>
</</extensionextension>>
S R C / T E S T / R E S O U R C E S / A R Q U I L L I A N . X M L

46. <<arquillianarquillian>>
<<extensionextension qualifierqualifier==""dockerdocker"">>
<<propertyproperty namename==""machineNamemachineName"">>devdev</</propertyproperty>>
<<propertyproperty namename==""definitionFormatdefinitionFormat"">>COMPOSECOMPOSE</</propertyproperty>>
<<propertyproperty namename==""dockerContainersFiledockerContainersFile"">>docker-compose.ymldocker-compose.yml</</propertyproperty>>
</</extensionextension>>
<<containercontainer qualifierqualifier==""tomcattomcat"">>
<<configurationconfiguration>>
<<propertyproperty namename==""useruser"">>adminadmin</</propertyproperty>>
<<propertyproperty namename==""passpass"">>mypassmypass</</propertyproperty>>
</</configurationconfiguration>>
</</containercontainer>>
</</arquillianarquillian>>
S R C / T E S T / R E S O U R C E S / A R Q U I L L I A N . X M L

47. tomcattomcat::
env_file env_file:: envs envs
image image:: tutum tutum//tomcattomcat::7.07.0
ports ports::
-- "8089:8089""8089:8089"
-- "8088:8088""8088:8088"
-- "8081:8080""8081:8080"
links links::
-- pingpong pingpong::pingpongpingpong
pingpong pingpong::
image image:: jonmorehouse jonmorehouse//pingping--pongpong
ports ports::
-- "8080:8080""8080:8080"
D O C K E R - C O M P O S E . Y M L

48. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass HelloWorldServletTestHelloWorldServletTest {{
@ @DeploymentDeployment((testabletestable==falsefalse))
publicpublic staticstatic WebArchive WebArchive createcreate(()) {{
returnreturn ShrinkWrap ShrinkWrap..createcreate((WebArchiveWebArchive..classclass,, "hello.war""hello.war"))
..addClassaddClass((HelloWorldServletHelloWorldServlet..classclass));;
}}
P I N G P O N G T E S T . J A V A

49. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass HelloWorldServletTestHelloWorldServletTest {{
@ @DeploymentDeployment((testabletestable==falsefalse))
publicpublic staticstatic WebArchive WebArchive createcreate(()) {{
returnreturn ShrinkWrap ShrinkWrap..createcreate((WebArchiveWebArchive..classclass,, "hello.war""hello.war"))
..addClassaddClass((HelloWorldServletHelloWorldServlet..classclass));;
}}
@HostIp @HostIp
String hostIp String hostIp;;
@ @HostPortHostPort((containerName containerName == "tomcat""tomcat",, value value == 80808080))
int tomcatPort int tomcatPort;;
P I N G P O N G T E S T . J A V A

50. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass HelloWorldServletTestHelloWorldServletTest {{
@ @DeploymentDeployment((testabletestable==falsefalse))
publicpublic staticstatic WebArchive WebArchive createcreate(()) {{
returnreturn ShrinkWrap ShrinkWrap..createcreate((WebArchiveWebArchive..classclass,, "hello.war""hello.war"))
..addClassaddClass((HelloWorldServletHelloWorldServlet..classclass));;
}}
@HostIp @HostIp
String hostIp String hostIp;;
@ @HostPortHostPort((containerName containerName == "tomcat""tomcat",, value value == 80808080))
int tomcatPort int tomcatPort;;
@Test @Test
publicpublic voidvoid testtest((@ArquillianResource URL base@ArquillianResource URL base)) throws IOException throws IOException {{
URL obj URL obj == newnew URLURL((basebase,, "HelloWorld""HelloWorld"));;
}}
P I N G P O N G T E S T . J A V A

51. C O N T A I N E R L E S S

52. W H A T I S C O N T A I N E RL E S S ?
Runs any application that runs on Docker

53. W H A T I S C O N T A I N E RL E S S ?
Runs any application that runs on Docker
Including but not limited to node.js, Wildfly Swarm, Spring Boot, Vert.x, Go

54. W H A T I S C O N T A I N E RL E S S ?
Runs any application that runs on Docker
Including but not limited to node.js, Wildfly Swarm, Spring Boot, Vert.x, Go
Shrinkwrap support

55. dependencies dependencies {{
testCompile testCompile 'org.arquillian.cube:arquillian-cube-containerless:...''org.arquillian.cube:arquillian-cube-containerless:...'
}}
B U I L D . G R A D L E

56. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass NodeTestNodeTest {{
@ @DeploymentDeployment((testable testable == falsefalse))
publicpublic staticstatic GenericArchive GenericArchive createDeploymentcreateDeployment(()) {{
returnreturn ShrinkWrap ShrinkWrap..createcreate((GenericArchiveGenericArchive..classclass,, "app.tar""app.tar"))
..addadd((newnew FileAssetFileAsset((newnew FileFile(("src/test/js/index.js""src/test/js/index.js")))),, "index.js""index.js"))
..addadd((newnew FileAssetFileAsset((newnew FileFile(("src/test/js/package.json""src/test/js/package.json")))),, "package.json""package.json"));;
}}
@Test @Test
publicpublic voidvoid should_work_its_javascriptshould_work_its_javascript((@ArquillianResource URL base@ArquillianResource URL base)) {{
// ...// ...
}}
}}
N O D E T E S T . J A V A

57. FROM nodeFROM node::latestlatest
RUN mkdir RUN mkdir --p p //usrusr//srcsrc//appapp
WORKDIR WORKDIR //usrusr//srcsrc//appapp
ADD $ADD ${{deployableFilenamedeployableFilename}} //usrusr//srcsrc//appapp
RUN npm installRUN npm install
EXPOSE EXPOSE 80808080
CMD CMD [[ "npm""npm",, "start""start" ]]
D O C K E R F I L E T E M P L A T E

58. D E M O

60. T R Y D O C K E R
Run builds in containers

61. T R Y D O C K E R
Run builds in containers
More than one at the time

62. T R Y D O C K E R
Run builds in containers
More than one at the time
Use isolated networks

63. D E M O

66. A R Q U I L L I A N C U B E Q

67. W H A T I S Q ?

68. W H A T I S Q : C O N T A I N E R C H A O S ?
stop, kill & remove containers

69. W H A T I S Q : S Y S T E M C H A O S ?
block ports, burn cpu, burn io, fill disk, kill process & null route

70. W H A T I S Q : N E T W O R K C H A O S ?
latency, bandwidth, down, timeout

72. helloworldhelloworld::
image image:: lordofthejars lordofthejars//helloworldhelloworld
ports ports::
-- "8081:8080""8081:8080"
links links::
-- pingpong pingpong::pingpongpingpong
pingpongpingpong::
image image:: jonmorehouse jonmorehouse//pingping--pongpong
expose expose::
-- "8080""8080"
D O C K E R - C O M P O S E . Y M L

73. dependencies dependencies {{
testCompile testCompile 'org.arquillian.cube.q:arquillian-cube-q-toxic:...''org.arquillian.cube.q:arquillian-cube-q-toxic:...'
}}
B U I L D . G R A D L E

74. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass ToxicTestCaseToxicTestCase {{
@ArquillianResource @ArquillianResource
privateprivate NetworkChaos networkChaos NetworkChaos networkChaos;;
@HostIp @HostIp
privateprivate String ip String ip;;
T O X I C T E S T C A S E . J A V A

75. @@RunWithRunWith((ArquillianArquillian..classclass))
publicpublic classclass ToxicTestCaseToxicTestCase {{
@ArquillianResource @ArquillianResource
privateprivate NetworkChaos networkChaos NetworkChaos networkChaos;;
@HostIp @HostIp
privateprivate String ip String ip;;
@Test @Test
publicpublic voidvoid should_survive_on_latencyshould_survive_on_latency(()) throws Exception throws Exception {{
networkChaos networkChaos..onon(("pingpong""pingpong",, 80808080))..latencylatency((40004000,, 00,, (()) -->> {{
URL url URL url == newnew URLURL(("http://""http://" ++ ip ip ++ ":"":" ++ 80818081 ++ "/hw/HelloWorld""/hw/HelloWorld"));;
String response String response == IOUtil IOUtil..asStringasString((urlurl..openStreamopenStream(())));;
}}));;
}}
}}
T O X I C T E S T C A S E . J A V A

76. D E M O

77. L E T ' S R E C A P

78. Unit tests are important

79. Unit tests are important
So are the tests in production-like environment

80. Unit tests are important
So are the tests in production-like environment
When it hurts automate!

81. Unit tests are important
So are the tests in production-like environment
When it hurts automate!
Arquillian works for Non Java projects

82. Unit tests are important
So are the tests in production-like environment
When it hurts automate!
Arquillian works for Non Java projects
Expect unexpected

83. Unit tests are important
So are the tests in production-like environment
When it hurts automate!
Arquillian works for Non Java projects
Expect unexpected
Arquillian extensions

84. B A R T O S Z M A J S A K
R E D H A T
S O F T W A R E E N G I N E E R
@ M A J S O N
 majson  bartoszmajsak

85. github.com/lordofthejars/pingpongQ
github.com/arquillian/arquillian-cube/tree/master/docker/ftest-docker-containerobject
github.com/arquillian/arquillian-cube/tree/master/docker/ftest-docker-compose
toxiproxy.io
A R Q U I L L I A N . O R G
D I S C U S S . A R Q U I L L I A N . O R G

86. C R E A T I V E C O M M O N S P I C T U R E S
S L I D E 1 3 - H T T P S : / / W W W . F L I C K R . C O M / P H O T O S / F R O D E R I K / 8 2 8 3 7 2 4 2 4 0 /
S L I D E 1 4 - H T T P S : / / W W W . F L I C K R . C O M / P H O T O S / D O O K I N G T O N / 8 4 4 5 5 0 4 3 9 6
S L I D E 2 2 - H T T P S : / / W W W . F L I C K R . C O M / P H O T O S / T H O M A S H A W K / 2 6 8 1 7 4 4 7 3 9
S L I D E 3 8 - H T T P S : / / W W W . F L I C K R . C O M / P H O T O S / N E E L S A N D R I N E / 1 9 5 4 4 4 2 8 2 8 6
S L I D E 4 2 - H T T P S : / / W W W . F L I C K R . C O M / P H O T O S / A L P H A C H I M P S T U D I O / 1 3 1 4 1 9 9 0 6 2