Docker容器化spring boot應用
前置條件
容器化spring boot應用所需環境:
- jdk 1.8 +
- maven 3.0 +
我們的需求是:使用maven打包,將spring boot應用製作成docker映象並上傳到docker hub。在其他機器上,可以直接docker pull並執行容器。
建立spring boot應用
spring boot 包結構為:
└── src
└── main
└── java
└── me
└── ithakar
建立spring boot Application主類,src/main/java/me/ithakar/Application.java
package me.ithakar;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@SpringBootApplication
@RestController
public class Application {
@RequestMapping("/")
public String home() {
return "docker app running";
}
public static void main(String[] args) {
SpringApplication.run(Application.class, args);
}
}
pom.xml:
<?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>
<groupId>me.ithakar</groupId>
<artifactId>docker-app</artifactId>
<version>0.1.0</version>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>1.5.3.RELEASE</version>
</parent>
<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-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>
打包並啟動應用
mvn package && java -jar target/docker-app-0.1.0.jar
docker app running
則spring boot應用啟動成功
建立Dockerfile檔案
Dockerfile是一個文字檔案,類似shell指令碼,其內包含了一條條的指令。每一條指令的內容,就是描述對應的映象層應當如何構建。
Dockerfile位置:src/main/docker/Dockerfile
FROM frolvlad/alpine-oraclejdk8:slim
VOLUME /tmp
ADD docker-app-0.1.0.jar app.jar
RUN sh -c 'touch /app.jar'
ENV JAVA_OPTS=""
ENTRYPOINT [ "sh", "-c", "java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar /app.jar" ]
- FROM 命令指定基礎映象,以一個映象為基礎,在其上進行定製。在這裡我們的基礎映象是frolvlad/alpine-oraclejdk8:slim。
- VOLUME 定義匿名卷。對於可能需要操作資料庫類需要儲存動態資料的應用,其資料檔案應該儲存在主句的卷,而不是容器的儲存層。在這裡我們是將其掛載在了/tmp這個位置,從而保證了容器的無狀態化。
- ADD 命令是較高階的複製命令,將jar包複製到/app.jar
- ENTRYPOINT 容器執行後預設執行的命令
新增maven docker外掛
docker maven外掛是為了方便java開發者,由spotify公司開發的一款maven外掛。新增以下程式碼至pom.xml檔案中。
<properties>
<docker.image.prefix>ithaka</docker.image.prefix>
</properties>
<build>
<plugins>
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<version>0.4.11</version>
<configuration>
<imageName>${docker.image.prefix}/${project.artifactId}:${project.version}</imageName>
<dockerDirectory>src/main/docker</dockerDirectory>
<pushImage>true</pushImage>
<resources>
<resource>
<targetPath>/</targetPath>
<directory>${project.build.directory}</directory>
<include>${project.build.finalName}.jar</include>
</resource>
</resources>
</configuration>
</plugin>
</plugins>
</build>
注意,docker.image.prefix中的ithaka為我的docker hub 賬戶,使用時將其換成自己的
使用maven命令打包應用、構建docker映象並上傳映象到docker hub:
mvn package docker:build -DpushImage
此時我們將得到一個報錯:
[ERROR] Failed to execute goal com.spotify:docker-maven-plugin:0.4.11:build (default-cli) on project docker-app: Exception caught: denied: requested access to the resource is denied
這是因為我們在maven中push時,並沒有包含docker的使用者資訊,所以許可權校驗失敗。
解決方法為,在maven全域性setting.xml配置中,新增docker hub server資訊
<server>
<id>docker-hub</id>
<username>ithaka</username>
<password>密碼</password>
<configuration>
<email>郵箱</email>
</configuration>
</server>
在pom.xml中的docker-maven-plugi外掛中,指定server
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<configuration>
<serverId>docker-hub</serverId>
</configuration>
</plugin>
再繼續執行
mvn package docker:build -DpushImage
出現
The push refers to a repository [docker.io/ithaka/docker-app]
8c02854cd300: Pushed
a03c3b5dbe04: Pushed
8018d52798bb: Pushed
1e6468b956ae: Pushed
3fb66f713c9f: Pushed0.0.1: digest: sha256:63456345745755577c19103dcf4838894e34d45a68a1ec23b2f69d6f059 size: 1375
即為上傳docker hub成功。
啟動docker容器
在另外一臺機器上,執行命令
docker run -p 8080:8080 -t ithaka/docker-app
docker app running
docker應用啟動成功。