Dockerizar aplicación Spring Boot
En el anterior tutorial (Crear un Contenedor con Docker) ya expliqué qué era Docker y cómo crear un contenedor con un ejemplo básico.
En este tutorial iremos más allá y aprenderemos a dockerizar una aplicación Java Spring Boot.
A continuación se detallan los pasos:
Crear aplicación Spring Boot
En este ejemplo, voy a trabajar con un proyecto Spring Boot que ofrezca un servicio REST que devuelva un lista de usuarios. También puedes utilizar tu propio proyecto Spring Boot. Y sino, pues guiarte de este tutorial para crear tu proyecto: Crear una aplicación web con Spring Boot.
Generar librería de tu proyecto
Para ello, vamos a generar la librería con extensión .jar del proyecto web a través de un Run Configuration en Eclipse. Es muy sencillo:
- Abre tu proyecto en Eclipse.
- Observa que en el fichero maven pom.xml está configurado para generar una librería .jar:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.1.7.RELEASE</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>es.springboot</groupId>
<artifactId>SBServicesRest</artifactId>
<version>01</version>
<packaging>jar</packaging>
<name>SBServicesRest</name>
<description>Project Spring Boot Rest</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web-services</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
- Despliega las opciones del botón Run y elige Run Configurations…
- En la ventana que se abre, haz doble clic sobre Maven Build.
- Completa la información de la siguiente forma:
- Haz clic sobre Run para compilar y generar la librería.
- Observa que dentro del directorio target, se ha generado la librería (SBServicesRest-01.jar):
Crear fichero Dockerfile
- En el directorio raiz de tu proyecto crea un fichero llamado Dockerfile.
- Dentro el fichero incluiremos las siguientes líneas:
FROM openjdk:8-jdk-alpine
COPY "./target/SBServicesRest-01.jar" "app.jar"
EXPOSE 8080
ENTRYPOINT ["java","-jar","app.jar"]
FROM openjdk:8-jdk-alpine –> es la imagen que vamos a utilizar
COPY «./target/SBServicesRest-01.jar» «app.jar» –> la librería a usar y el nombre de la librería dentro del contenedor.
EXPOSE 8080 –> puerto que usaremos.
ENTRYPOINT [«java«,»-jar«,»app.jar«] –> parámetros que usaremos al ejecutar la aplicación.
Crear contenedor a partir de Dockerfile
- Abre una Windows PowerShell y sitúate en el directorio principal de tu proyecto e introduce:
D:\wsSpringBoot\SBServicesRest> docker build -t spring-boot-docker .
- Comprueba la imagen creada: Abre la aplicación de Windows Docker Desktop y observa que se ha añadido la nueva imagen:
- También puedes listar las imágenes por línea comandos con:
docker images
Ejecutar contenedor Docker
- Abre una Windows PowerShell y sitúate en el directorio principal de tu proyecto e introduce:
docker run –name MyContainerSB –publish 8080:8080 spring-boot-docker
- Observa que se inicia la aplicación:
- En la aplicación Docker Desktop tambien debe aparecer:
- Finalmente, prueba uno de los servicios en el navegador o en Postman: