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

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

选项