docker-compose 构建 springcloud 微服务项目
1、前言
开发构建过springcloud微服务项目的人都知道,众多的服务部署起来相当麻烦,docker的出现极大程度的解决了这个问题,但通过docker部署时,由于服务数量之多,启停服务就会变得麻烦。docker-compose就解决了这个问题。
基于springcloud微服务进行实战说明,将构建一个在Docker Compose上运行的注册中心、配置中心、网关服务三个服务(三个容器),以此掌握docker Compose的基本使用。
2、服务准备
注册中心、配置中心、网关服务,使用之前开发好的服务,这里不再具体说明如何开发,代码可从github上获取,。由于github上代码会经常进行优化调整,故此将本文演示代码打包了一份供大家下载,便于与文中提及的保持一致。
涉及服务如下:
涉及服务、dockerfile、docker-compose.yml项目结构如下:
(只列出主要关注的文件位置)
springCloudLearning 父项目
├── docker-compose.yml docker-compose文件
├── springCloudEureka 注册中心
│ └── src
│ └── main
│ └── docker
│ └──Dockerfile 注册中心的Dockerfile
├── springCloudConfigServer 配置中心
│ └── src
│ └── main
│ └── docker
│ └──Dockerfile 配置中心的Dockerfile
└── springCloudZuulGateway 网关服务
└── src
└── main
└── docker
└──Dockerfile 网关服务的Dockerfile
三个服务的启动顺序如下:
springCloudEureka ——> springCloudConfigServer ——> springCloudZuulGateway
3、Dockerfile定义
为每个服务编写docker镜像的Dockerfile脚本,分别位于各项目的\src\main\docker目录下管理。Dockerfile中所有指令的详细说明,请查阅关于Dockerfile文件定义的详细说明介绍,本文只说明本例中用到的指令。
(1)springCloudEureka:
ROM java:8RUN mkdir /microserviceWORKDIR /microserviceADD /register-center-1.0.jar /microservice/EXPOSE 8761ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/microservice/register-center-1.0.jar"]
说明:
- FROM java:8
FROM 指定基于的基础镜像。必须在第一行,本例中是基于Java 8作为基础镜像的。
- RUN mkdir /microservice
RUN 执行shell命令。本例中是用于创建microservice目录。
- WORKDIR /microservice
WORKDIR 为后续的RUN、CMD、ENTRYPOINT指令配置工作目录。
- ADD /register-center-1.0.jar /microservice/
ADD 复制指定位置的程序包到容器的指定位置。本例中是将位于该Dockerfile同一目录下的springCloudEureka-1.0.jar复制到容器的/microservice/目录下。
- EXPOSE 8761
EXPOSE 暴露容器的端口,供外部使用。本例中是只注册中心服务springCloudEureka的端口,并确保对外能够访问。
- ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", ……]
ENTRYPOINT 配置容器启动后只需的命令。本例中是启动Java程序。
(2)springCloudConfigServer:
FROM java:8
RUN mkdir /microservice
WORKDIR /microservice
ADD /config-center-1.0.jar /microservice/
EXPOSE 8888
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/microservice/config-center-1.0.jar"]
(3)springCloudZuulGateway:
FROM java:8
RUN mkdir /microservice
WORKDIR /microservice
ADD /gateway-1.0.jar /microservice/
EXPOSE 8111
ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom", "-jar", "/microservice/gateway-1.0.jar"]
4、docker-compose.yml定义
这个脚本中定义了一次性启停上述三个服务,并实现服务间的通信,脚本内容如下:
version: '2'
services:
#注册中心
#自定义的服务名称
register-center:
#镜像名称
image: register-center:v1
#容器名称
container_name: register-center
#容器down掉后,会自动重启
restart: always
#挂载一个目录或者一个已存在的数据卷容器。格式为宿主机目录:容器内目录
volumes:
- $PWD/register-center/register-center-1.0.jar:/microservice/
#映射端口。格式为宿主机端口:容器端口
ports:
- "8761:8761"
#容器启动后,执行的命令
command: java -Djava.security.egd=file:/dev/./urandom -jar /microservice/register-center-1.0.jar
#配置中心
config-center:
image: config-center:v1
container_name: config-center
restart: always
volumes:
- $PWD/config-center/config-center-1.0.jar:/microservice/
ports:
- "8888:8888"
command: java -Djava.security.egd=file:/dev/./urandom -jar /microservice/config-center-1.0.jar
depends_on:
- register-center
links:
- register-center:register-center
#网关服务
gateway:
image: gateway:v1
container_name: gateway
restart: always
volumes:
- $PWD/gateway/gateway-1.0.jar:/microservice/
ports:
- "8111:8111"
command: java -Djava.security.egd=file:/dev/./urandom -jar /microservice/gateway-1.0.jar
depends_on:
- register-center
- config-center
links:
- register-center:register-center
- config-center:config-center
5、编译、运行
将各个打包好的服务jar包 、Dockerfile脚本、 docker-compose.yml上传至docker服务器上,我是存放在如下结构的目录下,具体依个人习惯而定。
[docker@docker ~]$ cd microservice/
[docker@docker microservice]$ ll
total 4
drwxrwxr-x. 2 docker docker 51 Sep 20 11:09 config-center
-rwxrwxrwx. 1 docker docker 1764 Sep 20 14:18 docker-compose.yml
drwxrwxr-x. 2 docker docker 45 Sep 20 11:10 gateway
drwxrwxr-x. 2 docker docker 53 Sep 20 11:10 register-center
(1)编译镜像
register-center(注册中心):
[docker@docker register-center]$ docker build -t register-center:v1 .
Sending build context to Docker daemon 44.31MB
Step 1/6 : FROM java:8
---> d23bdf5b1b1b
Step 2/6 : RUN mkdir /microservice
---> Running in fcf4af033ac5
---> c0cf16047e86
Removing intermediate container fcf4af033ac5
Step 3/6 : WORKDIR /microservice
---> cc1fae4f23dc
Removing intermediate container d6fd78d760a9
Step 4/6 : ADD /register-center-1.0.jar /microservice/
---> ee8d0db56843
Removing intermediate container dd5b20c5e72c
Step 5/6 : EXPOSE 8761
---> Running in 46ae28623bd1
---> d02692f9c49c
Removing intermediate container 46ae28623bd1
Step 6/6 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /microservice/register-center-1.0.jar
---> Running in cf63f2ca01af
---> 51431eb470e5
Removing intermediate container cf63f2ca01af
Successfully built 51431eb470e5
Successfully tagged register-center:v1
gateway(网关服务):
[docker@docker gateway]$ docker build -t gateway:v1 .
Sending build context to Docker daemon 42.44MB
Step 1/6 : FROM java:8
---> d23bdf5b1b1b
Step 2/6 : RUN mkdir /microservice
---> Using cache
---> c0cf16047e86
Step 3/6 : WORKDIR /microservice
---> Using cache
---> cc1fae4f23dc
Step 4/6 : ADD /gateway-1.0.jar /microservice/
---> 920d5c366b08
Removing intermediate container 86346da6cb03
Step 5/6 : EXPOSE 8111
---> Running in 0b306fc30056
---> 91efbbdb7011
Removing intermediate container 0b306fc30056
Step 6/6 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /microservice/gateway-1.0.jar
---> Running in 77ac20ec51c0
---> 1308e926e769
Removing intermediate container 77ac20ec51c0
Successfully built 1308e926e769
Successfully tagged gateway:v1
(2)运行
在docker-compose.yml目录下,执行 docker-compose up -d 命令后台启动。
[docker@docker microservice]$ ll
total 4
drwxrwxr-x. 2 docker docker 51 Sep 20 11:09 config-center
-rwxrwxrwx. 1 docker docker 1764 Sep 20 14:18 docker-compose.yml
drwxrwxr-x. 2 docker docker 45 Sep 20 11:10 gateway
drwxrwxr-x. 2 docker docker 53 Sep 20 11:10 register-center
[docker@docker microservice]$ docker-compose up -d
至此,通过docker-compose完成微服务项目中多个服务的启动。
docker-compose常用命令说明:
1)启停
- docker-compose up -d 全部后台启动
- docker-compose stop xxx 停止某一个服务
- docker-compose stop 停止所有服务
- docker-compose start xxx启动某一个服务
- docker-compose restart xxx 重启某一个服务
2)其他
- docker-compose config 查看当前yml文件中的所有配置
- docker-compose rm xxx 删除某一个服务(容器)
- docker-compose rm 删除所有服务(容器)
版权声明: 本文为 InfoQ 作者【xcbeyond】的原创文章。