对于 Compose 来说，大部分命令的对象既可以是项目本身，也可以指定为项目中的服务或者容器。如果没有特别的说明，命令对象将是项目，这意味着项目中所有的服务都会受到命令影响。

执行 docker-compose [COMMAND] —help 或者 docker-compose help [COMMAND] 可以查看具体某个命令的使用格式。

Compose 命令的基本的使用格式是
docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令选项

  • -f, —file FILE 指定使用的 Compose 模板文件，默认为 docker-compose.yml，可以多次指定。
  • -p, —project-name NAME 指定项目名称，默认将使用所在目录名称作为项目名。
  • —x-networking 使用 Docker 的可拔插网络后端特性（需要 Docker 1.9 及以后版本）。
  • —x-network-driver DRIVER 指定网络后端的驱动，默认为 bridge（需要 Docker 1.9 及以后版本）。
  • —verbose 输出更多调试信息。

  • -v, —version 打印版本并退出。

    build

    格式为 docker-compose build [options] [SERVICE...]。
    构建（重新构建）项目中的服务容器。
    服务容器一旦构建后，将会带上一个标记名，例如对于 web 项目中的一个 db 容器，可能是 web_db。
    可以随时在项目目录下运行 docker-compose build 来重新构建服务。
    选项包括：

  • —force-rm 删除构建过程中的临时容器。

  • —no-cache 构建镜像过程中不使用 cache（这将加长构建过程）。
  • —pull 始终尝试通过 pull 来获取更新版本的镜像。

    一、up 常用

    1. docker-compose up [options] [SERVICE...]

:::info 默认情况，如果服务容器已经存在，docker-compose up 将会尝试停止容器，然后重新创建（保持使用 volumes-from 挂载的卷），以保证新启动的服务匹配 docker-compose.yml 文件的最新内容。如果用户不希望容器被停止并重新创建，可以使用 docker-compose up --no-recreate。这样将只会启动处于停止状态的容器，而忽略已经运行的服务。如果用户只想重新部署某个服务，可以使用 docker-compose up --no-deps -d <SERVICE_NAME> 来重新创建服务并后台停止旧服务，启动新服务，并不会影响到其所依赖的服务。 :::

services 可以选择只启动一个服务，默认启动所有的服务

参数说明：

  • -d：在后台运行服务容器。
  • —no-color： 不使用颜色来区分不同的服务的控制台输出。
  • —no-deps： 不启动服务所链接的容器。
  • —force-recreate： 强制重新创建容器，不能与 --no-recreate 同时使用。
  • —no-recreate： 如果容器已经存在了，则不重新创建，不能与 --force-recreate 同时使用。
  • —no-build： 不自动构建缺失的服务镜像。
  • -t, —timeout TIMEOUT： 停止容器时候的超时（默认为 10 秒）。

二、top

  1. docker-compose top [SERVICE...]

:::info 查看服务容器中的进程 :::

services 可以选择只启动一个服务，默认启动所有的服务

三、stop

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

:::info 停止已经处于运行状态的容器，但不删除它 :::

参数说明：

  • -t, —timeout TIMEOUT： 停止容器时候的超时（默认为 10 秒）。

四、start

  1. docker-compose start [SERVICE...]

:::info 启动已经存在的服务容器。 :::

五、scale

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

:::info 设置指定服务运行的容器个数。 :::

  1. docker-compose scale web=3 job=2

参数说明：

  • -t, —timeout TIMEOUT： 停止容器时候的超时（默认为 10 秒）。

六、run

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

:::info 在指定服务上执行一个命令。 :::

参数说明：

  • -d： 后台运行容器。
  • —name： NAME 为容器指定一个名字。
  • —entrypoint： CMD 覆盖默认的容器启动指令。
  • -e KEY=VAL： 设置环境变量值，可多次使用选项来设置多个环境变量。
  • -u, —user=””： 指定运行容器的用户名或者 uid。
  • —no-deps： 不自动启动关联的服务容器。
  • —rm： 运行命令后自动删除容器，d 模式下将忽略。
  • -p, —publish=[]： 映射容器端口到本地主机。
  • —service-ports： 配置服务端口并映射到本地主机。
  • -T： 不分配伪 tty，意味着依赖 tty 的指令将无法运行。

七、down

  1. docker-compose down

:::info 此命令将会停止 up 命令所启动的容器，并移除网络 :::

八、images 常用

  1. docker-compose images

:::info 列出 Compose 文件中包含的镜像。 :::

九、logs

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

:::info 查看容器的日志 :::

参数说明：

  • -f：跟踪日志输出
  • -t：显示时间
  • —tail=”num”：显示最后的多少行日志

十、ps

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

:::info 列出项目中目前的所有容器。 :::

参数说明：

  • -q： 只打印容器的 ID 信息。

十一、restart

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

:::info 重启服务 :::

十二、rm

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

:::info 删除容器 :::

参数说明：

  • -f, —force： 强制直接删除，包括非停止状态的容器。一般尽量不要使用该选项。
  • -v： 删除容器所挂载的数据卷。