[TOC] ## 指令 ### build 指定 `Dockerfile`路徑,并構建它 `Dockerfile`所在絕對或相對路徑 `build: /path/to/build/dir` ### command 覆蓋容器啟動后默認執行的命令 ``` web: build: . command: python manage.py runserver 0.0.0.0:8000 ``` ### devices 指定設備映射 ``` devices: - "/dev/ttyUSB1:/dev/ttyUSB0" ``` ### env_file 導入 env 環境 ``` env_file: .env env_file: - ./common.env - ./apps/web.env - /opt/secrets.env ``` common.env ```bash # common.env: 自持 # 注釋 PROG_ENV=development ``` ### environment 設置環境變量 ``` environment: RACK_ENV: development SESSION_SECRET: //or environment: - RACK_ENV=development - SESSION_SECRET ``` > 如果變量名稱或者值中用到`true|false，yes|no`等表達布爾含義的詞匯，最好放到引號里，避免 YAML 自動解析某些內容為對應的布爾語義 ### expose 暴露端口，但不映射到宿主機 只被連接的服務訪問,僅可以指定內部端口為參數 ``` expose: - "3000" - "8000" ``` ### extends 基于其它模板文件進行擴展 ``` # common.yml webapp: build: ./webapp environment: - DEBUG=false - SEND_EMAILS=false ``` ``` # development.yml web: extends: file: common.yml service: webapp ports: - "8000:8000" links: - db environment: - DEBUG=true db: image: postgres ``` > 推薦在基礎模板中只定義一些可以共享的鏡像和環境變量，在擴展模板中具體指定應用變量、鏈接、數據卷等信息 ### extra_hosts ``` extra_hosts: - "googledns:8.8.8.8" - "dockerhub:52.1.157.61" ``` 會在啟動后的服務容器中`/etc/hosts`文件中添加如下兩條條目。 ``` 8.8.8.8 googledns 52.1.157.61 dockerhub ``` ### image 指定鏡像名為或 id 指定鏡像名為或 id ,Compose 會進行拉取 ``` image: ubuntu image: orchardup/postgresql image: a4bc65fd ``` ### labels 為容器添加 Docker 元數據 為容器添加 Docker 元數據（metadata）信息。例如可以為容器添加輔助說明信息。 ``` labels: com.startupteam.description: "webapp for a startup team" com.startupteam.department: "devops department" com.startupteam.release: "rc3 for v1.0" ``` ### links 鏈接到其它服務中的容器 使用服務名稱（同時作為別名）或服務名稱：服務別名 ``` links: - db - db:database - redis ``` 使用的別名將會自動在服務容器中的 /etc/hosts 里創建。例如： ``` 172.17.2.186 db 172.17.2.186 database 172.17.2.187 redis ``` ### net 設置網絡模式 使用和 docker client 的 --net 參數一樣的值。 ``` net: "bridge" net: "none" net: "container:[name or id]" net: "host" ``` ### ports 暴露端口信息 ``` ports: - "3000" - "8000:8000" - "49100:22" - "127.0.0.1:8001:8001" ``` ### ulimits 指定容器的 ulimits 限制值 ``` ulimits: nproc: 65535 nofile: soft: 20000 hard: 40000 ``` ### privileged 擁有正真的 root權限 開了可以掛載host上的硬盤或其它的設備 ### volumes 數據卷所掛載路徑設置 ``` volumes: - /var/lib/mysql - cache/:/tmp/cache - ~/configs:/etc/configs/:ro ``` ### volumes_from ``` 從另一個服務或容器掛載它的數據卷。 volumes_from: - service_name - container_name ``` ### entrypoint 指定服務容器啟動后執行的命令 `entrypoint: /code/entrypoint.sh` ### user: nginx 指定容器中運行應用的用戶名 `user: nginx` ### working_dir 指定容器中工作目錄 `working_dir: /code` ### restart:always 指定容器退出后的重啟策略為始終重啟 `restart: always` ### 模擬一個假的遠程控制臺 `tty: true`