Docker - docker-compose常用命令

docker-compose --help

$ 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)
  -c, --context NAME          Specify a context 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 (DEPRECATED)
  --env-file PATH             Specify an alternate environment file

Commands:
  build              Build or rebuild services
  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
  images             List images
  kill               Kill containers
  logs               View output from containers
  pause              Pause services
  port               Print the public port for a port binding
  ps                 List containers
  pull               Pull 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
  top                Display the running processes
  unpause            Unpause services
  up                 Create and start containers
  version            Show version information and quit

 

命令解析

docker-compose

docker-compose [-f …] [options] [COMMAND] [ARGS…]

命令选项[options]

• -f, --file FILE 指定Compose模板文件，默认为docker-compose.yml可多次指定。
• -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-compose ps
    Name         Command    State    Ports
------------------------------------------
abp/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…]

 

 

docker-compose build

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

命令选项[options]

• –compress 通过gzip压缩构建上下文环境
• –force-rm 删除构建过程中的临时容器
• –no-cache 构建镜像过程中不使用缓存
• –pull 始终尝试通过拉取操作来获取更新版本的镜像
• -m, --memory MEM为构建的容器设置内存大小
• –build-arg key=val 为服务设置build-time变量

 

docker-compose pull

拉取服务依赖的镜像
docker-compose pull [options] [SERVICE…]

命令选项[options]

• –ignore-pull-failures 忽略拉取镜像过程中的错误
• –parallel 同时拉取多个镜像
• –quiet 拉取镜像过程中不打印进度信息

 

docker-compose restart

重启项目中的服务
docker-compose restart [options] [SERVICE…]

命令选项[options]

• -t, --timeout TIMEOUT指定重启前停止容器的超时时长，默认为10秒。

 

docker-compose rm

删除所有停止状态的服务容器，推荐先执行docker-compose stop命令来停止容器。
docker-compose rm [options] [SERVICE…]

命令选项[options]

• -f, --force 强制直接删除包含非停止状态的容器
• -v 删除容器所挂载的数据卷

 

docker-compose start

启动已经存在的服务容器
docker-compose start [SERVICE…]

 

docker-compose run

在指定服务上执行一条命令
docker-compose run [options] [-v VOLUME…] [-p PORT…] [-e KEY=VAL…] SERVICE [COMMAND] [ARGS…]

例如：在test容器上运行ping命令10次

$ docker-compose run testping www.baidu.com -c 10

 

docker-compose scale

设置指定服务运行的容器个数，通过service=num参数设置服务数量。
docker-compose scale

例如：

$ docker-compoose scale web=3 db=2

 

docker-compose pause

暂停一个服务容器
docker-compose pause [SERVICE…]

docker-compose kill

发送SIGKILL信号来强制停止服务容器，支持通过-s参数来指定发送的信号。
docker-compose kill [options] [SERVICE…]

例如：发送SIGINT信号强制停止服务容器

$ docker-compose kill -s SIGINT

 

docker-compose config

验证并查看compose文件配置
docker-compose config [options]

选项参数[options]

• –resolve-image-digests 将镜像标签标记为摘要
• -q, --quiet 只验证配置不输出，当配置正确时不输出任何容器，当配置错误时输出错误信息。
• –services 打印服务名称，一行显示一个。
• –volumes 打印数据卷名称，一行显示一个。

例如：

$ docker-compose config
services:
  nginx:
    entrypoint:
    - /bin/bash
    image: nginx/nginx
    ports:
    - 83:83/tcp
    privileged: true
    stdin_open: true
    tty: true
    volumes:
    - /share/nginx:/var/www/nginx
version: '3.0'

 

docker-compose create

为服务创建容器
docker-compose create [options] [SERVICE…]

选项说明[options]

• –force-recreate 重新创建容器，即使配置和镜像没有改变，不兼容–no-recreate参数。
• –no-recreate 如果容器已经存在则无需重新创建，不兼容–force-recreate参数。
• –no-build 不创建镜像即使缺失
• –build 创建容器前生成镜像

docker-compose exec

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

选项参数[options]

• -d 分离模式，以后台守护进程运行命令。
• –privileged 获取特权
• -T 禁用分配TTY，默认docker-compose exec分配TTY。
• –index=index 当一个服务拥有多个容器时可通过该参数登录到该服务下的任何服务

例如：

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

 

docker-compose port

显示某个容器端口所映射的公共端口
docker-compose port [options] SERVICE PRIVATE_PORT

选项参数[options]

• –protocol=proto 指定端口协议，默认为TCP，可选UDP。
• –index=index 若同意服务存在多个容器，指定命令对象容器的索引序号，默认为1。

docker-compose push

推送服务依赖的镜像
docker-compose push [options] [SERVICE…]

选项参数[options]

• –ignore-push-failure 忽略推送镜像过程中的错误

docker-compose stop

显示各个容器运行的进程情况
docker-compose stop [options] [SERVICE…]

docker-compose unpause

恢复处于暂停状态中的服务
docker-compose unpause [SERVICE…]

docker-compose version

打印Docker Compose版本信息

$ docker-compose version
docker-compose version 1.27.4, build 40524192
docker-py version: 4.3.1
CPython version: 3.7.4
OpenSSL version: OpenSSL 1.1.1c  28 May 2019