碼上快樂

相關內容    簡體    繁體

python | docker-compose 安裝

本文轉載自   查看原文   2020-12-05 12:19   480 

安裝 docker-compose

切換到root 用戶

下載

1
 
curl -L https://get.daocloud.io/docker/compose/releases/download/1.25.4/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

修改權限

1
 
chmod +x /usr/local/bin/docker-compose

檢查是否成功

1
 
docker-compose -version

此外，因為 docker-compose 使用 Python 編寫，所以可以使用 pip 直接安裝：

1
2
 
$ pip install -U docker-compose
1

第一個 Compose file

1
2
3
4
5
6
7
8
9
10
11
 
version: '3'
services:
 spider:
 build:
 context: .
 dockerfile: Dockerfile
 volumes:
 - $PWD:/code
 - /data1/datascience/scrapy-data:/data
 command: scrapy crawl comment
12345678910

說明：

  • version 指定了 compose file 的版本，最新的版本為 3.4
  • services 下定義服務，這里定義了一個爬蟲服務 spider
  • build 指定構建鏡像上下文、Dockerfile 文件和 ARGS 等。
  • volumes 用於創建卷並掛載，這里掛載了源碼目錄和數據存儲目錄
  • command 指定服務啟動時執行的命令，參考 Dockerfile COMMAND。

Compose file 指令

先來看一份 docker-compose.yml 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
 
version: '2'
services:
 web:
 image: dockercloud/hello-world
 ports:
 - 8080
 networks:
 - front-tier
 - back-tier

 redis:
 image: redis
 links:
 - web
 networks:
 - back-tier

 lb:
 image: dockercloud/haproxy
 ports:
 - 80:80
 links:
 - web
 networks:
 - front-tier
 - back-tier
 volumes:
 - /var/run/docker.sock:/var/run/docker.sock 

networks:
 front-tier:
 driver: bridge
 back-tier:
driver: bridge

可以看到一份標准配置文件應該包含 version、services、networks 三大部分，其中最關鍵的就是 services 和 networks 兩個部分，下面先來看 services 的書寫規則。

  • image: 指定容器啟動的鏡像，對應 Dockerfile FROM。
    在 services 標簽下的第二級標簽是 web，這個名字是用戶自己自定義，它就是服務名稱。image 則是指定服務的鏡像名稱或鏡像 ID。如果鏡像在本地不存在，Compose 將會嘗試拉取這個鏡像。

    1
    2
    3
    4
    5
    		 
    image: redis
    image: ubuntu:14.04
    image: tutum/influxdb
    image: example-registry.com:4000/postgresql
    image: a4bc65fd

  • build: 服務除了可以基於指定的鏡像，還可以基於一份 Dockerfile，在使用 up 啟動之時執行構建任務，這個構建標簽就是 build，它可以指定 Dockerfile 所在文件夾的路徑。Compose 將會利用它自動構建這個鏡像，然后使用這個鏡像啟動服務容器。

    最簡單的直接利用 Dockerfile 構建，只需要指定上下文或者 Dockerfile 位置：

    1
    2
    3
    4
    		 
    version: '2'
    services:
     webapp:
     build: .

如果需要更細粒度的配置，需要使用 context, dockerfile, args, labels 等選項。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
 
# Dockerfile
ARG buildno
ARG password

RUN echo "Build number: $buildno"
RUN script-requiring-password.sh "$password"


# docker-compose file
version: '2'
services:
 webapp:
 image: webapp:tag
 build:
 context: ./dir
 dockerfile: Dockerfile-alternate
 args:
 buildno: 1
 password: secret

  • command: 使用 command 可以覆蓋容器啟動后默認執行的命令。

    1
    2
    3
    		 
    command: bundle exec thin -p 3000

    command: ["bundle", "exec", "thin", "-p", "3000"]

  • container_name: 指定運行時容器名稱，而不使用默認格式（<項目名稱><服務名稱><序號>）。

    1
    		 
    container_name: my-web-container

  • depends_on: 指明服務之間依賴，解決了容器的依賴、啟動先后的問題。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    		 
    version: '3'
    services:
     web:
     build: .
     depends_on:
     - db
     - redis
     redis:
     image: redis
     db:
     image: postgres

