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, --env | API 1.25+ 设置环境变量 | |
--env-file | API 1.25+ 读取环境变量文件 | |
-i, --interactive | 即使未附加也保持 STDIN 打开 | |
--privileged | 为命令授予扩展权限 | |
-t, --tty | 分配伪终端 | |
-u, --user | 用户名或 UID(格式:<name|uid>[:<group|gid>]) | |
-w, --workdir | API 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)
为 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