一.背景
公司主机管理小组的同事期望我们开发的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就不写路径了。它就没有问题了,为啥原因还没有去深究。