一.背景
公司主机管理小组的同事期望我们开发的maven项目能够在1Panel管理的docker容器部署。上一篇写了先开放1Panel中docker镜像构建能力maven项目容器化运行之1-基于1Panel软件将docker镜像构建能力分享给局域网-CSDN博客。这一篇就是演示maven工程的镜像构建、容器运行、运行验证。
开发工具用的eclipse。
二.创建简单的maven工程
1.新建maven工程
2.添加pom依赖
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.scantt</groupId><artifactId>hello-docker</artifactId><version>0.0.1-SNAPSHOT</version><properties><!-- 为我在dependencyManagement约定springboot版本设置参数 --><version.springboot>2.7.0</version.springboot><!-- 这里指定了jdk编译的版本,不需要再去maven complie插件去设置了 --><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target></properties><!-- 用dependencyManagement的方式引入springboot的版本及其关联依赖 --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${version.springboot}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><!-- 依赖了spring-boot-starter-web组件,这里就不需要再指定版本了 --><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies>
</project>
3.创建运行入口文件
HelloDockerApplication.java
package com.scantt.docker;import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;@SpringBootApplication
public class HelloDockerApplication {public static void main(String[] args) {SpringApplication.run(HelloDockerApplication.class, args);}
}
4.创建简单的控制层响应文件
HelloController.java
package com.scantt.docker.controller;import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
public class HelloController {@GetMapping("/hello")public String hello(String name) {return "hello!" + name;}}
5.运行maven工程
HelloDockerApplication.java
在HelloDockerApplication.java中右键点击“Run As”=>“Java Application”。
控制台输出如下:
. ____ _ __ _ _/\\ / ___'_ __ _ _(_)_ __ __ _ \ \ \ \
( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \\\/ ___)| |_)| | | | | || (_| | ) ) ) )' |____| .__|_| |_|_| |_\__, | / / / /=========|_|==============|___/=/_/_/_/:: Spring Boot :: (v2.7.0)2024-07-15 18:45:27.306 INFO 9640 --- [ main] c.scantt.docker.HelloDockerApplication : Starting HelloDockerApplication using Java 1.8.0_341 on zhaoshiping with PID 9640 (D:\zsp\tools\eclipse_workspaces\base_workspace\hello-docker\target\classes started by Dell in D:\zsp\tools\eclipse_workspaces\base_workspace\hello-docker)
2024-07-15 18:45:27.306 INFO 9640 --- [ main] c.scantt.docker.HelloDockerApplication : No active profile set, falling back to 1 default profile: "default"
2024-07-15 18:45:27.944 INFO 9640 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat initialized with port(s): 8080 (http)
2024-07-15 18:45:27.944 INFO 9640 --- [ main] o.apache.catalina.core.StandardService : Starting service [Tomcat]
2024-07-15 18:45:27.944 INFO 9640 --- [ main] org.apache.catalina.core.StandardEngine : Starting Servlet engine: [Apache Tomcat/9.0.63]
2024-07-15 18:45:28.037 INFO 9640 --- [ main] o.a.c.c.C.[Tomcat].[localhost].[/] : Initializing Spring embedded WebApplicationContext
2024-07-15 18:45:28.037 INFO 9640 --- [ main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 693 ms
2024-07-15 18:45:28.238 INFO 9640 --- [ main] o.s.b.w.embedded.tomcat.TomcatWebServer : Tomcat started on port(s): 8080 (http) with context path ''
2024-07-15 18:45:28.246 INFO 9640 --- [ main] c.scantt.docker.HelloDockerApplication : Started HelloDockerApplication in 1.143 seconds (JVM running for 1.401)
可见默认端口是8080。
6.浏览器访问
http://127.0.0.1:8080/hello?name=potato
结果如下:
三.maven工程docker构建对接改造
1.为maven工程添加docker插件
增加了2处,一是properties里面增加了docker插件版本,二是增加了build这一块。整体如下:
<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 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.scantt</groupId><artifactId>hello-docker</artifactId><version>0.0.1-SNAPSHOT</version><properties><!-- 为我在dependencyManagement约定springboot版本设置参数 --><version.springboot>2.7.0</version.springboot><!-- 这里指定了jdk编译的版本,不需要再去maven complie插件去设置了 --><maven.compiler.source>1.8</maven.compiler.source><maven.compiler.target>1.8</maven.compiler.target><!-- docker插件版本 --><version.dockerPlugin>1.4.13</version.dockerPlugin></properties><!-- 用dependencyManagement的方式引入springboot的版本及其关联依赖 --><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${version.springboot}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement><!-- 依赖了spring-boot-starter-web组件,这里就不需要再指定版本了 --><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies><build><finalName>${project.artifactId}</finalName><plugins><plugin><groupId>org.springframework.boot</groupId><artifactId>spring-boot-maven-plugin</artifactId><version>2.6.6</version><executions><execution><goals><goal>repackage</goal></goals></execution></executions></plugin><plugin><groupId>com.spotify</groupId><artifactId>dockerfile-maven-plugin</artifactId><version>${version.dockerPlugin}</version><executions><execution><id>default</id><goals><goal>build</goal><goal>push</goal></goals></execution></executions><configuration><repository>${groupId}/${project.artifactId}</repository><tag>${project.version}</tag><buildArgs><JAR_FILE>${project.build.finalName}</JAR_FILE></buildArgs><dockerfile>Dockerfile</dockerfile></configuration></plugin></plugins></build>
</project>
2.编写Dockerfile文件
新建文件Dockerfile,放到hello-docker下面(必须放到工程根目录)。内容如下:
# 基础镜像
FROM docker.io/majiajue/jdk1.8# 环境变量配置
ENV ENV LC_ALL zh_CN.UTF-8# 主目录
ENV BASE_PATH=/usr/local/app/# 创建一个存放项目文件的目录
RUN mkdir -p ${BASE_PATH}# 复制编译打包号的jar包到镜像内/usr/local/app/目录下
# 基于当前项目根目录去复制文件:可以参照deploy.sh 关于docker build说明
COPY target/hello-docker.jar ${BASE_PATH}/hello-docker.jar# 启动镜像运行的命令
ENTRYPOINT java -Dfile.encoding=UTF8 -Dsun.jnu.encoding=UTF8 -jar ${BASE_PATH}/hello-docker.jar
3.增加系统环境变量DOCKER_HOST
我这里上篇文章docker的ip和端口是tcp://10.1.230.94:2375
4.build试试
在工程点击右键选择“Run As”=》“Maven install”
运行结果会发现其中有类似镜像构建过程的输出日志,部分如下:
[INFO] Image will be built as com.scantt/hello-docker:0.0.1-SNAPSHOT
[INFO]
[INFO] Step 1/6 : FROM docker.io/majiajue/jdk1.8
[INFO]
[INFO] Pulling from majiajue/jdk1.8
[INFO] Digest: sha256:fc684fe12c95aac86ef506f5a2bc2ec8fa411cdf7f34165f51a0275076dedcb4
[INFO] Status: Image is up to date for majiajue/jdk1.8:latest
[INFO] ---> 2be3cc30c33f
[INFO] Step 2/6 : ENV ENV LC_ALL zh_CN.UTF-8
[INFO]
[INFO] ---> Using cache
[INFO] ---> 30161b4581a1
[INFO] Step 3/6 : ENV BASE_PATH=/usr/local/app/
[INFO]
[INFO] ---> Using cache
[INFO] ---> be747d0679df
[INFO] Step 4/6 : RUN mkdir -p ${BASE_PATH}
[INFO]
[INFO] ---> Using cache
[INFO] ---> 7b513e464747
[INFO] Step 5/6 : COPY target/hello-docker.jar ${BASE_PATH}/hello-docker.jar
[INFO]
[INFO] ---> ac30abcf81e8
[INFO] Step 6/6 : ENTRYPOINT java -Dfile.encoding=UTF8 -Dsun.jnu.encoding=UTF8 -jar ${BASE_PATH}/hello-docker.jar
[INFO]
[INFO] ---> Running in e208149d02d6
[INFO] ---> Removed intermediate container e208149d02d6
[INFO] ---> f02da726ef9a
[INFO] [Warning] One or more build-args [JAR_FILE] were not consumed
[INFO] Successfully built f02da726ef9a
[INFO] Successfully tagged com.scantt/hello-docker:0.0.1-SNAPSHOT
5.1Panel中去看看镜像
点击“容器”,在右边界面选择“镜像”就可以看到刚刚构建的镜像文件了。
6.1Panel中用镜像创建容器
点击左边“容器”,右边还是选择“容器”,点击“创建容器”按钮
在容器创建界面,填写如下:
填写名称、选择镜像文件、指定端口映射、选择网络即可。ip可以自动生成。
7.1Panel中查看容器运行日志
刚刚创建的容器,默认就运行了。点击右边的“日志”,弹出可以查看日志。
从日志来看,可以看到启动是正常的。
8.浏览器再访问试试
我的1Panel服务器的ip是10.1.230.94。刚刚创建容器配置的映射端口是9001对应容器的8080端口。所以访问地址就变成了 http://10.1.230.94:9001/hello?name=docker
四.总结
我们经历了maven创建创建、docker插件使用、1Panel容器创建三个主要过程。实现了eclipse工具中maven工程调用远程docker服务完成镜像文件构建。但pom中,只是简单的将maven插件写在了build中,每次maven工程install都会去构建镜像文件,这里不太合理,下次再写一篇文章,将这个一部分“优雅”一些。
到这里,勉强达到目的吧!其实过程中遇到很多问题。比如:
1)docker对接不上,提示0.0.0.0:9527等信息,是没有设置系统环境变量DOCKER_HOST引起的。
2)构建报错“Could not acquire image ID or digest following build”。我直接把Dockerfile放到工程根目录,对应pom中指定dockerfile就不写路径了。它就没有问题了,为啥原因还没有去深究。