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

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

选项