docker container exec

描述在运行中的容器内执行命令
用法docker container exec [OPTIONS] CONTAINER COMMAND [ARG...]
别名
docker exec

介绍 Docker Debug

要轻松进入任何容器获取调试 shell,请使用 docker debug。Docker Debug 是使用 docker exec 进行调试的替代方案。借助它,您可以在任何容器或镜像中获取 shell,甚至是精简镜像,而无需进行修改。此外,您还可以在其可自定义的工具箱中携带您喜欢的调试工具。

探索 Docker Debug

描述

docker exec 命令在正在运行的容器中运行一个新命令。

您使用 docker exec 指定的命令仅在容器的主进程 (PID 1) 运行时运行,并且如果容器重启,该命令不会重启。

该命令在容器的默认工作目录中运行。

命令必须是可执行的。链式命令或引号括起来的命令不起作用。

  • 这有效: docker exec -it my_container sh -c "echo a && echo b"

选项

选项默认描述
-d, --detach分离模式:在后台运行命令
--detach-keys覆盖用于分离容器的按键序列
-e, --envAPI 1.25+ 设置环境变量
--env-fileAPI 1.25+ 读取环境变量文件
-i, --interactive即使未附加也保持 STDIN 打开
--privileged为命令授予扩展权限
-t, --tty分配伪终端
-u, --user用户名或 UID(格式:<name|uid>[:<group|gid>]
-w, --workdirAPI 1.35+ 容器内的工作目录

示例

在运行中的容器上运行 docker exec

首先,启动一个容器。

$ docker run --name mycontainer -d -i -t alpine /bin/sh

这将创建并启动一个名为 mycontainer 的容器,该容器基于 alpine 镜像,并以 sh shell 作为其主进程。-d 选项(--detach 的简写)将容器设置为在后台以分离模式运行,并连接一个伪 TTY(-t)。设置 -i 选项是为了保持 STDIN 的连接状态(-i),这可以防止 sh 进程立即退出。

接下来,在容器上执行命令。

$ docker exec -d mycontainer touch /tmp/execWorks

这会在后台的运行容器 mycontainer 中创建一个新文件 /tmp/execWorks

接下来,在容器上执行一个交互式 sh shell。

$ docker exec -it mycontainer sh

这将在容器 mycontainer 中启动一个新的 shell 会话。

为 exec 进程设置环境变量 (--env, -e)

接下来,在当前的 bash 会话中设置环境变量。

docker exec 命令继承了创建容器时设置的环境变量。使用 --env(或 -e 简写)覆盖全局环境变量,或为由 docker exec 启动的进程设置额外的环境变量。

下面的示例在容器 mycontainer 中创建一个新的 shell 会话, 其中环境变量 $VAR_A 设置为 1$VAR_B 设置为 2。 这些环境变量仅对该 docker exec 命令启动的 sh 进程有效, 对容器内运行的其他进程不可用。

$ docker exec -e VAR_A=1 -e VAR_B=2 mycontainer env
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
HOSTNAME=f64a4851eb71
VAR_A=1
VAR_B=2
HOME=/root

提升容器权限 (--privileged)

See docker run --privileged.

为 exec 进程设置工作目录 (--workdir, -w)

默认情况下,docker exec 命令在创建容器时设置的相同工作目录中运行。

$ docker exec -it mycontainer pwd
/

您可以使用 --workdir 选项(或 -w 简写)为要执行的命令指定一个替代工作目录:

$ docker exec -it -w /root mycontainer pwd
/root

尝试在暂停的容器上运行 docker exec

如果容器被暂停,则 docker exec 命令将失败并报错:

$ docker pause mycontainer
mycontainer

$ docker ps

CONTAINER ID   IMAGE     COMMAND     CREATED          STATUS                   PORTS     NAMES
482efdf39fac   alpine    "/bin/sh"   17 seconds ago   Up 16 seconds (Paused)             mycontainer

$ docker exec mycontainer sh

Error response from daemon: Container mycontainer is paused, unpause the container before exec

$ echo $?
1