docker-compose构建springcloud微服务项目

作者:xcbeyond
疯狂源自梦想,技术成就辉煌!微信公众号:《程序猿技术大咖》号主,专注后端开发多年,拥有丰富的研发经验,乐于技术输出、分享,现阶段从事微服务架构项目的研发工作,涉及架构设计、技术选型、业务研发等工作。对于Java、微服务、数据库、Docker有深入了解,并有大量的调优经验。












目录

1、前言

2、服务准备

3、Dockerfile定义

4、docker-compose.yml定义

5、编译、运行

(1)编译镜像

(2)运行

docker-compose常用命令说明:

1、前言
      开发构建过s[ringcloud微服务项目的人都知道,众多的服务部署起来相当麻烦,docker的出现极大程度的解决了这个问题,但通过docker部署时,由于服务数量之多,启停服务就会变得麻烦。docker-compose就解决了这个问题,docker-compose的介绍可以查看上一篇文章《Docker Compose介绍、安装》。

      基于springcloud微服务进行实战说明,将构建一个在Docker Compose上运行的注册中心、配置中心、网关服务三个服务(三个容器),以此掌握docker Compose的基本使用。

2、服务准备
     注册中心、配置中心、网关服务,使用之前开发好的服务,这里不再具体说明如何开发,代码可从github上获取,https://github.com/xcbeyond/springCloudLearning。由于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:

FROM java:8
RUN mkdir /microservice
WORKDIR /microservice
ADD /register-center-1.0.jar /microservice/
EXPOSE 8761
ENTRYPOINT ["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
config-center(配置中心):

 

 

[docker@docker config-center]$ docker build -t config-center:v1 .
Sending build context to Docker daemon  44.07MB
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 /config-center-1.0.jar /microservice/
 ---> 643c9fc7e5a5
Removing intermediate container 45b51e525c0e
Step 5/6 : EXPOSE 8888
 ---> Running in 602770ffb673
 ---> c75a04c7c5a5
Removing intermediate container 602770ffb673
Step 6/6 : ENTRYPOINT java -Djava.security.egd=file:/dev/./urandom -jar /microservice/config-center-1.0.jar
 ---> Running in e84912bfe2a5
 ---> 159990521122
Removing intermediate container e84912bfe2a5
Successfully built 159990521122
Successfully tagged config-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 删除所有服务(容器)