Docker Compose 指令参考

时间:2020-09-16 12:45:54   收藏:0   阅读:17

Compose 简介

Compose 是用于定义和运行多容器 Docker 应用程序的工具。通过 Compose,您可以使用 YML 文件来配置应用程序需要的所有服务。然后,使用一个命令,就可以从 YML 文件配置中创建并启动所有服务。

YAML教程 https://www.runoob.com/w3cnote/yaml-intro.html  

Compose 使用的三个步骤:

Compose 安装

下载 Docker Compose 的当前稳定版本:

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

要安装其他版本的 Compose,请替换 1.24.1。

将可执行权限应用于二进制文件:

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

创建软链:

 sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose

测试是否安装成功:

 docker-compose --version

cker-compose version 1.24.1, build 4667896b

执行以下命令来启动应用程序: (在docker-compose.yml 文件目录下执行)

docker-compose up -d

yml 配置指令参考

version

指定本 yml 依从的 compose 哪个版本制定的。

build

指定为构建镜像上下文路径:

例如 webapp 服务,指定为从上下文路径 ./dir/Dockerfile 所构建的镜像:

version: "3.7"

services:

  webapp:

    build: ./dir

或者,作为具有在上下文指定的路径的对象,以及可选的 Dockerfile args

version: "3.7"

services:

  webapp:

    build:

      context: ./dir

      dockerfile: Dockerfile-alternate

      args:

        buildno: 1

      labels:

        - "com.example.description=Accounting webapp"

        - "com.example.department=Finance"

        - "com.example.label-with-empty-value"

      target: prod

cap_addcap_drop

添加或删除容器拥有的宿主机的内核功能。

cap_add:

  - ALL # 开启全部权限

 

cap_drop:

  - SYS_PTRACE # 关闭 ptrace权限

cgroup_parent

为容器指定父 cgroup 组,意味着将继承该组的资源限制。

cgroup_parent: m-executor-abcd

command

覆盖容器启动的默认命令。

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

container_name

指定自定义容器名称,而不是生成的默认名称。

container_name: my-web-container

depends_on

设置依赖关系。

version: "3.7"

services:

  web:

    build: .

    depends_on:

      - db

      - redis

  redis:

    image: redis

  db:

    image: postgres

注意:web 服务不会等待 redis db 完全启动 之后才启动。

deploy

指定与服务的部署和运行有关的配置。只在 swarm 模式下才会有用。

version: "3.7"

services:

  redis:

    image: redis:alpine

    deploy:

      modereplicated

      replicas: 6

      endpoint_mode: dnsrr

      labels: 

        description: "This redis service label"

      resources:

        limits:

          cpus: ‘0.50‘

          memory: 50M

        reservations:

          cpus: ‘0.25‘

          memory: 20M

      restart_policy:

        condition: on-failure

        delay: 5s

        max_attempts: 3

        window: 120s

可以选参数:

endpoint_mode:访问集群服务的方式。

endpoint_mode: vip

# Docker 集群服务一个对外的虚拟 ip。所有的请求都会通过这个虚拟 ip 到达集群服务内部的机器。

endpoint_mode: dnsrr

# DNS 轮询(DNSRR)。所有的请求会自动轮询获取到集群 ip 列表中的一个 ip 地址。

labels:在服务上设置标签。可以用容器上的 labels(跟 deploy 同级的配置) 覆盖 deploy 下的 labels

mode:指定服务提供的模式。

 

replicasmode replicated 时,需要使用此参数配置具体运行的节点数量。

resources:配置服务器资源使用的限制,例如上例子,配置 redis 集群运行需要的 cpu 的百分比 和 内存的占用。避免占用资源过高出现异常。

restart_policy:配置如何在退出容器时重新启动容器。

rollback_config:配置在更新失败的情况下应如何回滚服务。

update_config:配置应如何更新服务,对于配置滚动更新很有用。

:仅支持 V3.4 及更高版本。

devices

指定设备映射列表。

devices:

  - "/dev/ttyUSB0:/dev/ttyUSB0"

dns

自定义 DNS 服务器,可以是单个值或列表的多个值。

dns: 8.8.8.8

 

dns:

  - 8.8.8.8

  - 9.9.9.9

dns_search

自定义 DNS 搜索域。可以是单个值或列表。

dns_search: example.com

 

dns_search:

  - dc1.example.com

  - dc2.example.com

entrypoint

覆盖容器默认的 entrypoint

entrypoint: /code/entrypoint.sh

也可以是以下格式:

entrypoint:

    - php

    - -d

    - zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so

    - -d

    - memory_limit=-1

    - vendor/bin/phpunit

env_file

从文件添加环境变量。可以是单个值或列表的多个值。

env_file: .env

也可以是列表格式:

env_file:

  - ./common.env

  - ./apps/web.env

  - /opt/secrets.env

