SpringBoot项目在远程docker上发布镜像

一、环境

1. SpringBoot项目，在Windows 10机器上，通过eclipse创建的项目。其中SpringBoot项目源码地址：https://gitee.com/hsh2015/learningDemo/tree/master/docker-test
2. Docker环境，在VM虚拟机中，操作系统：CentOS7.0 ，Docker版本：v19.0。其中在CentOS7.0下安装Docker的教程，请参考《CentOS7.0环境安装docker》

二、配置Docker远程连接

如果经过第二步验证，发现不能够进行远程连接，就需要对服务端的docker进行配置。配置非常简单，首先通过如下命令，打开docker启动参数配置：

vim /usr/lib/systemd/system/docker.service

在ExecStart配置项后面添加如下参数即可。

-H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock

配置后的效果如下所示：

重新启动docker

systemctl daemon-reload   守护进程重启
systemctl restart docker  重启docker服务  

三、验证Docker是否可以远程连接

配置好远程连接后，开始验证Docker是否成功，可以有多种方法进行验证，这里介绍两种常见的：

第一种方式：在服务端验证

在命令行窗口，通过下来命令验证，如果出现图一说明，没有开启远程连接，出现图二说明开启了远程连接。

curl 127.0.0.1:2375/info

图一：

图二：

第二种方式：在客户端验证

在客户端，通过浏览器，输入http://192.168.1.10:2375/images/json，如果可以请求到数据，说明开启了远程，如果无法访问，说明没有开启远程连接。

注意：其中ip地址是docker所部署服务器的地址，端口是默认（如果没有修改）。注意CentOS7系统的防火墙，保证端口可以访问或者可以关闭防火墙（生成环境不推荐）。

如下图所示：

四、SpringBoot项目中需要的配置

在SpringBoot项目中需要两个地方进行配置，一个是POM.xml文件，一个是Dockerfile文件。

1、pom.xml文件配置

首先是docker-maven-plugin插件的引入。配置内容，其中dockerHost表示远程docker对应的ip地址和端口号，imageName对应的是生成镜像的规则，需要注意docker镜像的命名规则。

<plugin>
    <groupId>com.spotify</groupId>
    <artifactId>docker-maven-plugin</artifactId>
    <version>1.0.0</version>
    <configuration>
    	<dockerHost>http://192.168.1.8:2375</dockerHost>
        <imageName>${project.artifactId}</imageName>
        <dockerDirectory>src/main/docker</dockerDirectory>
        <resources>
            <resource>
                <targetPath>/</targetPath>
                <directory>${project.build.directory}</directory>
                <include>${project.build.finalName}.jar</include>
            </resource>
        </resources>
    </configuration>
</plugin>

2、Dockerfile文件

其中，FROM：指定基础镜像，必须为第一个命令；VOLUME：用于指定持久化目录；ADD：将本地文件添加到容器中；RUN：构建镜像时执行的命令；ENV：设置环境变量；ENTRYPOINT：配置容器，使其可执行化；具体的可以参考《Dockerfile文件详解》

FROM openjdk:8-jdk-alpine
VOLUME /tmp
ADD docker-test-0.0.1-SNAPSHOT.jar app.jar
RUN sh -c 'touch /app.jar'
ENV JAVA_OPTS=""
ENTRYPOINT ["java","-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

五、通过maven命令构建镜像

通过如下命令可以进行docker镜像的构建

mvn package docker:build

在Eclipse的开发环境下，可以选择需要构建镜像的项目docker-test,然后Run As => Maven build…，然后添加mvn命令，最后点击运行即可。


当出现如下字样的时候，说明添加成功。

这个时候，在远程的docker通过docker images命令查看时，可以发现docker-test镜像已经存在了，如下图所示：

注：在构建过程如果出现如下错误,说明项目的命名有问题了，具体请参考《User could be warned if an illegal image name is specified》。

[ERROR] Failed to execute goal com.spotify:docker-maven-plugin:1.0.0:build (default-cli) on project DockerTest: Exception caught: java.util.concurrent.ExecutionException: com.spotify.docker.client.shaded.javax.ws.rs.ProcessingException: org.apache.http.client.ClientProtocolException: Cannot retry request with a non-repeatable request entity: Connection reset by peer: socket write error -> [Help 1]

六、启动容器，进行验证

通过下面命令，根据第四步构建的容器，启动一个容器。

docker run -p 8080:8080 docker-test:latest

然后地址输入 http://192.168.1.8:8080/hello 进行访问，出现下图所示，说明成功了。