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
访问 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插件
是为了方便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应用启动成功
参考文档:
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持。
上一篇: Docker多阶段镜像构建的实现