docker 撰写运行
描述 | 在服务上运行一次性命令 |
---|---|
用法 | docker compose run [OPTIONS] SERVICE [COMMAND] [ARGS...] |
描述
针对服务运行一次性命令。
以下命令启动该服务并按照其命令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 命令首先检查链接的服务是否正在运行,如果停止则启动该服务。一旦所有链接的服务都运行起来,运行就会执行您传递给它的命令。例如,您可以运行:
$ docker compose run db psql -h db -U docker
这将为链接的容器打开一个交互式 PostgreSQL shell db
。
如果您不希望 run 命令启动链接的容器,请使用以下--no-deps
标志:
$ docker compose run --no-deps web python manage.py shell
如果您想在运行后删除容器并覆盖容器的重新启动策略,请使用以下标志--rm
:
$ docker compose run --rm web python manage.py db upgrade
这会运行数据库升级脚本,并在运行完成后删除容器,即使在服务配置中指定了重新启动策略也是如此。
选项
选项 | 默认 | 描述 |
---|---|---|
--build | 启动容器之前构建镜像 | |
--cap-add | 添加 Linux 功能 | |
--cap-drop | 放弃 Linux 功能 | |
-d, --detach | 在后台运行容器并打印容器ID | |
--entrypoint | 覆盖图像的入口点 | |
-e, --env | 设置环境变量 | |
-i, --interactive | true | 即使未连接,也保持 STDIN 打开 |
-l, --label | 添加或覆盖标签 | |
--name | 为容器指定名称 | |
-T, --no-TTY | true | 禁用伪 TTY 分配(默认:自动检测) |
--no-deps | 不要启动链接服务 | |
-p, --publish | 将容器的端口发布到主机 | |
--quiet-pull | 拉取而不打印进度信息 | |
--remove-orphans | 删除 Compose 文件中未定义的服务的容器 | |
--rm | 容器退出时自动移除 | |
-P, --service-ports | 在启用所有服务端口并将其映射到主机的情况下运行命令 | |
--use-aliases | 使用容器连接到的网络中的服务网络 useAliases | |
-u, --user | 以指定的用户名或uid运行 | |
-v, --volume | 绑定挂载卷 | |
-w, --workdir | 容器内的工作目录 |