前面的文章 《跟我学SpringCloud | 第十八篇:微服务 Docker 化之基础环境》 我们介绍了基础环境系统和 JRE 的容器化,这一节我们介绍 Spring Cloud 组件的容器化,主要包括 eureka-server 、 gateway-server 和 provider-server 。
这里我们根据 dockerfile-maven-plugin 这个 maven 插件来构建,可以用来构建 docker 镜像的 maven 插件有很多,其中使用比较多的包括 docker-maven-plugin ,这两个插件是同一个人在 Github 上开源的, docker-maven-plugin 被作者标记为不活跃的,并且建议大家使用 dockerfile-maven-plugin ,作者可能是觉得 docker-maven-plugin 在使用的方式上并不是那么的优雅,才又新写了 dockerfile-maven-plugin ,具体信息可以访问 docker-maven-plugin 在 Github 上的官方仓库( https://github.com/spotify/do... )。
本篇文章我们将介绍如何在 IDE 工具 idea 中使用 Docker 工具,并为我们的工程构建镜像。
父工程 pom.xml 依赖文件:
代码清单:chapter18/pom.xml
<build> <plugins> <plugin> <groupId>com.spotify</groupId> <artifactId>dockerfile-maven-plugin</artifactId> <version>${dockerfile.maven.version}</version> <executions> <execution> <id>default</id> <goals> <goal>build</goal> <goal>push</goal> </goals> </execution> </executions> <configuration> <repository>${docker.image.prefix}/${project.artifactId}</repository> <tag>${project.version}</tag> <buildArgs> <JAR_FILE>${project.build.finalName}.jar</JAR_FILE> </buildArgs> </configuration> </plugin> </plugins> </build>
这里笔者仅截取了 dockerfile-maven-plugin 相关的代码,其余代码可参考 Github 仓库。
<configuration>
标签中是一些有关于 Docker 镜像相关的配置,包括当前的 <repository>
和 <tag>
。但是经笔者测试,如果使用 idea 生成远端镜像(本地无Docker服务),这两个部分还是会为 null 的,生成完后需要使用命令 docker tag [imageId] [repository]:[tag]
来重新命名镜像。如果本地有 Docker 服务,则无此问题。 代码清单:chapter18/eureka_server/pom.xml
<build> <plugins> <plugin> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-maven-plugin</artifactId> </plugin> <plugin> <groupId>com.spotify</groupId> <artifactId>dockerfile-maven-plugin</artifactId> </plugin> </plugins> </build>
由于在父工程中已经详细配置相关内容,这里仅需要将 dockerfile-maven-plugin
引入即可。
代码清单:chapter18/eureka_server/Dockerfile
FROM registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre ARG JAR_FILE ENV PROFILE default ADD target/${JAR_FILE} /opt/app.jar EXPOSE 8080 ENTRYPOINT java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -Duser.timezone=Asia/Shanghai -Dfile.encoding=UTF-8 -Dspring.profiles.active=${PROFILE} -jar /opt/app.jar
registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre
镜像。 ${project.build.finalName}.jar
。 Asia/Shanghai
,如果不做指定,可能默认时区不是中国的时区,这里一定要注意 JAVA_OPTS
环境变量,允许不同的应用去指定不同的 jvm 参数。 PROFILE
环境变量,允许不同的应用去指定不同的 profile。 代码清单:chapter18/eureka_server/src/main/resources/application.yml
server: port: 8080 spring: application: name: spring-cloud-eureka-server cloud: inetutils: use-only-site-local-interfaces: true eureka: instance: prefer-ip-address: true lease-expiration-duration-in-seconds: 90 lease-renewal-interval-in-seconds: 30 server: enable-self-preservation: false eviction-interval-timer-in-ms: 60000 client: register-with-eureka: false service-url: defaultZone: http://${EUREKA_SERVER_HOST}:${EUREKA_SERVER_PORT}/eureka/ management: endpoints: web: exposure: include: '*'
EUREKA_SERVER_HOST
和 EUREKA_SERVER_PORT
,不同的应用可以通过启动命令来进行配置。 其余部分代码笔者这里就不列出了,有需要的朋友请参考 Github 仓库,接下来尝试打包镜像,这里我们直接使用 idea 的 package 命令,也可以在工程的跟目录下执行命令:
mvn clean package
执行以上命令需本地配置 maven 环境变量,否则会报错 mvn 命令找不到。笔者使用 idea 提供的 package 命令,具体操作如图:
直接双击,可以看到控制台开始执行打包命令,在打包完成后会将 target/${project.build.finalName}.jar
打包成 Docker 镜像,我们可以看到控制台输出的命令:
[INFO] Image will be built as registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT [INFO] [INFO] Step 1/6 : FROM registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre [INFO] [INFO] Pulling from springcloud-book/java [INFO] Image 9d48c3bd43c5: Already exists [INFO] Image 828e49a80267: Already exists [INFO] Image 00b99dcc31ec: Already exists [INFO] Image e6e45bfebaec: Already exists [INFO] Digest: sha256:32d9a2557298d7b56997ded086baf043145ca178b71f6c8f47e76f837614bda0 [INFO] Status: Downloaded newer image for registry.cn-shanghai.aliyuncs.com/springcloud-book/java:8u221-jre [INFO] ---> 5f59ebcc4b59 [INFO] Step 2/6 : ARG JAR_FILE [INFO] [INFO] ---> Running in 8e3e51705681 [INFO] Removing intermediate container 8e3e51705681 [INFO] ---> 0bcb834dc28b [INFO] Step 3/6 : ENV PROFILE default [INFO] [INFO] ---> Running in 4a8e840e7a95 [INFO] Removing intermediate container 4a8e840e7a95 [INFO] ---> 11f97aef63ee [INFO] Step 4/6 : ADD target/${JAR_FILE} /opt/app.jar [INFO] [INFO] ---> 61c0ff0c5b6e [INFO] Step 5/6 : EXPOSE 8080 [INFO] [INFO] ---> Running in 264bf0d042b6 [INFO] Removing intermediate container 264bf0d042b6 [INFO] ---> d951ab655bd5 [INFO] Step 6/6 : ENTRYPOINT java ${JAVA_OPTS} -Djava.security.egd=file:/dev/./urandom -Duser.timezone=Asia/Shanghai -Dfile.encoding=UTF-8 -Dspring.profiles.active=${PROFILE} -jar /opt/app.jar [INFO] [INFO] ---> Running in 4bd69be29edc [INFO] Removing intermediate container 4bd69be29edc [INFO] ---> 704768c9dd75 [INFO] Successfully built 704768c9dd75 [INFO] Successfully tagged registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT [INFO] [INFO] Detected build of image with id 704768c9dd75 [INFO] Building jar: D:/Development/SpringCloudLearning/chapter18/eureka_server/target/eureka_server-0.0.1-SNAPSHOT-docker-info.jar [INFO] Successfully built registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:38 min [INFO] Finished at: 2019-09-21T20:05:50+08:00 [INFO] ------------------------------------------------------------------------
从以上命令,我们可以看到镜像每一步的构建过程,同样,这个镜像笔者这里 push 到阿里云的镜像仓库,有需要的朋友可以直接 pull 后使用。
docker pull registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
测试这里笔者启动两个镜像,构建两个 eureka_server 服务,对外映射分别使用不同的端口, 8761 和 8762 ,命令如下:
docker run -p 8761:8080 --rm / -e JAVA_OPTS='-server -Xmx1g' / -e PROFILE='default' / -e EUREKA_SERVER_HOST=192.168.0.128 / -e EUREKA_SERVER_PORT=8762 / registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
docker run -p 8762:8080 --rm / -e JAVA_OPTS='-server -Xmx1g' / -e PROFILE='default' / -e EUREKA_SERVER_HOST=192.168.0.128 / -e EUREKA_SERVER_PORT=8761 / registry.cn-shanghai.aliyuncs.com/springcloud-book/eureka_server:0.0.1-SNAPSHOT
启动成功后打开浏览器分别访问路径: http://localhost :8761/ 、 http://localhost :8762/ ,结果如图:
还有其余两个工程 provider_server 和 gateway_server 笔者这里就不做演示了,相关 Dockerfile 和运行所使用的命令都已经上传至 Github 仓库,有需要的读者可以直接访问 Github 仓库获取。
示例代码-Github
示例代码-Gitee