切换语言

docker 容器创建

描述创建新容器
用法docker container create [OPTIONS] IMAGE [COMMAND] [ARG...]
别名
docker create

描述

（或简写：） 命令创建一个 new 容器，而无需启动它。docker container createdocker create

创建容器时，Docker 守护程序会创建一个可写容器层 并准备运行指定命令。这 然后将容器 ID 打印到 。这与 except the container is never started 类似。然后，您可以使用 （或简写： ） 命令在任何点启动容器。STDOUTdocker run -ddocker container startdocker start

当您想要提前设置容器配置时，这非常有用 以便在需要时随时启动。的 new container 为 。created

该命令与该命令共享其大部分选项（该命令在启动之前执行 a）。 请参阅 docker run CLI 参考 有关可用标志和选项的详细信息。docker createdocker rundocker create

选项

选择违约描述
--add-host添加自定义主机到 IP 映射 （host：ip）
--annotationAPI 1.43+向容器添加注释（传递到 OCI 运行时）
-a, --attach连接到 STDIN、STDOUT 或 STDERR
--blkio-weight块 IO （相对权重），介于 10 和 1000 之间，或 0 表示禁用（默认为 0）
--blkio-weight-device块 IO 权重（相对设备权重）
--cap-add添加 Linux 功能
--cap-drop丢弃 Linux 功能
--cgroup-parent容器的可选父 cgroup
--cgroupnsAPI 1.41+要使用的 cgroup 命名空间 （host|private）
'host'： 在 Docker 主机的 cgroup 命名空间
中运行容器'private'： 在其自己的私有 cgroup 命名空间
中运行容器''： 使用守护进程上
default-cgroupns-mode 选项配置的 cgroup 命名空间（默认）
--cidfile将容器 ID 写入文件
--cpu-countCPU 计数（仅限 Windows）
--cpu-percentCPU 百分比（仅限 Windows）
--cpu-period限制 CPU CFS （Completely Fair Scheduler） 周期
--cpu-quota限制 CPU CFS （Completely Fair Scheduler） 配额
--cpu-rt-periodAPI 1.25+限制 CPU 实时周期（以微秒为单位）
--cpu-rt-runtimeAPI 1.25+限制 CPU 实时运行时间（以微秒为单位）
-c, --cpu-sharesCPU 份额（相对权重）
--cpusAPI 1.25+CPU 数量
--cpuset-cpus允许执行的 CPU （0-3， 0,1）
--cpuset-mems允许在其中执行的 MEM （0-3， 0,1）
--device将主机设备添加到容器
--device-cgroup-rule向 cgroup 允许的设备列表添加规则
--device-read-bps限制设备读取速率（每秒字节数）
--device-read-iops限制设备读取速率（每秒 IO）
--device-write-bps限制设备的写入速率 （每秒字节数）
--device-write-iops限制设备的写入速率（每秒 IO）
--disable-content-trusttrue跳过镜像验证
--dns设置自定义 DNS 服务器
--dns-option设置 DNS 选项
--dns-search设置自定义 DNS 搜索域
--domainname容器 NIS 域名
--entrypoint覆盖镜像的默认 ENTRYPOINT
-e, --env设置环境变量
--env-file读入环境变量文件
--expose公开一个端口或一系列端口
--gpusAPI 1.40+要添加到容器的 GPU 设备（'all' 传递所有 GPU）
--group-add添加其他群组以加入
--health-cmd运行以检查运行状况的命令
--health-interval运行检查之间的时间 （ms|s|m|h）（默认为 0s）
--health-retries报告运行状况不佳所需的连续失败
--health-start-interval接口 1.44+在开始时段运行检查之间的时间 （ms|s|m|h）（默认为 0s）
--health-start-periodAPI 1.29+容器在开始运行状况重试倒计时之前要初始化的开始时间 （ms|s|m|h）（默认为 0s）
--health-timeout允许运行一项检查的最长时间 （ms|s|m|h）（默认为 0s）
--help打印使用情况
-h, --hostname容器主机名
--initAPI 1.25+在容器内运行一个 init，用于转发 signals 和 reaps 进程
-i, --interactive即使未连接，也请保持 STDIN 打开
--io-maxbandwidth系统驱动器的最大 IO 带宽限制（仅限 Windows）
--io-maxiops系统驱动器的最大 IOps 限制（仅限 Windows）
--ipIPv4 地址（例如，172.30.100.104）
--ip6IPv6 地址（例如，2001：db8：：33）
--ipc要使用的 IPC 模式
--isolation容器隔离技术
--kernel-memory内核内存限制
-l, --label在容器上设置元数据
--label-file读取标签的行分隔文件
--link向另一个容器添加链接
--link-local-ip容器 IPv4/IPv6 链接本地地址
--log-driver容器的日志记录驱动程序
--log-opt日志驱动程序选项
--mac-address容器 MAC 地址（例如，92：d0：c6：0a：29：33）
-m, --memory内存限制
--memory-reservation内存软限制
--memory-swap交换限制等于内存加上交换：“-1”，用于启用无限交换
--memory-swappiness-1优化容器内存交换性（0 到 100）
--mount将文件系统挂载附加到容器
--name为容器分配名称
--network将容器连接到网络
--network-alias为容器添加网络范围的别名
--no-healthcheck禁用任何容器指定的 HEALTHCHECK
--oom-kill-disable禁用 OOM Killer
--oom-score-adj调整主机的 OOM 首选项（-1000 到 1000）
--pid要使用的 PID 命名空间
--pids-limit调整容器 pids 限制（设置为 -1 表示无限制）
--platform接口 1.32+如果服务器支持多平台，则设置 platform
--privileged为此容器授予扩展权限
-p, --publish将容器的端口发布到主机
-P, --publish-all将所有公开的端口发布到随机端口
--pullmissing在创建 （、 、always|missingnever)
-q, --quietSuppress the pull 输出
--read-only以只读方式挂载容器的根文件系统
--restartno容器退出时要应用的重启策略
--rm容器退出时自动删除容器及其关联的匿名卷
--runtime用于此容器的运行时
--security-opt安全选项
--shm-size/dev/shm 的大小
--stop-signal停止容器的信号
--stop-timeoutAPI 1.25+停止容器的超时 （秒）
--storage-opt容器的存储驱动程序选项
--sysctlSysctl 选项
--tmpfs挂载 tmpfs 目录
-t, --tty分配伪 TTY
--ulimitUlimit 选项
-u, --user用户名或 UID （格式： <name|uid>[：<group|gid>]）
--userns要使用的用户命名空间
--uts要使用的 UTS 命名空间
-v, --volume绑定挂载卷
--volume-driver容器的可选卷驱动程序
--volumes-from从指定的容器挂载卷
-w, --workdir容器内的工作目录

