从零开始学习docker之在docker中运行springboot项目

一、docker环境配置

首先需要一个安装了docker的服务器(本地或者云服务器)，如果没有请看上文，传送门---https://www.cnblogs.com/wdfordream/p/12737389.html

我这里是直接在云服务器上搭建了docker

云环境：CentOS 7.6 64位

二、构建镜像

1、 用DockerFile构建镜像

通过DockerFile以及springboot.jar包构建镜像。jar包可以通过本地打jar包上传到服务器也可以在服务器上拉取代码通过maven打包。

这里我是直接在云服务器上拉取github上的代码，利用maven打包成jar包的。代码传送门---https://github.com/DreamsChaser/spring-boot-basic

具体步骤：

(1) 从github上拉取spring-boot项目

git clone git@github.com:DreamsChaser/spring-boot-basic.git

这个项目里写了一个简单的rest用于测试

(2) maven 打包

#进入项目根目录
cd spring-boot-basic
#maven 打包
mvn clean package

BUILD SUCCESS显示打包成功

(3)运行jar

#进入jar包所在目录
cd spring-boot-basic-web/target/
#运行jar包(& 表示将启动进程后台运行 如果不用& 可以运行后ctrl + z 暂停返回命令行后 通过bg 后台运行)
java -jar spring-boot-basic.jar &

打印日志 启动成功 端口8080

(4)测试jar

通过curl命令或者直接在浏览器访问调用rest接口

#curl调用
curl http://localhost:8080/spring-boot-basic/demo/test

直接在浏览器输入 ip:port+访问url 下面的ip是我云服务器的ip 端口就是启动的端口

到这里说明jar是没问题的 接下来通过docker创建镜像启动容器来运行jar

(5)创建Dockerfile文件

在项目根目录新建Dockerfile

#定制的镜像都是基于 FROM 的镜像(可以从docker hub上找)
FROM openjdk
 
#VOLUME ，VOLUME 指向了一个/tmp的目录，由于Spring Boot使用内置的Tomcat容器，Tomcat 默认使用/tmp作为工作目录
VOLUME /tmp
 
#拷贝并且重命名(jar必须在dockerFile所在文件夹或者子文件夹 否则会报错Forbidden path outside the build context)
ADD /spring-boot-basic-web/target/spring-boot-basic.jar spring-boot-basic.jar
 
#容器启动命令 也可以用CMD 但CMD会被docker run的指令覆盖
ENTRYPOINT ["java","-jar","/spring-boot-basic.jar"]

(6)创建镜像

#创建镜像 
#-t:镜像的名字及标签   -t name:tag或者 -t name   
#-f :指定要使用的Dockerfile路径 在Dockerfile所在目录不需要指定
#最后有个 .
docker build -t spring-boot-basic:1.0 .

出现Step 1/4等表示正在构建 需要从docker hub拉取openjdk镜像

(7)查看镜像

#查看所有镜像
docker image ls

可以看到刚刚创建的 spring-boot-basic:1.0 镜像 以及openjdk镜像

2、利用maven插件构建镜像

maven插件构建镜像有两种 一种是写好dockerFile后再maven中配置dockerFile路径，另一种是把dockerFile中相关配置按照一定属性配置在maven。

(1)写Dockerfile然后在pom中配置<dockerDirectory>

用这种方式的时候遇到了一个问题Error: Exception caught: xx/target does not exist 一开始我以为是路径配置问题 因为我用的是pom自带的一些属性比如${basdir} 后来全部替换之后发现依然找不到

但是 只要我先执行mvn package 生成target之后在执行mvn clean package docker:build之后就能生成镜像 但是会生成两个镜像 查看了一下输出日志后 我发现问题所在

我的spirng-boot项目配置了一个子module这个子module里是我的rest服务并且打包类型是jar ，parent pom打包类型是pom 每次都会打一个pom和一个jar 我的maven docker配置是在父pom中 所以在打外层pom时也会build镜像，而真正的jar包还没生成索引失败了，把配置移动到子module的pom中问题就解决了。

接下来讲一下 配置方式

在子module根目录写一份Dockerfile

FROM openjdk
VOLUME ./tmp
#和上面的ADD不同 是因为我Dockerfile是在子module下的
ADD ./target/spring-boot-basic.jar spring-boot-basic.jar
ENTRYPOINT ["java","-jar","/spring-boot-basic.jar"]

在子module spring-boot-basic-web 的pom.xml中配置

<build>
        <finalName>spring-boot-basic</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <!-- docker plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>1.0.0</version>
                <!-- docker config -->
                <configuration>
                    <!-- image name -->
                    <imageName>${project.build.finalName}</imageName>
                    <dockerDirectory>${project.basedir}</dockerDirectory>
                </configuration>
            </plugin>
        </plugins>
    </build>

