Docker系列（七）Docker通过IDEA部署SpringBoot应用

曾经终败给现在 2022-10-27 13:45 354阅读 0赞

本篇文章讲解一个Docker实战，在IDEA工具中，使用Docker插件来部署SpringBoot项目。

适用场景：之前公司服务器大多是自己的，但是有那么两三个项目，是客户那边提供的云服务器，每次部署项目时，如果通过Jar包形式，多少有些麻烦，所以直接将服务器的2375安全组开放在公司本地或者固定IP，然后在公司通过Docker插件的形式可以直接手动发布项目，省去了更麻烦的操作了。

# 一、开启Docker服务器的远程访问 #

## 1.1 开启2375远程访问 ##

默认的dokcer是不支持远程访问的，需要加点配置，开启Docker的远程访问

# 首先查看docker配置文件所在位置
    systemctl status docker
    
    # 会输出如下内容：
    ● docker.service - Docker Application Container Engine
       Loaded: loaded (/etc/systemd/system/docker.service; enabled; vendor preset: disabled)
       Active: active (running) since Thu 2020-12-17 14:22:23 CST; 18min ago
         Docs: http://docs.docker.com
     Main PID: 25113 (dockerd)

确定docker配置文件位置在：/etc/systemd/system/docker.service

然后编辑修改docker配置文件：

vi /lib/systemd/system/docker.service

找到包含ExecStart的这行，添加如下内容：

ExecStart=/usr/bin/dockerd -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock \

其中，2375端口为docker远程服务端口，包含了docker可视化工具portainer，以及远程上传镜像的功能。

## 1.2 添加harbor镜像配置 ##

编辑docker的配置文件：

vi /etc/docker/daemon.json
    # 添加harbor镜像地址
    { 
     "insecure-registries": ["192.168.0.20:81"]
    }

## 1.3 重启docker服务 ##

# 后台配置重新加载
    systemctl daemon-reload 
    # 重启docker服务
    systemctl restart docker.service
    # 此处可能会出现docker无法启动情况，可能是由于docker.service配置文件修改错误，重新修改一次然后重新执行上述命令即可
    
    #查看配置的端口号（2375）是否开启（非必要）
    netstat -nlpt

# 二、通过IDEA操作Docker #

## 2.1 下载docker插件 ##

使用idea的docker插件连接docker，idea默认已经下载过docker插件了，如果没有的话，需要在idea下载docker插件  
![image-20210204135254513][]

## 2.2 配置远程docker ##

点击idea的设置选项（file --> setting -> docker）,新建连接  
![image-20210204135422658][]  
![image-20210204135443107][]

连接成功之后就可以使用服务器(虚拟机)上的docker了

![image-20210204135509675][]

## 2.3 拉取镜像 ##

idea可以通过可视化的方式拉取镜像，不用自己去敲命令

![image-20210204135536743][]

![image-20210204135605027][]

![image-20210204135626852][]

有时候会出现拉取的时间超时的情况，可以配置一下国内的镜像获取阿里云的加速器  
![image-20210204135650634][]

## 2.4 创建容器并运行 ##

创建并且运行docker容器  
![image-20210204135716371][]

![image-20210204135735826][]  
创建成功之后可以看到新创建的容器，也可以在服务器(虚拟机)上用docker命令查看

![image-20210204135803299][]

重启容器、停止容器和删除容器等操作

![image-20210204135826639][]

# 三、IDEA-Maven打包镜像 #

将构建好的镜像通过docker-maven-plugin插件上传到harbor私服

## 3.1 修改maven的配置文件settings.xml ##

在maven的配置文件中，添加harbor私服的用户名及密码：

<servers>
      <server>
        <id>dockerharbor</id>
        <username>harbor</username>
        <password>123456</password>
        <configuration>
          <email>123456@aliyun.com</email>
        </configuration>
      </server>
    </servers>

## 3.2 修改SpringBoot项目中的pom.xml ##

添加属性配置，属性配置，在后面的插件配置里有引用这个：

*  docker.repostory 是docker私服地址，harbor配置完默认端口就是80，可以不带端口号。但是我将之改成81了
 *  docker.registry.name 即是在harbor中配置的镜像仓库名，必须一致！这里我配的是test，因为harbor中配置的镜像仓库名也是test。

![image-20210204135928662][]

## 3.3 docker-maven-plugin插件配置 ##

*  serverId 指定之前在maven的settings.xml中配置的server节点，这样maven会去找其中配置的用户名密码和邮箱
 *  registryUrl 指定上面配置的properties属性，即是harbor私服的访问url，注意我设置的使用81端口，默认是80端口
 *  imageName 指定上传harbor私服的镜像名，必须和harbor上的url、镜像仓库名保持一致。其中的docker.registry.name就是上面配置的properties属性

### 方式一： ###

