docker container 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"
• 此方法无效：docker exec -it my_container "echo a && echo b"

选项

示例

在正在运行的容器上运行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）

参见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