9. Docker compose
從上一節課我們瞭解到可以使用一個Dockerfile模板文件來快速構建一個自己的鏡像並運行爲應用容器。但是在平時工作的時候,我們會碰到多個容器要互相配合來使用的情況,比如數據庫加上咱們Web應用等等。這種情況下,每次都要一個一個啓動容器設置命令變得麻煩起來,所以Docker Compose誕生了。
9.1. Dockercompse簡介
Compose的作用是“定義和運行多個Docker容器的應用”。使用Compose,你可以在一個配置文件(yaml格式)中配置你應用的服務,然後使用一個命令,即可創建並啓動配置中引用的所有服務。
Compose中兩個重要概念:
-
服務 (service):一個應用的容器,實際上可以包括若干運行相同鏡像的容器實例。
-
項目 (project):由一組關聯的應用容器組成的一個完整業務單元,在 docker-compose.yml文件中定義。
9.2. Dockercompse安裝
Compose支持三平臺Windows、Mac、Linux,安裝方式各有不同。我這裏使用的是Linux系統,其他系統安裝方法
可以參考官方文檔和開源GitHub鏈接:
Docker Compose官方文檔鏈接:https://docs.docker.com/compose
Docker Compose GitHub鏈接:https://github.com/docker/compose
Linux上有兩種安裝方法,Compose項目是用Python寫的,可以使用Python-pip安裝,也可以通過GitHub下載二進制文件進行安裝。
通過Python-pip安裝
1.安裝Python-pip
yum install -y epel-release
yum install -y python-pip
2.安裝docker-compose
pip install docker-compose
3.驗證是否安裝
docker-compose version
4.卸載
pip uninstall docker-compose
通過GitHub鏈接下載安裝
非ROOT用戶記得加sudo
1.通過GitHub獲取下載鏈接,以往版本地址:https://github.com/docker/compose/releases
curl -L "https://github.com/docker/compose/releases/download/1.23.2/docker-compose-$(uname-s)-$(uname -m)" -o /usr/local/bin/docker-compose
2.給二進制下載文件可執行的權限
chmod +x /usr/local/bin/docker-compose
3.可能沒有啓動程序,設置軟連接,比如:
ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
4.驗證是否安裝
docker-compose version
5.卸載
如果是二進制包方式安裝的,刪除二進制文件即可。
rm /usr/local/bin/docker-compose
簡單實例
Compose的使用非常簡單,只需要編寫一個docker-compose.yml,然後使用docker-compose 命令操作即可。
docker-compose.yml描述了容器的配置,而docker-compose 命令描述了對容器的操作
1.我們使用一個微服務項目先來做一個簡單的例子,首先創建一個compose的工作目錄,然後創建一個eureka文件夾,裏面放可執行jar包和編寫一個Dockerfile文件,目錄結構如下:
compose
eureka
Dockerfile
eureka-server-2.0.2.RELEASE.jar
2.在compose目錄創建模板文件docker-compose.yml文件並寫入以下內容
version: '1'
services:
eureka:
build: ./eureka
ports:
- 3000:3000
expose:
- 3000
9.3. DockerCompose常用命令
9.3.1.1. image
指定鏡像名稱或者鏡像id,如果該鏡像在本地不存在,Compose會嘗試pull下來。
示例:
image: java:8
9.3.1.2. build
指定Dockerfile文件的路徑。可以是一個路徑,例如:build: ./dir
也可以是一個對象,用以指定Dockerfile和參數,例如:
build: context: ./dir dockerfile: Dockerfile-alternate args: buildno: 1
9.3.1.3. command
覆蓋容器啓動後默認執行的命令。
示例:
command: bundle exec thin -p 3000
也可以是一個list,類似於Dockerfile總的CMD指令,格式如下:
command: [bundle, exec, thin, -p, 3000]
9.3.1.4. links
鏈接到其他服務中的容器。可以指定服務名稱和鏈接的別名使用SERVICE:ALIAS 的形式,或者只指定服務名稱,示
例:
web: links: - db - db:database – redis
9.3.1.5. external_links
表示鏈接到docker-compose.yml外部的容器,甚至並非Compose管理的容器,特別是對於那些提供共享容器或共同
服務。格式跟links類似,示例:
external_links: - redis_1 - project_db_1:mysql - project_db_1:postgresql
9.3.1.6. ports
暴露端口信息。使用宿主端口:容器端口的格式,或者僅僅指定容器的端口(此時宿主機將會隨機指定端口),類似於docker run -p ,示例:
ports:
"3000"
"3000-3005"
"8000:8000"
"9090-9091:8080-8081"
"49100:22"
"127.0.0.1:8001:8001"
"127.0.0.1:5000-5010:5000-5010"
9.3.1.7. expose
暴露端口,只將端口暴露給連接的服務,而不暴露給宿主機,示例:
expose: - "3000" - "8000"
9.3.1.8. volumes
卷掛載路徑設置。可以設置宿主機路徑 (HOST:CONTAINER) 或加上訪問模式 (HOST:CONTAINER:ro)。示例:
volumes:
Just specify a path and let the Engine create a volume
- /var/lib/mysql
Specify an absolute path mapping
- /opt/data:/var/lib/mysql
Path on the host, relative to the Compose file
- ./cache:/tmp/cache
User-relative path
- ~/configs:/etc/configs/:ro
Named volums
- datavolume:/var/lib/mysql
9.3.1.9. volumes_from
從另一個服務或者容器掛載卷。可以指定只讀或者可讀寫,如果訪問模式沒有指定,則默認是可讀寫。示例:
volumes_from:
-
service_name
-
service_name:ro
-
container:container_name
-
container:container_name:rw
9.3.1.10. environment
設置環境變量。可以使用數組或者字典兩種方式。只有一個key的環境變量可以在運行Compose的機器上找到對應的
值,這有助於加密的或者特殊主機的值。示例:
environment: RACK_ENV: development SHOW: 'true' SESSION_SECRET: environment: -
RACK_ENV=development - SHOW=true - SESSION_SECRET
9.3.1.11. env_file
從文件中獲取環境變量,可以爲單獨的文件路徑或列表。如果通過 docker-compose -f FILE 指定了模板文件,則env_file 中路徑會基於模板文件路徑。如果有變量名稱與 environment 指令衝突,則以envirment 爲準。示例:
env_file: .env env_file: - ./common.env - ./apps/web.env - /opt/secrets.env
9.3.1.12. extends
繼承另一個服務,基於已有的服務進行擴展。
9.3.1.13. net
設置網絡模式。示例:
net: "bridge" net: "host" net: "none" net: "container:[service name or container name/id]"
9.3.1.14. dns
配置dns服務器。可以是一個值,也可以是一個列表。示例:
dns: 8.8.8.8 dns: - 8.8.8.8 - 9.9.9.9
9.3.1.15. dns_search
配置DNS的搜索域,可以是一個值,也可以是一個列表,示例:
dns_search: example.com dns_search: - dc1.example.com - dc2.example.com
9.3.1.16. 其它
docker-compose.yml 還有很多其他命令,可以參考docker-compose.yml文件官方文檔:
https://docs.docker.com/compose/compose-file/
9.4. 使用DockerCompose構建實例
使用docker-compose一次性來編排三個微服務:eureka服務(eureka-server-2.0.2.RELEASE.jar)、user服務(user-2.0.2.RELEASE.jar)、power服務(power-2.0.2.RELEASE.jar)
1.創建一個工作目錄和docker-compose模板文件
2.工作目錄下創建三個文件夾eureka、user、power,並分別構建好三個服務的鏡像文件
以eureka的Dockerfile爲例:
# 基礎鏡像
FROM java:8
# 作者
MAINTAINER user01
# 把可執行jar包複製到基礎鏡像的根目錄下
ADD eureka-server-2.0.2.RELEASE.jar /eureka-server-2.0.2.RELEASE.jar
# 鏡像要暴露的端口,如要使用端口,在執行docker run命令時使用-p生效
EXPOSE 3000
# 在鏡像運行爲容器後執行的命令
ENTRYPOINT ["java","-jar","/eureka-server-2.0.2.RELEASE.jar"]
目錄文件結構:
compose
docker-compose.yml
eureka
Dockerfile
eureka-server-2.0.2.RELEASE.jar
user
Dockerfile
user-2.0.2.RELEASE.jar
power
Dockerfile
power-2.0.2.RELEASE.jar
3.編寫docker-compose模板文件:
version: '1'
services:
eureka:
image: eureka:v1
ports:
- 8080:8080
user:
image: user:v1
ports:
- 8081:8081
power:
image: power:v1
ports:
- 8082:8082
4.啓動微服務,可以加上參數-d後臺啓動
docker-compose up -d