<build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                </plugin>
                <plugin>
                    <groupId>com.spotify</groupId>
                    <artifactId>docker-maven-plugin</artifactId>
                    <version>1.0.0</version>
                    <executions>
                        <execution>
                            <id>build-image</id>
                            
                            <phase>package</phase>
                            <goals>
                                <goal>build</goal>
                            </goals>
                        </execution>
                    </executions>
                    <configuration>
                        <serverId>harbor</serverId>
                        <registryUrl>http://${docker.repostory}</registryUrl>
                        
                        <imageName>${docker.repostory}/${docker.registry.name}/${project.artifactId}:${project.version}
                        </imageName>
                        
                        
                        
                        <baseImage>jdk:1.8</baseImage>
                        
                        
                        
                        
                        <workdir>/opt</workdir>
                        
                        <entryPoint>["java", "-jar","-Xms256m","-Xmx512m","/${project.build.finalName}.jar"]
                        </entryPoint>
                        
                        <dockerHost>http://192.168.0.20:2375</dockerHost>
                        
                        <resources>
                            <resource>
                                <targetPath>/</targetPath>
                                
                                <directory>${project.build.directory}</directory>
                                
                                <include>${project.build.finalName}.jar</include>
                            </resource>
                        </resources>
                    </configuration>
                </plugin>
            </plugins>
        </build>

接下来只要先点击clean清除之前的所有打包的文件，然后再点击package打包文件即可完成镜像的构建，真正的一键部署

![image-20210204140050770][]

![image-20210204140103339][]

到此镜像构建成功，接下来只要创建容器跑起来即可

![image-20210204140115636][]

![image-20210204140126588][]  
通过ip访问

此种方式，直接通过Maven的package命令，即可实现镜像的制作，但是要推送镜像到harbor私服，还需执行docker:push，即：

点击push，将镜像推送到harbor私服中

![image-20210204140138789][]

### 方式二： ###

<plugin>
      <groupId>com.spotify</groupId>
      <artifactId>docker-maven-plugin</artifactId>
      <version>1.0.0</version>
      <configuration>
    	  <serverId>my-hub</serverId>
    	  <registryUrl>http://${docker.repostory}</registryUrl>
    	  
    	  <dockerHost>http://192.168.10.11:2375</dockerHost>
    	  
    	  <imageName>${docker.repostory}/${docker.registry.name}/${project.artifactId}:${project.version}</imageName>
    	  
    	  <dockerDirectory>${basedir}/</dockerDirectory>
    	  
    	  <resources>
    		  <resource>
    		  <targetPath>/ROOT</targetPath>
    		  
    		  <directory>${project.build.directory}</directory>
    		  
    		  <include>${pack-name}</include>
    		  </resource>
    	  </resources>
      </configuration>
    </plugin>

那么Dockerfile文件中的jar包名相应需要修改：

FROM java:8
    WORKDIR /ROOT
    ADD /ROOT/demo1-2.jar /ROOT/
    ENTRYPOINT ["java", "-jar", "demo1-2.jar"]

点击pakage打包，target 上生成了springboot工程的jar包

完了之后，点击docker bulid 构建工程镜像  
![image-20210204140154999][]

然后点击push，将镜像推送到harbor私服中

![image-20210204140210268][]

## 3.4 docker-maven-plugin操作容器 ##

> 3.4 部分内容原文作者及链接：掘金：MacroZheng：https://juejin.im/post/6868060821927723021

*  `docker-maven-plugin`不仅可以操作镜像，还可以操作容器，比如我们以前需要使用如下Docker命令来运行容器；

docker run -p 8080:8080 --name mall-tiny-fabric \
    --link mysql:db \
    -v /etc/localtime:/etc/localtime \
    -v /mydata/app/mall-tiny-fabric/logs:/var/logs \
    -d 192.168.3.101:5000/mall-tiny/mall-tiny-fabric:0.0.1-SNAPSHOT

*  现在我们只需在插件中配置即可，在`<image>`节点下添加`<run>`节点可以定义容器启动的行为：

<run>
        
        <containerNamePattern>${project.artifactId}</containerNamePattern>
        
        <ports>
            <port>8080:8080</port>
        </ports>
        
        <links>
            <link>mysql:db</link>
        </links>
        
        <volumes>
            <bind>
                <volume>/etc/localtime:/etc/localtime</volume>
                <volume>/mydata/app/${project.artifactId}/logs:/var/logs</volume>
            </bind>
        </volumes>
    </run>

*  之后直接使用`docker:start`命令即可启动了；

mvn docker:start
    
    [root@linux-local mydata]# docker ps
    CONTAINER ID        IMAGE                                                         COMMAND                  CREATED             STATUS              PORTS                                            NAMES
    95ce77c0394b        192.168.3.101:5000/mall-tiny/mall-tiny-fabric:0.0.1-SNAPSHOT   "java -jar /mall-tin…"   32 seconds ago      Up 31 seconds       0.0.0.0:8080->8080/tcp                           mall-tiny-fabric

