Integración de pruebas con Docker

Siguiendo con la serie de tutoriales dedicados a Docker,
vamos a ver como integrar Docker dentro de nuestros proyectos a través de Maven
y como lanzar nuestros test de integración sobre una base de datos creada en un contenedor.

0. Índice de contenidos

• 1. Introducción
• 2. Entorno
• 3. Plugins Maven Docker
• 4. Configuración del plugin
• 5. Integración con Test de Integración
• 6. Conclusiones
• 7. Referencias

1. Introducción

En el tutorial Docker para Bases de Datos
habíamos creado una serie de imágenes con diferentes motores de BBDD, ahora vamos a dar un paso más y vamos a integrar una de estas
imágenes (en concreto la imagen con DB2 )
dentro de nuestro proyecto Maven.

El objetivo es que durante la fase de tests de integración, construyamos la imagen con DB2, arranquemos el contenedor, ejecutemos los test de integración y destruyamos el
contenedor.

2. Entorno

El tutorial está escrito usando el siguiente entorno:

• Hardware: MacBook Pro 15' (2.3 GHz Intel Core i7, 16GB DDR3 SDRAM)
• Sistema Operativo: Mac OS X El Capitan 10.11
• Software: Docker 1.9.1, Docker Machine 0.5.2

3. Plugins Maven Docker

En la actualidad existen varios plugin para integrar docker con nuestros proyectos java, entre ellos destacamos:

• wouterd/docker-maven-plugin
• alexec/docker-maven-plugin
• spotify/docker-maven-plugin
• rhuss/docker-maven-plugin

Entre estas alternativas nos hemos decantado por rhuss/docker-maven-plugin, básicamente porque dispone de una documentación más completa.

Gracias a este plugin podemos hacer uso de docker a traves de Maven con los siguientes goals:

4. Configuración del plugin

En este apartado vamos a ver como configuramos el plugin:

<plugin>
	<groupId>org.jolokia</groupId>
	<artifactId>docker-maven-plugin</artifactId>
	<version>0.13.6</version>
	<configuration>
		<logDate>default</logDate>
		<autoPull>true</autoPull>
		<images>
			<image>
				<alias>db</alias>
				<name>jpacheco/db2-formacion</name>
				<build>
					<assembly>
						<dockerFileDir>demo</dockerFileDir>
					</assembly>
				</build>
				<run>
					<privileged>true</privileged>
					<ports>
						<port>50001:50000</port>
					</ports>
					<wait>
						<time>200</time>
					</wait>
					<log>
						<color>yellow</color>
						<prefix>DB PRUEBA DOCKER MAVEN</prefix>
					</log>
					<cmd>db2start</cmd>
				</run>
			</image>
		</images>
	</configuration>

En el apartado configuration indicamos:

• logDate: que tome la configuración de fecha por defecto para los logs
• autoPull: indicamos que si las imágenes base no están en nuestro repositorio local, intente hacer un docker pull ..

En el apartado images describimos las imágenes que podemos gestionar desde nuestro proyecto.
En nuestro ejemplo vamos a describir la imagen con DB2
dentro del tag image :

• alias: Alias de la imagen (puede ser usada para vincularla a otra imagen)
• name: Nombre de la imagen

En la sección build le indicamos la configuración necesaria para construir la imagen, la información que tomará cuando ejecutemos mvn docker:build

• assembly / dockerFileDir :Directorio donde se encuentra el DockerFile y ficheros necesarios para construir la imagen

En la sección run le indicamos la configuración necesaria para arrancar un contenedor mvn docker:start

• privileged :Directorio donde se encuentra el DockerFile y ficheros necesarios para construir la imagen
• ports / port : Mapeo de puertos entre el contenedor y la máquina anfitriona
• wait / time : Tiempo en ms de espera a que arranque el contenedor
• log / color / prefix : Configuramos el color y el prefijo de los logs del plugin
• cmd : Comando de arranque del contenedor

Una vez configurado podemos ejecutar alguno de los goals del plugin:

mvn docker:build

Con la que construimos la imagen.

mvn docker:start

Arranca el contenedor, como podemos comprobar con docker ps.

	<executions>
	  <execution>
	    <id>start</id>
	    <phase>pre-integration-test</phase>
	    <goals>
	      <goal>build</goal>
	      <goal>start</goal>
	    </goals>
	  </execution>
	  <execution>
	    <id>stop</id>
	    <phase>post-integration-test</phase>
	    <goals>
	      <goal>stop</goal>
	      <goal>remove</goal>
	    </goals>
	  </execution>
	</executions>

	mvn clean verify -P integration