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

时间:2020-04-25 Leon_W 人气:2

一、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-basichttps://img.qb5200.com/download-x/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}<https://img.qb5200.com/download-x/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}<https://img.qb5200.com/download-x/dockerDirectory>
                    -->

                    <!-- 非Dockerfile配置-->
                    <workdir>/tmp</workdir>
                    <baseImage>openjdk</baseImage>
                    <entryPoint>["java", "-jar", "/spring-boot-basic.jar"]</entryPoint>
                    <resources>
                        <resource>
                            <targetPath>/</targetPath>
                            <directory>${project.build.directory}<https://img.qb5200.com/download-x/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-basichttps://img.qb5200.com/download-x/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中配置

　　<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'

加载全部内容