docker-compose構建springcloud微服務專案
目錄
1、前言
開發構建過s[ringcloud微服務專案的人都知道,眾多的服務部署起來相當麻煩,docker的出現極大程度的解決了這個問題,但通過docker部署時,由於服務數量之多,啟停服務就會變得麻煩。docker-compose就解決了這個問題,docker-compose的介紹可以檢視上一篇文章《Docker Compose介紹、安裝》
基於springcloud微服務進行實戰說明,將構建一個在Docker Compose上執行的註冊中心、配置中心、閘道器服務三個服務(三個容器),以此掌握docker Compose的基本使用。
2、服務準備
註冊中心、配置中心、閘道器服務,使用之前開發好的服務,這裡不再具體說明如何開發,程式碼可從github上獲取,https://github.com/xcbeyond/springCloudLearning。由於github上程式碼會經常進行優化調整,故此將本文演示程式碼打包了一份供大家下載,便於與文中提及的保持一致。
涉及服務如下:
序號 |
專案名 |
打包jar名 |
說明 |
|
1 |
register-center-1.0.jar |
註冊中心 |
||
2 |
config-center-1.0.jar |
配置中心 |
||
3 |
|
gateway-1.0.jar |
閘道器服務 |
涉及服務、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伺服器上,我是存放在如下結構的目錄下,具體依個人習慣而定。
[[email protected] ~]$ cd microservice/
[[email protected] 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(註冊中心):
[[email protected] 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(配置中心):
[[email protected] 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(閘道器服務):
[[email protected] 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命令後臺啟動。
[[email protected] 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
[[email protected] 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 刪除所有服務(容器)