docker compose run

描述

针对一个服务运行一次性命令。

以下命令启动 web 服务并以 bash 作为其命令

$ docker compose run web bash

使用 run 运行的命令会在新容器中启动，其配置由该服务的配置定义，包括卷、链接和其他详细信息。然而，有两个重要的区别

首先，`run` 传递的命令会覆盖服务配置中定义的命令。例如，如果 `web` 服务配置以 `bash` 启动，那么 `docker compose run web python app.py` 会将其覆盖为 `python app.py`。

第二个区别是 `docker compose run` 命令不会创建服务配置中指定的任何端口。这可以防止与已打开的端口发生冲突。如果您确实希望创建服务的端口并映射到主机，请指定 `--service-ports`

$ docker compose run --service-ports web python manage.py shell

或者，可以使用 `--publish` 或 `-p` 选项手动指定端口映射，就像使用 docker run 时一样

$ docker compose run --publish 8080:80 -p 2022:22 -p 127.0.0.1:2021:21 web python manage.py shell

如果您启动一个配置了链接的服务，run 命令会首先检查链接的服务是否正在运行，如果已停止则会启动该服务。所有链接的服务运行后，run 会执行您传递的命令。例如，您可以运行

$ docker compose run db psql -h db -U docker

这会为链接的 `db` 容器打开一个交互式 PostgreSQL shell。

如果您不希望 run 命令启动链接的容器，请使用 `--no-deps` 标志

$ docker compose run --no-deps web python manage.py shell

如果您想在运行后移除容器，同时覆盖容器的重启策略，请使用 `--rm` 标志

$ docker compose run --rm web python manage.py db upgrade

这会运行一个数据库升级脚本，并在运行完成后移除容器，即使服务配置中指定了重启策略也是如此。

选项