docker compose 編排

Compose是Docker的服務編排工具，主要用來構建基於Docker的複雜應用，Compose 經過一個配置文件來管理多個Docker容器，很是適合組合使用多個容器進行開發的場景。

說明：Compose是Fig的升級版，Fig已經再也不維護。Compose向下兼容Fig，全部fig.yml只須要改名爲docker-compose.yml便可被Compose使用。

服務編排工具使得Docker應用管理更爲方便快捷。 Compose網站：https://docs.docker.com/compose/

安裝Compose:

# 方法一： $ curl -L https://github.com/docker/compose/releases/download/1.8.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose $ chmod +x /usr/local/bin/docker-compose  # Linux下等效於 $ curl -L https://github.com/docker/compose/releases/download/1.8.1/docker-compose-Linux-x86_64 > /usr/local/bin/docker-compose; chmod +x /usr/local/bin/docker-compose  # 方法二：使用pip安裝，版本可能比較舊 $ yum install python-pip python-dev $ pip install docker-compose  # 方法三：做爲容器安裝 $ curl -L https://github.com/docker/compose/releases/download/1.8.0/run.sh > /usr/local/bin/docker-compose $ chmod +x /usr/local/bin/docker-compose  # 方法四：離線安裝 # 下載[docker-compose-Linux-x86_64](https://github.com/docker/compose/releases/download/1.8.1/docker-compose-Linux-x86_64)，而後從新命名添加可執行權限便可： $ mv docker-compose-Linux-x86_64 /usr/local/bin/docker-compose; $ chmod +x /usr/local/bin/docker-compose # 百度雲地址： http://pan.baidu.com/s/1slEOIC1 密碼: qmca # docker官方離線地址：https://dl.bintray.com/docker-compose/master/

安裝完成後能夠查看版本：

# docker-compose --version docker-compose 1.8.1

升級

若是你使用的是 Compose 1.2或者早期版本，當你升級完成後，你須要刪除或者遷移你現有的容器。這是由於，1.3版本， Composer 使用 Docker 標籤來對容器進行檢測，因此它們須要從新建立索引標記。

卸載

$ rm /usr/local/bin/docker-compose  # 卸載使用pip安裝的compose $ pip uninstall docker-compose

Compose區分Version 1和Version 2（Compose 1.6.0+，Docker Engine 1.10.0+）。Version 2支持更多的指令。Version 1沒有聲明版本默認是"version 1"。Version 1未來會被棄用。

版本1指的是忽略version關鍵字的版本；版本2必須在行首添加version: '2'。

入門示例

通常步驟

一、定義Dockerfile，方便遷移到任何地方；
二、編寫docker-compose.yml文件；
三、運行docker-compose up啓動服務

示例

準備工做：提早下載好鏡像：

docker pull mysql docker pull wordpress

須要新建一個空白目錄，例如wptest。新建一個docker-compose.yml

version: '2' services:  web:  image: wordpress:latest  links:  - db  ports:  - "8002:80"  environment:  WORDPRESS_DB_HOST: db:3306  WORDPRESS_DB_PASSWORD: 123456  db:  image: mysql  environment:  - MYSQL_ROOT_PASSWORD=123456

以上命令的意思是新建db和wordpress容器。等同於：

$ docker run --name db -e MYSQL_ROOT_PASSWORD=123456 -d mysql $ docker run --name some-wordpress --link db:mysql -p 8002:80 -d wordpress

注意，若是你是直接從fig遷移過來的，且web裏links是- db:mysql，這裏會提示沒有給wordpress設置環境變量，這裏須要添加環境變量WORDPRESS_DB_HOST和WORDPRESS_DB_PASSWORD。

好，咱們啓動應用：

# docker-compose up Creating wptest_db_1... Creating wptest_wordpress_1... Attaching to wptest_db_1, wptest_wordpress_1 wordpress_1 | Complete! WordPress has been successfully copied to /var/www/html

就成功了。瀏覽器訪問 http://localhost:8002（或 http://host-ip:8002）便可。

默認是前臺運行並打印日誌到控制檯。若是想後臺運行，能夠：

docker-compose up -d

服務後臺後，可使用下列命令查看狀態：

# docker-compose ps Name Command State Ports ----------------------------------------------------------------------------------- figtest_db_1 docker-entrypoint.sh mysqld Up 3306/tcp figtest_wordpress_1 docker-entrypoint.sh apach ... Up 0.0.0.0:8002->80/tcp # docker-compose logs Attaching to wptest_wordpress_1, wptest_db_1 db_1 | 2016-10-14T14:38:46.498030Z 0 [Warning] TIMESTAMP with implicit DEFAULT value is deprecated. Please use --explicit_defaults_for_timestamp server option (see documentation for more details). db_1 | 2016-10-14T14:38:46.499974Z 0 [Note] mysqld (mysqld 5.7.15) starting as process 1 ... db_1 | 2016-10-14T14:38:46.727191Z 0 [Note] InnoDB: PUNCH HOLE support available 

中止服務：

# docker-compose stop Stopping wptest_wordpress_1... Stopping wptest_db_1...

從新啓動服務：

docker-compose restart

docker-compose.yml參考

每一個docker-compose.yml必須定義image或者build中的一個，其它的是可選的。

image

指定鏡像tag或者ID。示例：

image: redis image: ubuntu:14.04 image: tutum/influxdb image: example-registry.com:4000/postgresql image: a4bc65fd

注意，在version 1裏同時使用image和build是不容許的，version 2則能夠，若是同時指定了二者，會將build出來的鏡像打上名爲image標籤。