被依賴的服務會優先啟動（顯然）
若服務啟動時被依賴服務沒有啟動，則自動被啟動

  • dns: 指定 DNS 服務器。

    1
    2
    3
    4
    		 
    dns: 8.8.8.8
    dns:
     - 8.8.8.8
     - 9.9.9.9

  • tmpfs: 掛載臨時目錄到容器內部，與 run 的參數一樣效果：

    1
    2
    3
    4
    		 
    tmpfs: /run
    tmpfs:
     - /run
     - /tmp

  • entrypoint: 在 Dockerfile 中有一個指令叫做 ENTRYPOINT 指令，用於指定接入點，在 docker-compose.yml 中可以定義接入點，覆蓋 Dockerfile 中的定義。

    1
    		 
    entrypoint: /code/entrypoint.sh

  • env_file: 專門存放變量的文件。如果通過 docker-compose -f FILE 指定了配置文件，則 env_file 中路徑會使用配置文件路徑。如果有變量名稱與 environment 指令沖突，則以后者為准。格式如下：

    1
    2
    3
    4
    5
    6
    		 
    env_file: .env

    env_file:
     - ./common.env
     - ./apps/web.env
     - /opt/secrets.env

文件格式如：

1
 
RACK_ENV=development

注意的是這里所說的環境變量是對宿主機的 Compose 而言的，如果在配置文件中有 build 操作，這些變量並不會進入構建過程中，如果要在構建中使用變量還是首選前面剛講的 arg 標簽。

  • environment: 與上面的 env_file 標簽完全不同，反而和 arg 有幾分類似，這個標簽的作用是設置鏡像變量，它可以保存變量到鏡像里面，也就是說啟動的容器也會包含這些變量設置，這是與 arg 最大的不同。

    一般 arg 標簽的變量僅用在構建過程中。而 environment 和 Dockerfile 中的 ENV 指令一樣會把變量一直保存在鏡像、容器中，類似 docker run -e 的效果。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    		 
    environment:
     RACK_ENV: development
     SHOW: 'true'
     SESSION_SECRET:

    environment:
     - RACK_ENV=development
     - SHOW=true
     - SESSION_SECRET

  • expose: 這個標簽與 Dockerfile 中的 EXPOSE 指令一樣，用於指定暴露的端口，但是只是作為一種參考，實際上 docker-compose.yml 的端口映射還得 ports 這樣的標簽。

    1
    2
    3
    		 
    expose:
     - "3000"
     - "8000"

  • external_links: 在使用 Docker 過程中，我們會有許多單獨使用docker run啟動的容器，為了使 Compose 能夠連接這些不在 docker-compose.yml 中定義的容器，我們需要一個特殊的標簽，就是 external_links，它可以讓 Compose 項目里面的容器連接到那些項目配置外部的容器（前提是外部容器中必須至少有一個容器是連接到與項目內的服務的同一個網絡里面）。

    1
    2
    3
    4
    		 
    external_links:
     - redis_1
     - project_db_1:mysql
     - project_db_1:postgresql

  • extra_hosts: 添加主機名的標簽，就是往 /etc/hosts 文件中添加一些記錄、

    1
    2
    3
    		 
    extra_hosts:
     - "somehost:162.242.195.82"
     - "otherhost:50.31.209.229"

  • labels: 向容器添加元數據，和 Dockerfile 的 LABEL 指令一個意思。

    1
    2
    3
    4
    5
    6
    7
    8
    		 
    labels:
     com.example.description: "Accounting webapp"
     com.example.department: "Finance"
     com.example.label-with-empty-value: ""
    labels:
     - "com.example.description=Accounting webapp"
     - "com.example.department=Finance"
     - "com.example.label-with-empty-value"

  • links: 上面的 depends_on 標簽解決的是啟動順序問題，這個標簽解決的是容器連接問題，與 Docker client 的 –link 一樣效果，會連接到其它服務中的容器。。

    1
    2
    3
    4
    5
    		 
    web:
     links:
     - db
     - db:database
     - redis