environment

添加环境变量。您可以使用数组或字典、任何布尔值,布尔值需要用引号引起来,以确保 YML 解析器不会将其转换为 True False

environment:

  RACK_ENV: development

  SHOW: ‘true‘

expose

暴露端口,但不映射到宿主机,只被连接的服务访问。

仅可以指定内部端口为参数:

expose:

 - "3000"

 - "8000"

extra_hosts

添加主机名映射。类似 docker client --add-host

extra_hosts:

 - "somehost:162.242.195.82"

 - "otherhost:50.31.209.229"

以上会在此服务的内部容器中 /etc/hosts 创建一个具有 ip 地址和主机名的映射关系:

162.242.195.82  somehost

50.31.209.229   otherhost

healthcheck

用于检测 docker 服务是否健康运行。

healthcheck:

  test: ["CMD", "curl", "-f", "http://localhost"] # 设置检测程序

  interval: 1m30s # 设置检测间隔

  timeout: 10s # 设置检测超时时间

  retries: 3 # 设置重试次数

  start_period: 40s # 启动后,多少秒开始启动检测程序

image

指定容器运行的镜像。以下格式都可以:

image: redis

image: ubuntu:14.04

image: tutum/influxdb

image: example-registry.com:4000/postgresql

image: a4bc65fd # 镜像id

logging

服务的日志记录配置。

driver:指定服务容器的日志记录驱动程序,默认值为json-file。有以下三个选项

driver: "json-file"

driver: "syslog"

driver: "none"

仅在 json-file 驱动程序下,可以使用以下参数,限制日志得数量和大小。

logging:

  driver: json-file

  options:

    max-size: "200k" # 单个文件大小为200k

    max-file: "10" # 最多10个文件

当达到文件限制上限,会自动删除旧得文件。

syslog 驱动程序下,可以使用 syslog-address 指定日志接收地址。

logging:

  driver: syslog

  options:

    syslog-address: "tcp://192.168.0.42:123"

network_mode

设置网络模式。

network_mode: "bridge"

network_mode: "host"

network_mode: "none"

network_mode: "service:[service name]"

network_mode: "container:[container name/id]"

networks

配置容器连接的网络,引用顶级 networks 下的条目 。

services:

  some-service:

    networks:

      some-network:

        aliases:

         - alias1

      other-network:

        aliases:

         - alias2

networks:

  some-network:

    # Use a custom driver

    driver: custom-driver-1

  other-network:

    # Use a custom driver which takes special options

    driver: custom-driver-2

aliases :同一网络上的其他容器可以使用服务名称或此别名来连接到对应容器的服务。

restart

restart: "no"

restart: always

restart: on-failure

restart: unless-stopped

注:swarm 集群模式,请改用 restart_policy

secrets

存储敏感数据,例如密码:

version: "3.1"

services:

 

mysql:

  image: mysql

  environment:

    MYSQL_ROOT_PASSWORD_FILE: /run/secrets/my_secret

  secrets:

    - my_secret

 

secrets:

  my_secret:

    file: ./my_secret.txt

security_opt

修改容器默认的 schema 标签。

security-opt

  - label:user:USER   # 设置容器的用户标签

  - label:role:ROLE   # 设置容器的角色标签

  - label:type:TYPE   # 设置容器的安全策略标签

  - label:level:LEVEL  # 设置容器的安全等级标签

stop_grace_period

指定在容器无法处理 SIGTERM (或者任何 stop_signal 的信号),等待多久后发送 SIGKILL 信号关闭容器。

stop_grace_period: 1s # 等待 1

stop_grace_period: 1m30s # 等待 1 30

默认的等待时间是 10 秒。

stop_signal

设置停止容器的替代信号。默认情况下使用 SIGTERM

以下示例,使用 SIGUSR1 替代信号 SIGTERM 来停止容器。

stop_signal: SIGUSR1

sysctls

设置容器中的内核参数,可以使用数组或字典格式。

sysctls:

  net.core.somaxconn: 1024

  net.ipv4.tcp_syncookies: 0

 

sysctls:

  - net.core.somaxconn=1024

  - net.ipv4.tcp_syncookies=0

tmpfs

在容器内安装一个临时文件系统。可以是单个值或列表的多个值。

tmpfs: /run

 

tmpfs:

  - /run

  - /tmp

ulimits

覆盖容器默认的 ulimit

ulimits:

  nproc: 65535

  nofile:

    soft: 20000

    hard: 40000

volumes

将主机的数据卷或着文件挂载到容器里。

version: "3.7"

services:

  db:

    image: postgres:latest

    volumes:

      - "/localhost/postgres.sock:/var/run/postgres/postgres.sock"

      - "/localhost/data:/var/lib/postgresql/data"

 

评论(0
© 2014 mamicode.com 版权所有 京ICP备13008772号-2
迷上了代码!