*  停止容器使用`docker:stop`命令即可；

mvn docker:stop

*  删除容器使用`docker:remove`命令，是不是很方便！

mvn docker:remove

# 四、Java API上传镜像到Harbor仓库 #

第4部分原文作者及链接：Lesise：[docker—java上传镜像到Harbor仓库][docker_java_Harbor]

> 这个是当时在学习这部分内容时，想到也会后来这种场景可能会有利用的机会，所以记录下来了。待以后思考具体的场景使用。

SpringBoot项目上传镜像到Harbor

## 4.1 pom.xml添加依赖 ##

<dependency>
        <groupId>com.github.docker-java</groupId>
        <artifactId>docker-java</artifactId>
        <version>3.1.5</version>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-jersey</artifactId>
    </dependency>

## 4.2 yml配置文件 ##

#docker访问路径
    docker:
      url: tcp://ip:2375
    #私服仓库配置
    harbor:
      login_address: Harbor登录地址
      username: xx
      password: xxx

## 4.3 Java工具类 ##

import com.github.dockerjava.api.DockerClient;
    import com.github.dockerjava.api.model.AuthConfig;
    import com.github.dockerjava.api.model.Image;
    import com.github.dockerjava.api.model.PushResponseItem;
    import com.github.dockerjava.core.DockerClientBuilder;
    import com.github.dockerjava.core.command.PushImageResultCallback;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.stereotype.Component;
    
    import java.io.File;
    import java.io.FileInputStream;
    import java.io.InputStream;
    import java.util.List;
    
    /** * docker工具类 */
    @Component
    public class DockerUtils { 
         
    
        //docker服务器
        @Value("${docker.url}")
        private  String DOCKER_URL ;
    
        //Harbor登录用户名
        @Value("${harbor.username}")
        private   String HARBOR_USERNAME  ;
    
        //Harbor登录密码
        @Value("${harbor.password}")
        private   String HARBOR_PASSWORD  ;
    
        //Harbor的登录地址
        @Value("${harbor.login_address}")
        private   String HARBOR_LOGIN_ADDRESS ;
    
    
        /** * 获取docker链接 * * @return */
        public  DockerClient getDockerClient() { 
            DockerClient dockerClient = DockerClientBuilder.getInstance(DOCKER_URL).build();
            return dockerClient;
        }
    
    
        /** * 参考之前文章《docker---镜像的加载》，镜像如何保存到本地 * 上传镜像 * @param file 镜像文件 * @param imageName * @throws Exception */
        public  void uploadImage(File file, String imageName) throws Exception { 
         
            DockerClient dockerClient = getDockerClient();
            InputStream inputStream = new FileInputStream(file);
            //Harbor登录信息
            AuthConfig autoConfig = new AuthConfig().withRegistryAddress(HARBOR_LOGIN_ADDRESS).withUsername(HARBOR_USERNAME).withPassword(HARBOR_PASSWORD);
            //加载镜像
            dockerClient.loadImageCmd(inputStream).exec();
            //获取加载镜像的名称
            String uploadImageName = "";
            String imageFile = file.getName().substring(0, file.getName().lastIndexOf("."));
            String imageId = imageFile.substring(imageFile.lastIndexOf("_") + 1);
            List<Image> list = dockerClient.listImagesCmd().exec();
            for(Image image : list){ 
         
                if(image.getId().contains(imageId)){ 
         
                    uploadImageName= image.getRepoTags()[0] ;
                }
            }
            //镜像打tag
            dockerClient.tagImageCmd(uploadImageName, imageName, imageName.split(":")[1]).exec();
            //push至镜像仓库
            PushImageResultCallback pushImageResultCallback = new PushImageResultCallback() { 
         
                @Override
                public void onNext(PushResponseItem item) { 
                    super.onNext(item);
                }
                @Override
                public void onComplete() { 
                    super.onComplete();
                }
            };
            dockerClient.pushImageCmd(imageName).withAuthConfig(autoConfig).exec(pushImageResultCallback).awaitSuccess();
            //push成功后，删除本地加载的镜像
            dockerClient.removeImageCmd(imageName).exec();
            dockerClient.removeImageCmd(uploadImageName).exec();
            //关闭文件流
            if (inputStream != null) { 
                inputStream.close();
            }
        }
    }

## 4.4 API测试 ##

@RestController
    public class HarborController { 
         
    
        @Autowired
        private DockerUtils dockerUtils;
        
        @PostMapping("/uploadImages")
        public ResultObject uploadImages(String projectName, String imageName, String tag, String filePath) throws Exception { 
            String imageNames = HOST_HOST + "/" + projectName + "/" + imageName + ":" + tag;
            dockerUtils.uploadImage(new File(filePath), imageNames);
            return ResultObject.ok();
        }
    }