使用的別名將會自動在服務容器中的 /etc/hosts 里創建。
相應的環境變量也將被創建。

  • logging: 用於配置日志服務。默認的 driver 是 json-file。

    1
    2
    3
    4
    		 
    logging:
     driver: syslog
     options:
     syslog-address: "tcp://192.168.0.42:123"

  • pid: 將 PID 模式設置為主機 PID 模式，跟主機系統共享進程命名空間。容器使用這個標簽將能夠訪問和操縱其他容器和宿主機的名稱空間。

    1
    		 
    pid: "host"

  • ports: 映射端口的標簽。使用 HOST:CONTAINER 格式或者只是指定容器的端口，宿主機會隨機映射端口。

    1
    2
    3
    4
    5
    6
    		 
    ports:
     - "3000"
     - "8000:8000"
     - "49100:22"
     - "127.0.0.1:8001:8001"
    12345

    注意：當使用 HOST:CONTAINER 格式來映射端口時，如果你使用的容器端口小於 60 你可能會得到錯誤得結果，因為 YAML 將會解析 xx:yy 這種數字格式為 60 進制。所以建議采用字符串格式。

  • security_opt: 為每個容器覆蓋默認的標簽。簡單說來就是管理全部服務的標簽。比如設置全部服務的 user 標簽值為 USER:

    1
    2
    3
    4
    		 
    security_opt:
     - label:user:USER
     - label:role:ROLE
    123

  • stop_signal: 設置另一個信號來停止容器。在默認情況下使用的是 SIGTERM 停止容器。設置另一個信號可以使用 stop_signal 標簽。

    1
    2
    		 
    stop_signal: SIGUSR1
    1

  • volumes: 掛載一個目錄或者一個已存在的數據卷容器，可以直接使用 HOST:CONTAINER 這樣的格式，或者使用 HOST:CONTAINER:ro 這樣的格式，后者對於容器來說，數據卷是只讀的，這樣可以有效保護宿主機的文件系統。

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    		 
    volumes:
     # 只是指定一個路徑，Docker 會自動在創建一個數據卷（這個路徑是容器內部的）。
     - /var/lib/mysql

     # 使用絕對路徑掛載數據卷
     - /opt/data:/var/lib/mysql

     # 以 Compose 配置文件為中心的相對路徑作為數據卷掛載到容器。
     - ./cache:/tmp/cache

     # 使用用戶的相對路徑（~/ 表示的目錄是 /home/<用戶目錄>/ 或者 /root/）。
     - ~/configs:/etc/configs/:ro

     # 已經存在的命名的數據卷。
     - datavolume:/var/lib/mysql
    123456789101112131415

  • cap_add, cap_drop: 添加或刪除容器的內核功能。

  • devices: 設備映射列表。與 Docker client 的--device參數類似。

    1
    2
    3
    		 
    devices:
     - "/dev/ttyUSB0:/dev/ttyUSB0"
    12

  • extends: 這個標簽可以擴展另一個服務，擴展內容可以是來自在當前文件，也可以是來自其他文件，相同服務的情況下，后來者會有選擇地覆蓋原有配置。

    1
    2
    3
    4
    		 
    extends:
     file: common.yml
     service: webapp
    123

    用戶可以在任何地方使用這個標簽，只要標簽內容包含 file 和 service 兩個值就可以了。file 的值可以是相對或者絕對路徑，如果不指定 file 的值，那么 Compose 會讀取當前 YML 文件的信息。


免責聲明！

本站轉載的文章為個人學習借鑒使用，本站對版權不負任何法律責任。如果侵犯了您的隱私權益，請聯系本站郵箱yoyou2525@163.com刪除。



猜您在找 Docker-compose安裝 安裝docker和docker-compose docker以及docker-compose安裝 docker-compose安裝nginx docker-compose安裝rocketmq centos 安裝docker-compose docker-compose安裝libreoffice docker-compose安裝confluence docker-compose 安裝 rocketmq Linux安裝docker-compose
 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM