docker-compose命令

帮助文档

docker@default:~$ docker-compose --help

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
  --log-level LEVEL           Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  --no-ansi                   Do not print ANSI control characters
  -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
  --project-directory PATH    Specify an alternate working directory
                              (default: the path of the Compose file)
  --compatibility             If set, Compose will attempt to convert keys
                              in v3 files to their non-Swarm equivalent

Commands:
  build              构建或重建服务
  bundle             从compose配置文件中产生一个docker绑定
  config             验证并查看compose配置文件
  create             创建服务
  down               停止并移除容器、网络、镜像和数据卷
  events             从容器中接收实时的事件
  exec               在一个运行中的容器上执行一个命令
  help               获取命令的帮助信息
  images             列出所有镜像
  kill               通过发送SIGKILL信号来停止指定服务的容器
  logs               从容器中查看服务日志输出
  pause              暂停服务
  port               打印绑定的公共端口
  ps                 列出所有运行中的容器
  pull               拉取并下载指定服务镜像
  push               Push service images
  restart            重启YAML文件中定义的服务
  rm                 删除指定已经停止服务的容器
  run                在一个服务上执行一条命令
  scale              设置指定服务运行容器的个数
  start              在容器中启动指定服务
  stop               停止已运行的服务
  top                显示各个服务容器内运行的进程
  unpause            恢复容器服务
  up                 创建并启动容器
  version            显示Docker-Compose版本信息

命令解析

docker-compose

docker-compose [-f <args>...] [options] [COMMAND] [ARGS...]

命令选项[-f <args>...]

• -f, --file FILE 指定Compose模板文件，默认为docker-compose.yml可多次指定。

$ docker-compose -f docker-compose.yml up -d

• -p, --project-name NAME 指定项目名称，默认使用当前所在目录名称作为项目名称。
• -x-network-driver 使用Docker可拔插网络后端特性，需Docker1.9+版本支持。
• -x-network-driver DRIVER 指定网络后端驱动，默认为bridge，需Docker1.9+版本支持。
• -verbose 输出更多调试信息
• -v, --version 打印版本并退出

docker-compose up

启动所有服务

docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...]

命令选项[options]

• -d 指定在后台以守护进程方式运行服务容器
• -no-color 设置不使用颜色来区分不同的服务器的控制输出
• -no-deps 设置不启动服务所链接的容器
• -force-recreate 设置强制重新创建容器，不能与--no-recreate选项同时使用。
• --no-create 若容器已经存在则不再重新创建，不能与--force-recreate选项同时使用。
• --no-build 设置不自动构建缺失的服务镜像
• --build 设置在启动容器前构建服务镜像
• --abort-on-container-exit 若任何一个容器被停止则停止所有容器，不能与选项-d同时使用。
• -t, --timeout TIMEOUT 设置停止容器时的超时秒数，默认为10秒。
• --remove-orphans 设置删除服务中没有在compose文件中定义的容器
• --scale SERVICE=NUM 设置服务运行容器的个数，此选项将会负载在compose中通过scale指定的参数。

docker-compose ps

列出项目中当前的所有容器

docker-compose ps [options] [SERVICE...]

docker@default:~$ docker-compose ps
ERROR:
        Can't find a suitable configuration file in this directory or any
        parent. Are you in the right directory?

        Supported filenames: docker-compose.yml, docker-compose.yaml

docker@default:~$ docker-compose ps
    Name         Command    State    Ports
------------------------------------------
swoft_swoft_1   /bin/bash   Exit 0

docker-compose -h

查看docker-compose帮助

docker-compose down

停止和删除容器、网络、卷、镜像

docker-compose down [options]

命令选项 [options]

• --rmi type 删除镜像类型，类型可选：
  • --rmi all 删除compose文件中定义的所有镜像
  • --rmi local 删除镜像名为空的镜像
• -v, --volumes 删除已经在compose文件中定义的和匿名的附在容器上的数据卷
• --remove-orphans 删除服务中没有在compose中定义的容器

docker-compose logs

查看服务容器的输出，默认情况下docker-compose将对不同的服务输出使用不同的颜色来区分。可以通过--no-color来关闭颜色。

docker-compose logs [options] [SERVICE...]

例如：

root@default:/var/www/swoft# docker-compose logs
Attaching to swoft_swoft_1
swoft_1  | root@cd054651dfcb:/var/www/swoft# exit

docker-compose build

构建或重构项目中的服务容器，服务容器一旦构建后将会带上一个标记名称，可以随时在项目目录下运行docker-compose build来重新构建服务。

docker-compose build [options] [--build-arg key=val...] [SERVICE...]

docker-compose pull [options] [SERVICE...]

docker-compose restart [options] [SERVICE...]

docker-compose rm [options] [SERVICE...]

docker-compose start [SERVICE...]

docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]

$ docker-compose run ubuntu ping www.baidu.com -c 10

docker-compose scale

$ docker-compoose scale web=3 db=2

docker-compose pause [SERVICE...]

docker-compose kill [options] [SERVICE...]

$ docker-compose kill -s SIGINT

docker-compose config [options]

root@default:/var/www/swoft# docker-compose config
services:
  swoft:
    entrypoint:
    - /bin/bash
    image: swoft/swoft:latest
    ports:
    - 83:83/tcp
    privileged: true
    stdin_open: true
    tty: true
    volumes:
    - /share/swoft:/var/www/swoft:rw
version: '3.0'

docker-compose create [options] [SERVICE...]

docker-compose exec [options] SERVICE COMMAND [ARGS...]

$ docker-compose exec --index=1 web /bin/bash

docker-compose port [options] SERVICE PRIVATE_PORT

docker-compose push [options] [SERVICE...]

docker-compose stop [options] [SERVICE...]

docker-compose unpause [SERVICE...]

root@default:/var/www/swoft# docker-compose version
docker-compose version 1.24.0, build 0aa59064
docker-py version: 3.7.2
CPython version: 3.6.8
OpenSSL version: OpenSSL 1.1.0j  20 Nov 2018