学习这部分内容时，很多东西是当时没有考虑到或做过的，所以一直在网上寻找各种资料文章，再次感谢下面这些人的优秀博文，最后使我成功完成了公司部分项目的发布改造方式。

*  [最强菜鸟][Link 1]：[菜鸟的IDEA使用Docker插件][IDEA_Docker]
 *  [【Docker】Maven打包SpringBoot项目成Docker镜像并上传到Harbor仓库（Eclipse、STS、IDEA、Maven通用）][Docker_Maven_SpringBoot_Docker_Harbor_Eclipse_STS_IDEA_Maven]
 *  [使用Dockerfile Maven插件][Dockerfile Maven]
 *  [Idea远程一键部署springboot到Docker][Idea_springboot_Docker]
 *  [Docker教程(九)部署Spring Boot项目][Docker_Spring Boot]
 *  [maven 插件docker-maven-plugin之推送镜像到harbor私有仓库（二）][maven _docker-maven-plugin_harbor]
 *  [docker–私服搭建和推送于Springboot项目打成镜像][docker_Springboot]

# Docker思维导图总结 #

思维导图下载链接：  
[Docker思维导图下载][Docker]

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FuMTA5MDIzOTc4Mg_size_16_color_FFFFFF_t_70_pic_center]

[image-20210204135254513]: /images/20221024/3c6f645b92d44360aaf886c386f48787.png
[image-20210204135422658]: /images/20221024/5c04185649a743328c67e577e2575736.png
[image-20210204135443107]: /images/20221024/ea2e7fcaaf4e4bd3933b11f76d0c2da5.png
[image-20210204135509675]: /images/20221024/ccab2d12cecd4fd8992f8a24552f8afd.png
[image-20210204135536743]: /images/20221024/a06d584edc3647049ba691426b4e7235.png
[image-20210204135605027]: /images/20221024/54a6064c75e64dc389c883d3926e5fec.png
[image-20210204135626852]: /images/20221024/693c1f759b3d46d4bff815092ce1f9fe.png
[image-20210204135650634]: /images/20221024/98bfabc855764afabc0ce27a55851973.png
[image-20210204135716371]: /images/20221024/a979906db467475cb71bb08fc9d4d130.png
[image-20210204135735826]: /images/20221024/9db7f13baa5543738bcbdcfe29aa3c6f.png
[image-20210204135803299]: /images/20221024/b21f53d420474de0a521ce490d3db94c.png
[image-20210204135826639]: /images/20221024/ff98e3d56e5f49e399d3f7e9ef4f013a.png
[image-20210204135928662]: /images/20221024/b4c54b9a6d424268b0c29398029a3e3e.png
[image-20210204140050770]: /images/20221024/6bafed7f64ce43daaa56ade47dc0aac4.png
[image-20210204140103339]: /images/20221024/802ee49cdf764005a7a6e1591f35ebba.png
[image-20210204140115636]: /images/20221024/6b8c32d9438e4596a55f9081ed4df40e.png
[image-20210204140126588]: /images/20221024/1f6a6732d21b46fabf9ec542a0569d9d.png
[image-20210204140138789]: /images/20221024/4b5421cb4e2741f9b0a9caf922918a6e.png
[image-20210204140154999]: /images/20221024/0bb741192a0545df89ecf0c09ba4e4ac.png
[image-20210204140210268]: /images/20221024/1c3c7f368bf541e48ca1f87af8b07316.png
[docker_java_Harbor]: https://www.it610.com/article/1304427940234170368.htm
[Link 1]: https://blog.csdn.net/qq_40298902
[IDEA_Docker]: https://blog.csdn.net/qq_40298902/article/details/106543208
[Docker_Maven_SpringBoot_Docker_Harbor_Eclipse_STS_IDEA_Maven]: https://www.cnblogs.com/binghe001/p/12810675.html
[Dockerfile Maven]: https://www.cnblogs.com/zyon/p/11266952.html
[Idea_springboot_Docker]: https://juejin.cn/post/6844903865192562696
[Docker_Spring Boot]: https://cloud.tencent.com/developer/article/1667567
[maven _docker-maven-plugin_harbor]: https://www.jianshu.com/p/2481d9843e86
[docker_Springboot]: https://blog.csdn.net/weixin_43549578/article/details/87864614
[Docker]: https://gitee.com/AiShiYuShiJiePingXing/lovebetterworld/tree/master/Docker
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L0FuMTA5MDIzOTc4Mg_size_16_color_FFFFFF_t_70_pic_center]: /images/20221024/26e03d65fb4e47639b95de983fea669a.png