在项目根目录中执行 mvn clean package docker:build

可以看到构建完成 可以通过docker image ls查看镜像

(2)不用Dockerfile

省略Dockerfile把Dockerfile中的相关配置 按照pom里的一些标签进行配置

在子module spring-boot-basic-web的pom中配置

<build>
        <finalName>spring-boot-basic</finalName>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
            <!-- docker plugin -->
            <plugin>
                <groupId>com.spotify</groupId>
                <artifactId>docker-maven-plugin</artifactId>
                <version>1.0.0</version>
                <!-- docker config -->
                <configuration>
                    <!-- image name -->
                    <imageName>${project.build.finalName}</imageName>
 
                    <!-- Dockerfile配置路径
                    <dockerDirectory>${project.basedir}</dockerDirectory>
                    -->
 
                    <!-- 非Dockerfile配置-->
                    <workdir>/tmp</workdir>
                    <baseImage>openjdk</baseImage>
                    <entryPoint>["java", "-jar", "/spring-boot-basic.jar"]</entryPoint>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}</directory>
                            <include>${project.build.finalName}.jar</include>
                        </resource>
                    </resources>
 
                </configuration>
            </plugin>
        </plugins>
    </build>

注意这里resource复制的时候复制到了/ 所以在entryPoint 写java启动命令时对应的jar要在/下

三、启动容器

1、启动容器

#启动容器
#参数1 --name 指定容器名
#参数2 -d  以后台方式执行 
#最后是 镜像name:tag/name
docker run --name test -d spring-boot-basic:1.0

2、查看容器

#查看所有容器(包括关闭的)
docker ps -a

显示刚刚运行中 Up

3、进入容器

#进入容器（以容器id或者name都可以进入）
#/bin/bash 进入后打开bash命令行
docker exec -it 2de6fd561c9a /bin/bash

进入之后可以命令行输入

4、测试jar是否正常

(1)通过容器ip和端口访问

进入容器命令行后 查看容器ip

找到ip是 172.18.0.2

离开容器 容器bash命令行输入 exit

通过容器ip和端口访问rest接口

#curl
curl http://172.18.0.2:8080/spring-boot-basic/demo/test

请求成功，返回hello world。

这种方式只能在部署docker的服务器上才能请求成功，在其他机器无法访问，这时候需要做端口映射。

(2)通过端口映射访问

关闭并删除之前启动的容器

#关闭容器(id name都可以)
docker stop 2de6fd561c9a
#删除容器(id name都可以)
docker rm 2de6fd561c9a

docker ps -a后发现容器已经删除

以端口映射方式启动容器

#-p设置端口 本地端口:容器端口
docker run --name test -d -p 7001:8080 spring-boot-basic:1.0

启动完成之后 通过docker ps -a查看启动的容器 端口做了映射处理 可以通过本机(云服务器)端口访问到 容器内部端口

通过curl测试

通过本机7001端口请求成功 返回hello world

同时在其他服务器通过访问docker所在服务器的ip 和映射端口可以访问容器内部的服务

122.51.103.239是我云服务器的公网ip，请求成功，返回hello world

四、异常汇总

[ERROR] No plugin found for prefix 'docker' in the current project
and in the plugin groups [org.sonatype.plugins, org.apache.maven.plugins, org.codehaus.mojo] available from the repositories

解决：在maven配置文件 setting.xml中配置

<pluginGroups>

　　<pluginGroup>com.spotify</pluginGroup>

</pluginGroups>

[ERROR] Failed to execute goal com.spotify:docker-maven-plugin:1.0.0:build (default-cli) on project spring-boot-basic: Exception caught: 
java.util.concurrent.ExecutionException: com.spotify.docker.client.shaded.javax.ws.rs.ProcessingException: 
org.apache.http.conn.HttpHostConnectException: Connect to localhost:2375 [localhost/127.0.0.1, localhost/0:0:0:0:0:0:0:1] 
failed: Connection refused: connect -> [Help 1]

这个异常是我在window10构建镜像的时候出现的 需要修改docker配置

这个地方选中 然后重启就可以了

五、常用命令汇总

1、镜像相关

#查看所有镜像
docker image ls
#删除镜像 id或者name删除
docker image rm 'id'/'name'
#构建镜像 tag可以不填 默认latest
docker build -t 'name':'tag' .

2、容器相关

#查看所有容器
docker ps -a
#关闭容器
docker stop 'id'/'name'
#重启容器
docker restart 'id'/'name'
#进入容器 并打开bash命令行
docker exec -it 'id' /bin/bash
#启动容器 -d后台运行 -p端口映射
docker run --name 'name' -d -p 'port1':'port2' 'imageName':'imageTag'