在本章介绍 Docker 命令。
Quick Guide
容器生命周期管理
run
docker run :创建一个新的容器并运行一个命令
1 | docker run [OPTIONS] IMAGE [COMMAND] [ARG...] |
OPTIONS说明:
- -a stdin: 指定标准输入输出内容类型,可选 STDIN/STDOUT/STDERR 三项;
- -d: 后台运行容器,并返回容器ID;
- -i: 以交互模式运行容器,通常与 -t 同时使用;
- -P: 随机端口映射,容器内部端口随机映射到主机的端口
- -p: 指定端口映射,格式为:主机(宿主)端口:容器端口
- -t: 为容器重新分配一个伪输入终端,通常与 -i 同时使用;
- –name=”nginx-lb”: 为容器指定一个名称;
- –dns 8.8.8.8: 指定容器使用的DNS服务器,默认和宿主一致;
- –dns-search example.com: 指定容器DNS搜索域名,默认和宿主一致;
- -h “mars”: 指定容器的hostname;
- -e username=”ritchie”: 设置环境变量;
- –env-file=[]: 从指定文件读入环境变量;
- –cpuset=”0-2” or –cpuset=”0,1,2”: 绑定容器到指定CPU运行;
- -m : 设置容器使用内存最大值;
- –net=”bridge”: 指定容器的网络连接类型,支持 bridge/host/none/container: 四种类型;
- –link=[]: 添加链接到另一个容器;
- –expose=[]: 开放一个端口或一组端口;
- –volume , -v: 绑定一个卷
1 | # 使用docker镜像nginx:latest以后台模式启动一个容器,并将容器命名为mynginx。 |
start/stop/restart
docker start :启动一个或多个已经被停止的容器
docker stop :停止一个运行中的容器
docker restart :重启容器
1 | docker start [OPTIONS] CONTAINER [CONTAINER...] |
1 | # 启动已被停止的容器myrunoob |
kill
docker kill :杀掉一个运行中的容器。
1 | docker kill [OPTIONS] CONTAINER [CONTAINER...] |
OPTIONS说明:
- -s : 向容器发送一个信号
1 | # 杀掉运行中的容器mynginx |
rm
docker rm : 删除一个或多个容器。
1 | docker rm [OPTIONS] CONTAINER [CONTAINER...] |
OPTIONS说明:
- -f : 通过 SIGKILL 信号强制删除一个运行中的容器。
- -l : 移除容器间的网络连接,而非容器本身。
- -v : 删除与容器关联的卷。
1 | # 强制删除容器 db01、db02 |
pause/unpause
docker pause :暂停容器中所有的进程。
docker unpause :恢复容器中所有的进程。
1 | docker pause [OPTIONS] CONTAINER [CONTAINER...] |
1 | # 暂停数据库容器db01提供服务。 |
create
docker create : 创建一个新的容器但不启动它
1 | docker create [OPTIONS] IMAGE [COMMAND] [ARG...] |
1 | # 使用docker镜像nginx:latest创建一个容器,并将容器命名为myrunoob |
exec
docker exec : 在运行的容器中执行命令
1 | docker exec [OPTIONS] CONTAINER COMMAND [ARG...] |
OPTIONS说明:
- -d : 分离模式: 在后台运行
- -i : 即使没有附加也保持STDIN 打开
- -t : 分配一个伪终端
1 | # 在容器 mynginx 中以交互模式执行容器内 /root/runoob.sh 脚本: |
容器操作
ps
docker ps : 列出容器
1 | docker ps [OPTIONS] |
OPTIONS说明:
- -a :显示所有的容器,包括未运行的。
- -f :根据条件过滤显示的内容。
- –format :指定返回值的模板文件。
- -l :显示最近创建的容器。
- -n :列出最近创建的n个容器。
- –no-trunc :不截断输出。
- -q :静默模式,只显示容器编号。
- -s :显示总的文件大小。
1 | # 列出所有在运行的容器信息 |
输出详情介绍:
- CONTAINER ID: 容器 ID。
- IMAGE: 使用的镜像。
- COMMAND: 启动容器时运行的命令。
- CREATED: 容器的创建时间。
- STATUS: 容器状态。
- PORTS: 容器的端口信息和使用的连接类型(tcp\udp)。
- NAMES: 自动分配的容器名称。
状态有7种:
- created(已创建)
- restarting(重启中)
- running(运行中)
- removing(迁移中)
- paused(暂停)
- exited(停止)
- dead(死亡)
inspect
docker inspect : 获取容器/镜像的元数据。
1 | docker inspect [OPTIONS] NAME|ID [NAME|ID...] |
OPTIONS说明:
- -f :指定返回值的模板文件。
- -s :显示总的文件大小。
- –type :为指定类型返回JSON。
1 | # 获取镜像mysql:5.6的元信息。 |
1 | # 获取正在运行的容器mymysql的 IP。 |
top
docker top :查看容器中运行的进程信息,支持 ps 命令参数。
1 | docker top [OPTIONS] CONTAINER [ps OPTIONS] |
1 | # 查看容器mymysql的进程信息。 |
attach
docker attach :连接到正在运行中的容器。
语法
1 | docker attach [OPTIONS] CONTAINER |
1 | # 容器mynginx将访问日志指到标准输出,连接到容器查看访问信息。 |
events
docker events : 从服务器获取实时事件
1 | docker events [OPTIONS] |
OPTIONS说明:
- -f :根据条件过滤事件;
- –since :从指定的时间戳后显示所有事件;
- –until :流水时间显示到指定的时间为止;
1 | # 显示docker 2016年7月1日后的所有事件。 |
logs
docker logs : 获取容器的日志
1 | docker logs [OPTIONS] CONTAINER |
OPTIONS说明:
- -f : 跟踪日志输出
- –since :显示某个开始时间的所有日志
- -t : 显示时间戳
- –tail :仅列出最新N条容器日志
1 | # 跟踪查看容器mynginx的日志输出。 |
wait
docker wait : 阻塞运行直到容器停止,然后打印出它的退出代码。
1 | docker wait [OPTIONS] CONTAINER [CONTAINER...] |
1 | docker wait CONTAINER |
export
docker export :将文件系统作为一个tar归档文件导出到STDOUT。
1 | docker export [OPTIONS] CONTAINER |
OPTIONS说明:
- -o :将输入内容写到文件。
1 | # 将id为a404c6c174a2的容器按日期保存为tar文件。 |
port
docker port :列出指定的容器的端口映射,或者查找将PRIVATE_PORT NAT到面向公众的端口。
1 | docker port [OPTIONS] CONTAINER [PRIVATE_PORT[/PROTO]] |
1 | # 查看容器mynginx的端口映射情况。 |
容器rootfs命令
commit
docker commit :从容器创建一个新的镜像。
1 | docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]] |
OPTIONS说明:
- -a :提交的镜像作者;
- -c :使用Dockerfile指令来创建镜像;
- -m :提交时的说明文字;
- -p :在commit时,将容器暂停。
1 | # 将容器a404c6c174a2 保存为新的镜像,并添加提交人信息和说明信息。 |
cp
docker cp :用于容器与主机之间的数据拷贝。
语法
1 | docker cp [OPTIONS] CONTAINER:SRC_PATH DEST_PATH|- |
OPTIONS说明:
- -L :保持源目标中的链接
1 | # 将主机/www/runoob目录拷贝到容器96f7f14e99ab的/www目录下。 |
diff
docker diff : 检查容器里文件结构的更改。
1 | docker diff [OPTIONS] CONTAINER |
1 | # 查看容器mymysql的文件结构更改。 |
镜像仓库
login
docker login : 登陆到一个Docker镜像仓库,如果未指定镜像仓库地址,默认为官方仓库 Docker Hub
docker logout : 登出一个Docker镜像仓库,如果未指定镜像仓库地址,默认为官方仓库 Docker Hub
1 | docker login [OPTIONS] [SERVER] |
OPTIONS说明:
- -u :登陆的用户名
- -p :登陆的密码
1 | # 登陆到Docker Hub |
pull
docker pull : 从镜像仓库中拉取或者更新指定镜像
1 | docker pull [OPTIONS] NAME[:TAG|@DIGEST] |
OPTIONS说明:
- -a :拉取所有 tagged 镜像
- –disable-content-trust :忽略镜像的校验,默认开启
1 | # 从Docker Hub下载java最新版镜像。 |
push
docker push : 将本地的镜像上传到镜像仓库,要先登陆到镜像仓库
1 | docker push [OPTIONS] NAME[:TAG] |
OPTIONS说明:
- –disable-content-trust :忽略镜像的校验,默认开启
1 | # 上传本地镜像myapache:v1到镜像仓库中。 |
search
docker search : 从Docker Hub查找镜像
1 | docker search [OPTIONS] TERM |
OPTIONS说明:
- –automated :只列出 automated build类型的镜像;
- –no-trunc :显示完整的镜像描述;
- -s :列出收藏数不小于指定值的镜像。
1 | # 从Docker Hub查找所有镜像名包含java,并且收藏数大于10的镜像 |
参数说明:
- NAME: 镜像仓库源的名称
- DESCRIPTION: 镜像的描述
- OFFICIAL: 是否 docker 官方发布
- stars: 类似 Github 里面的 star,表示点赞、喜欢的意思。
- AUTOMATED: 自动构建。
本地镜像管理
images
docker images : 列出本地镜像。
1 | docker images [OPTIONS] [REPOSITORY[:TAG]] |
OPTIONS说明:
- -a :列出本地所有的镜像(含中间映像层,默认情况下,过滤掉中间映像层);
- –digests :显示镜像的摘要信息;
- -f :显示满足条件的镜像;
- –format :指定返回值的模板文件;
- –no-trunc :显示完整的镜像信息;
- -q :只显示镜像ID。
1 | # 查看本地镜像列表 |
rmi
docker rmi : 删除本地一个或多少镜像。
1 | docker rmi [OPTIONS] IMAGE [IMAGE...] |
OPTIONS说明:
- -f :强制删除;
- –no-prune :不移除该镜像的过程镜像,默认移除;
1 | # 强制删除本地镜像 runoob/ubuntu:v4 |
tag
docker tag : 标记本地镜像,将其归入某一仓库。
1 | docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG] |
1 | # 将镜像ubuntu:15.10标记为 runoob/ubuntu:v3 镜像 |
build
docker build 命令用于使用 Dockerfile 创建镜像。
1 | docker build [OPTIONS] PATH | URL | - |
OPTIONS说明:
- –build-arg=[] :设置镜像创建时的变量;
- –cpu-shares :设置 cpu 使用权重;
- –cpu-period :限制 CPU CFS周期;
- –cpu-quota :限制 CPU CFS配额;
- –cpuset-cpus :指定使用的CPU id;
- –cpuset-mems :指定使用的内存 id;
- –disable-content-trust :忽略校验,默认开启;
- -f :指定要使用的Dockerfile路径;
- –force-rm :设置镜像过程中删除中间容器;
- –isolation :使用容器隔离技术;
- –label=[] :设置镜像使用的元数据;
- -m :设置内存最大值;
- –memory-swap :设置Swap的最大值为内存+swap,”-1”表示不限swap;
- –no-cache :创建镜像的过程不使用缓存;
- –pull :尝试去更新镜像的新版本;
- –quiet, -q :安静模式,成功后只输出镜像 ID;
- –rm :设置镜像成功后删除中间容器;
- –shm-size :设置/dev/shm的大小,默认值是64M;
- –ulimit :Ulimit配置。
- –tag, -t: 镜像的名字及标签,通常 name:tag 或者 name 格式;可以在一次构建中为一个镜像设置多个标签。
- –network: 默认 default。在构建期间设置RUN指令的网络模式
1 | # 使用当前目录的 Dockerfile 创建镜像,标签为 runoob/ubuntu:v1 |
history
docker history : 查看指定镜像的创建历史。
1 | docker history [OPTIONS] IMAGE |
OPTIONS说明:
- -H :以可读的格式打印镜像大小和日期,默认为true;
- –no-trunc :显示完整的提交记录;
- -q :仅列出提交记录ID。
1 | # 查看本地镜像runoob/ubuntu:v3的创建历史 |
save
docker save : 将指定镜像保存成 tar 归档文件。
1 | docker save [OPTIONS] IMAGE [IMAGE...] |
OPTIONS 说明:
- -o :输出到的文件。
1 | # 将镜像 runoob/ubuntu:v3 生成 my_ubuntu_v3.tar 文档 |
load
docker load : 导入使用 docker save 命令导出的镜像。
1 | docker load [OPTIONS] |
OPTIONS 说明:
- –input , -i : 指定导入的文件,代替 STDIN。
- –quiet , -q : 精简输出信息。
1 | # 导入镜像 |
import
docker import : 从归档文件中创建镜像。
1 | docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]] |
OPTIONS说明:
- -c :应用docker 指令创建镜像;
- -m :提交时的说明文字;
1 | # 从镜像归档文件my_ubuntu_v3.tar创建镜像,命名为runoob/ubuntu:v4 |
其他
info
docker info : 显示 Docker 系统信息,包括镜像和容器数。。
1 | docker info [OPTIONS] |
version
docker version :显示 Docker 版本信息。
1 | docker version [OPTIONS] |
OPTIONS说明:
- -f :指定返回值的模板文件。