Docker容器化spring boot应用详解
前置条件
容器化spring boot应用所需环境：
我们的需求是：使用maven打包，将spring boot应用制作成docker镜像并上传到docker hub。在其他机器上，可以直接docker pull并运行容器。
创建spring boot应用
spring boot 包结构为：
|
1
2
3
4
5 |
└── src
└── main
└── java
└── me
└── ithakar |
创建spring boot Application主类，src/main/java/me/ithakar/Application.java
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21 |
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：
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41 |
<?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> |
打包并启动应用
|
1 |
mvn package && java -jar target/docker-app-0.1.0.jar |
访问 http://localhost:8080/ ,获得响应：
|
1 |
docker app running |
则spring boot应用启动成功
创建Dockerfile文件
Dockerfile是一个文本文件，类似shell脚本，其内包含了一条条的指令。每一条指令的内容，就是描述对应的镜像层应当如何构建。
Dockerfile位置：src/main/docker/Dockerfile
|
1
2
3
4
5
6 |
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文件中。
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24 |
<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：
|
1 |
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信息
|
1
2
3
4
5
6
7
8 |
<server>
<id>docker-hub</id>
<username>ithaka</username>
<password>密码</password>
<configuration>
<email>邮箱</email>
</configuration>
</server> |
在pom.xml中的docker-maven-plugi插件中，指定server
|
1
2
3
4
5
6
7 |
<plugin>
<groupId>com.spotify</groupId>
<artifactId>docker-maven-plugin</artifactId>
<configuration>
<serverId>docker-hub</serverId>
</configuration>
</plugin> |
再继续执行
|
1 |
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容器
在另外一台机器上，执行命令
|
1 |
docker run -p 8080:8080 -t ithaka/docker-app |
访问http://ip:8080/ ，获得响应：
联系我们
在线咨询：
Q Q：1524578900