例子

创建并启动容器

以下示例创建一个附加了伪 TTY 的交互式容器 然后启动容器并附加到它：

$ docker container create -i -t --name mycontainer alpine
6d8af538ec541dd581ebc2a24153a28329acb5268abe5ef868c1f1a261221752

$ docker container start --attach -i mycontainer
/ # echo hello world
hello world

以上相当于 a ：docker run

$ docker run -it --name mycontainer2 alpine
/ # echo hello world
hello world

初始化卷

容器卷在阶段中初始化 （即，也是）。例如，这允许您访问卷容器，然后从另一个容器中使用它：docker createdocker runcreatedata

$ docker create -v /data --name data ubuntu

240633dfbb98128fa77473d3d9018f6123b99c454b3251427ae190a7d951ad57

$ docker run --rm --volumes-from data ubuntu ls -la /data

total 8
drwxr-xr-x  2 root root 4096 Dec  5 04:10 .
drwxr-xr-x 48 root root 4096 Dec  5 04:11 ..

同样，主机目录绑定挂载的卷容器，该容器可以 然后从后续容器中使用：create

$ docker create -v /home/docker:/docker --name docker ubuntu

9aa88c08f319cd1e4515c3c46b0de7cc9aa75e878357b1e96f91e2c773029f03

$ docker run --rm --volumes-from docker ubuntu ls -la /docker

total 20
drwxr-sr-x  5 1000 staff  180 Dec  5 04:00 .
drwxr-xr-x 48 root root  4096 Dec  5 04:13 ..
-rw-rw-r--  1 1000 staff 3833 Dec  5 04:01 .ash_history
-rw-r--r--  1 1000 staff  446 Nov 28 11:51 .ashrc
-rw-r--r--  1 1000 staff   25 Dec  5 04:00 .gitconfig
drwxr-sr-x  3 1000 staff   60 Dec  1 03:28 .local
-rw-r--r--  1 1000 staff  920 Nov 28 11:51 .profile
drwx--S---  2 1000 staff  460 Dec  5 00:51 .ssh
drwxr-xr-x 32 1000 staff 1140 Dec  5 04:01 docker