build

用來指定一個包含Dockerfile文件的路徑。通常是當前目錄.。Fig將build並生成一個隨機命名的鏡像。

注意，在version 1裏bulid僅支持值爲字符串。version 2裏支持對象格式。

build: ./dir build: context: ./dir dockerfile: Dockerfile-alternate args: buildno: 1

context爲路徑，dockerfile爲須要替換默認docker-compose的文件名，args爲構建(build)過程當中的環境變量，用於替換Dockerfile裏定義的ARG參數，容器中不可用。示例：
Dockerfile:

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

docker-compose.yml:

build:  context: .  args:  buildno: 1  password: secret build:  context: .  args:  - buildno=1  - password=secret

command

用來覆蓋缺省命令。示例：

command: bundle exec thin -p 3000

command也支持數組形式：

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

links

用於連接另外一容器服務，如須要使用到另外一容器的mysql服務。能夠給出服務名和別名；也能夠僅給出服務名，這樣別名將和服務名相同。同docker run --link。示例：

links: - db - db:mysql - redis

使用了別名將自動會在容器的/etc/hosts文件裏建立相應記錄：

172.17.2.186 db 172.17.2.186 mysql 172.17.2.187 redis

因此咱們在容器裏就能夠直接使用別名做爲服務的主機名。

ports

用於暴露端口。同docker run -p。示例：

ports: - "3000" - "8000:8000" - "49100:22" - "127.0.0.1:8001:8001"

expose

expose提供container之間的端口訪問，不會暴露給主機使用。同docker run --expose。

expose: - "3000" - "8000"

volumes

掛載數據卷。同docker run -v。示例：

volumes: - /var/lib/mysql - cache/:/tmp/cache - ~/configs:/etc/configs/:ro

volumes_from

掛載數據卷容器，掛載是容器。同docker run --volumes-from。示例：

volumes_from: - service_name - service_name:ro - container:container_name - container:container_name:rw

container:container_name格式僅支持version 2。

environment

添加環境變量。同docker run -e。能夠是數組或者字典格式：

environment:  RACK_ENV: development  SESSION_SECRET: environment:  - RACK_ENV=development  - SESSION_SECRET

depends_on

用於指定服務依賴，通常是mysql、redis等。
指定了依賴，將會優先於服務建立並啓動依賴。

links也能夠指定依賴。

external_links

連接搭配docker-compose.yml文件或者Compose以外定義的服務，一般是提供共享或公共服務。格式與links類似：

external_links: - redis_1 - project_db_1:mysql - project_db_1:postgresql

注意，external_links連接的服務與當前服務必須是同一個網絡環境。

extra_hosts

添加主機名映射。

extra_hosts: - "somehost:162.242.195.82" - "otherhost:50.31.209.229"

將會在/etc/hosts建立記錄：

162.242.195.82 somehost 50.31.209.229 otherhost

extends

繼承自當前yml文件或者其它文件中定義的服務，能夠選擇性的覆蓋原有配置。

extends: file: common.yml service: webapp

service必須有，file可選。service是須要繼承的服務，例如web、database。

net

設置網絡模式。同docker的--net參數。

net: "bridge" net: "none" net: "container:[name or id]" net: "host"

dns

自定義dns服務器。

dns: 8.8.8.8 dns: - 8.8.8.8 - 9.9.9.9

cpu_shares, cpu_quota, cpuset, domainname, hostname, ipc, mac_address, mem_limit, memswap_limit, privileged, read_only, restart, shm_size, stdin_open, tty, user, working_dir

這些命令都是單個值，含義請參考docker run。

cpu_shares: 73 cpu_quota: 50000 cpuset: 0,1 user: postgresql working_dir: /code domainname: foo.com hostname: foo ipc: host mac_address: 02:42:ac:11:65:43 mem_limit: 1000000000 mem_limit: 128M memswap_limit: 2000000000 privileged: true restart: always read_only: true shm_size: 64M stdin_open: true tty: true

命令行參考

$ docker-compose Define and run multi-container applications with Docker. Usage: docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...] docker-compose -h|--help Options: -f, --file FILE Specify an alternate compose file (default: docker-compose.yml) -p, --project-name NAME Specify an alternate project name (default: directory name) --verbose Show more output -v, --version Print version and exit -H, --host HOST Daemon socket to connect to --tls Use TLS; implied by --tlsverify --tlscacert CA_PATH Trust certs signed only by this CA --tlscert CLIENT_CERT_PATH Path to TLS certificate file --tlskey TLS_KEY_PATH Path to TLS key file --tlsverify Use TLS and verify the remote --skip-hostname-check Don't check the daemon's hostname against the name specified in the client certificate (for example if your docker host is an IP address) Commands: build Build or rebuild services bundle Generate a Docker bundle from the Compose file config Validate and view the compose file create Create services down Stop and remove containers, networks, images, and volumes events Receive real time events from containers exec Execute a command in a running container help Get help on a command kill Kill containers logs View output from containers pause Pause services port Print the public port for a port binding ps List containers pull Pulls service images push Push service images restart Restart services rm Remove stopped containers run Run a one-off command scale Set number of containers for a service start Start services stop Stop services unpause Unpause services up Create and start containers version Show the Docker-Compose version information

批處理腳本

# 關閉全部正在運行容器 docker ps | awk '{print $1}' | xargs docker stop # 刪除全部容器應用 docker ps -a | awk '{print $1}' | xargs docker rm # 或者 docker rm $(docker ps -a -q)