Docker容器化spring boot Docker容器化spring boot应用详解
ithaka 人气:0前置条件
容器化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
访问 http://localhost:8080/ ,获得响应:
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
访问http://ip:8080/ ,获得响应:
docker app running
docker应用启动成功
参考文档:
加载全部内容