Docker命令行帮助(4)

insert

  1. Usage: docker insert IMAGE URL PATH
  3. 通过url给镜像路径增加文件

使用指定的镜像作为父镜像增加一层新的文件，insert命令不修改原始奖项，而新的镜像的内容包含父镜像和新文件

Examples

增加github文件

  1. $ sudo docker insert 8283e18b24bc https://raw.github.com/metalivedev/django/master/postinstall /tmp/postinstall.sh
  2. 06fd35556d7b

inspect

  1. Usage: docker inspect CONTAINER|IMAGE [CONTAINER|IMAGE...]
  3. 返回容器底层信息
  5.   -format="": 格式化输出的格式

默认情况下，这将使所有结果放在一个JSON数组中，如果指定格式，就安装指定的格式来执行输出每个结果

Go的text/template包描述格式化的细节

docker inspect

Examples

获得一个容器ip地址

  1.  sudo docker inspect -format='{{.NetworkSettings.IPAddress}}' $INSTANCE_ID

列出所有绑定的端口地址

  1. sudo docker inspect -format='{{range $p, $conf := .NetworkSettings.Ports}} {{$p}} -> {{(index $conf 0).HostPort}} {{end}}' $INSTANCE_ID

查找一个特定端口映射

当放字段名是一个数字时.Field语法不工作，网络设置端口部分包含一个内部端口影响到外部地址和端口的对象的列表！如果你要找出数字公共端口，你使用索引来查找特定端口映射，索引0包含的第一个对象！我们要求主机端口字段是获得公共地址！

  1. $ sudo docker inspect -format='{{(index (index .NetworkSettings.Ports "8787/tcp") 0).HostPort}}' $INSTANCE_ID

kill

  1. Usage: docker kill CONTAINER [CONTAINER...]
  3. 杀死一个正在运行的容器（发送终止信号）

已知问题（kill） issue 197标明docker kill将很难删除目录和删除容器

load

  1. Usage: docker load < ubuntu.tar
  3. 从输入流中加载一个压缩包，恢复包含的所有镜像和tag

login

  1. Usage: docker login [OPTIONS] [SERVER]
  3. 登陆你在docker服务器注册的账号 index.docker.io
  5. -e="": email
  6. -p="": password
  7. -u="": username
  9. 如果你想登陆你的私有的仓库你可以添加的你服务器名称
  11. example:
  12. docker login localhost:8080

logs

  1. Usage: docker logs [OPTIONS] CONTAINER
  3. 取出容器的log日志

docker logs

docker logs命令提供一个便利的任何执行时间的记录，当你使用docker run的时候并不能保证执行顺序（当你docker logs你就可能没有产生一些执行记录）

port

  1. Usage: docker port [OPTIONS] CONTAINER PRIVATE_PORT
  3. 查找私有地址转换到共有地址端口

docker port

ps

  1. Usage: docker ps [OPTIONS]
  3. List containers
  5.   -a=false: 查看所有的镜像 默认情况下只查看正在运行的镜像
  6.   -notrunc=false: 不把输出截断
  7.   -q=false: 仅仅只显示镜像ID

运行docker ps查看2个容器

  1. $ docker ps
  2. CONTAINER ID        IMAGE                        COMMAND                CREATED              STATUS              PORTS               NAMES
  3. 4c01db0b339c        ubuntu:12.04                 bash                   17 seconds ago       Up 16 seconds                           webapp
  4. d7886598dbe2        crosbymichael/redis:latest   /redis-server --dir    33 minutes ago       Up 33 minutes       6379/tcp            redis,webapp/db

docker ps

pull

  1. Usage: docker pull NAME
  3. 从远程仓库中获取镜像

push

  1. Usage: docker push NAME
  3. 推送本地镜像到远程仓库

restart

  1. Usage: docker restart [OPTIONS] NAME
  3. 重启正在运行的远程仓库

rm

  1. Usage: docker rm [OPTIONS] CONTAINER
  3. 删除一个或者所有的容器
  5. -link="": Remove the link instead of the actual container

已知问题（kill） issue 197标明docker kill将很难删除目录和删除容器

Examples

  1. $ sudo docker rm /redis
  2. /redis

这将删除容器下引用的链接/reids

  1. $ sudo docker rm -link /webapp/redis
  2. /webapp/redis

这将删除/webapp /redis底层之间的联系，容器中会删除所有的网络通信

  1. $ sudo docker rm `docker ps -a -q`

这个命令会删除所有停止运行的容器，docker ps -a -q会返回所有的镜像ID通过这些镜像ID再执行rm命令删除它们，当然正在运行的是不会被删除的

rmi

  1. Usage: docker rmi IMAGE [IMAGE...]
  3. 删除一个或者多个镜像

删除标记的镜像

  1. 镜像可以通过它们的长或者短ID删除或者他们的镜像名称，如果一个镜像有一个或者多个名称，在删除镜像之前，他们每一个都必须要删除
  3. $ sudo docker images
  4. REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
  5. test1                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
  6. test                      latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
  7. test2                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
  9. $ sudo docker rmi fd484f19954f
  10. Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories
  11. 2013/12/11 05:47:16 Error: failed to remove one or more images
  13. $ sudo docker rmi test1
  14. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
  15. $ sudo docker rmi test2
  16. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
  18. $ sudo docker images
  19. REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
  20. test1                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
  21. $ sudo docker rmi test
  22. Untagged: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
  23. Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8

run

  1. Usage: docker run [OPTIONS] IMAGE[:TAG] [COMMAND] [ARG...]
  3. Run a command in a new container
  5.   -a=map[]: 附加标准输入、输出或者错误输出
  6.   -c=0: 共享CPU格式（相对重要）
  7.   -cidfile="": 将容器的ID标识写入文件
  8.   -d=false: 分离模式，在后台运行容器，并且打印出容器ID
  9.   -e=[]: 设置环境变量
  10.   -h="": 容器的主机名称
  11.   -i=false: 保持输入流开放即使没有附加输入流
  12.   -privileged=false: 给容器扩展的权限
  13.   -m="": 内存限制 (格式: <number><optional unit>, unit单位 = b, k, m or g)
  14.   -n=true: 允许镜像使用网络
  15.   -p=[]: 匹配镜像内的网络端口号
  16.   -rm=false:当容器退出时自动删除容器 (不能跟 -d一起使用)
  17.   -t=false: 分配一个伪造的终端输入
  18.   -u="": 用户名或者ID
  19.   -dns=[]: 自定义容器的DNS服务器
  20.   -v=[]: 创建一个挂载绑定：[host-dir]:[container-dir]:[rw|ro]. 如果容器目录丢失，docker会创建一个新的卷
  21.   -volumes-from="": 挂载容器所有的卷
  22.   -entrypoint="": 覆盖镜像设置默认的入口点
  23.   -w="": 工作目录内的容器
  24.   -lxc-conf=[]: 添加自定义 -lxc-conf="lxc.cgroup.cpuset.cpus = 0,1"
  25.   -sig-proxy=true: 代理接收所有进程信号 (even in non-tty mode)
  26.   -expose=[]: 让你主机没有开放的端口
  27.   -link="": 连接到另一个容器 (name:alias)
  28.   -name="": 分配容器的名称，如果没有指定就会随机生成一个
  29.   -P=false: Publish all exposed ports to the host interfaces 公布所有显示的端口主机接口

docker会先创建一个新的可写的容器层来指定镜像，通过指定命令来启动他，docker run相当于运行API/containers/create在/container/(id)/start之前

docker run命令可以用结合docker commit来改变正在运行的容器！

知道问题(run -volumes-from)

Issue 2702: “lxc-start: Permission denied - failed to mount” 这是AppArmor一个权限的问题，请参见问题解决方案

  1. $ sudo docker run -cidfile /tmp/docker_test.cid ubuntu echo "test"

这个命令将会创建一个容器，并且在终端打印’test’,cidfile参数使docker试图穿件一个文件并且写入容器的id,如果这个文件存在，docker就会返回一个错误，如果docker runexists,docker就会关闭这个文件！

  1. $ sudo docker run -t -i -rm ubuntu bash
  2. root@bc338942ef20:/# mount -t tmpfs none /mnt
  3. mount: permission denied

这条命令没有执行，因为在默认情况下，大多数有潜在危险内核命令都被舍弃，包括cap_sys_admin(需要挂载文件系统)，然而
-privileged参数会让其执行

  1. $ sudo docker run -privileged ubuntu bash
  2. root@50e3f57e16e6:/# mount -t tmpfs none /mnt
  3. root@50e3f57e16e6:/# df -h
  4. Filesystem      Size  Used Avail Use% Mounted on
  5. none            1.9G     0  1.9G   0% /mnt

-privileged参数给容器所有功能，同时它也强迫升级了所有设备的执行权限，换句话说，这个容器已经有了所有主机能做的事情，这个参数的存在允许特殊的用例，像docker内运行docker

  1. $ sudo docker  run -w /path/to/dir/ -i -t  ubuntu pwd

-w 让命令在在目录/path/to/dir内运行,如果路径不存在创建，在容器外运行

docker run -w

  1. $ sudo docker  run  -v `pwd`:`pwd` -w `pwd` -i -t  ubuntu pwd

docker run -v -w

-v参数安装当前工作目录到容器中，-w参数让命令在当前目录执行，通过pwd改变目录的返回值，这种组合命令使容器在当前目录下中心命令！

  1. $ sudo docker run -p 127.0.0.1:80:8080 ubuntu bash

容器的8080端口绑定在主机127.0.0.1的80端口。端口重定向解释了docker的端口是如何工作的

  1. $ sudo docker run -expose 80 ubuntu bash

让主机系统开放80端口供容器连接

  1. $ sudo docker run -name console -t -i ubuntu bash

这会创建一个新的容器并且运行bash，容器的名字是console

docker run -name

  1. $ sudo docker run -link /redis:redis -name console ubuntu bash

-link表示会将连接一个名为/redis的容器到新建的一个容器别名叫做redis,新的容器可以通过redis容器的环境变量访问网络和环境， -name参数会将名字console分配给新建的容器！

docker run -link

  1. $ sudo docker run -volumes-from 777f7dc92da7,ba8c0c54f0f2:ro -i -t ubuntu pwd

-volumes-from 参数将从引用容器中挂载所有定义的卷. 容器引用列表可以用逗号分隔或者重复的引用 -volumes-from参数. 容器ID可以用:ro或者:rw来作为后缀挂载卷来标识只读或者读写权限，默认情况下，挂载的权限(读写权限)和引用容器的权限相同.

一个完整的例子

  1. $ sudo docker run -d -name static static-web-files sh
  2. $ sudo docker run -d -expose=8098 -name riak riakserver
  3. $ sudo docker run -d -m 100m -e DEVELOPMENT=1 -e BRANCH=example-code -v $(pwd):/app/bin:ro -name app appserver
  4. $ sudo docker run -d -p 1443:443 -dns=dns.dev.org -v /var/log/httpd -volumes-from static -link riak -link app -h www.sven.dev.org -name web webserver
  5. $ sudo docker run -t -i -rm -volumes-from web -w /var/log/httpd busybox tail -f access.log

这个实例展示了5个容器设置测试一个web应用程序的改变：

后台运行一个已经准备好的镜像卷 static-web-files，镜像里含有CSS,images,和静态html, (Dockerfile中的卷指令允许web server使用这些文件);

运行一个预先准备好的riakserver,给这个容器命名为riak,并且开放8098端口让其它镜像可以连接它！

give the container name riak and expose port 8098 to any containers that link to it;

运行一个appserver镜像，限制它的内存时100MB，设置两个环境变量DEVELOPMENT和BRANCH，并且依只读模式将本地文件pwd的目录挂载绑定到你容器的/app/bin下

运行webserver,将容器443端口映射到外部的docker主机的1443端口，设置DNS服务dns.dev.org，创建一个卷来存放日志文件(所以我们可以从另外的主机访问它)，导入静态文件从开放的8098端口，从static容器，连接riak和app的所有开放端口，最后我们设置hostname web.sven.dev.org,与生成的SSL证书一致.

最终，我们创建了一个容器，可以运行tail -f access.log来查看web容器的卷日志，设置工作目录是/var/log/httpd. -rm表示的意思是如果这个容器存在，我们就删除容器的层

save

  1. Usage: docker save image > repository.tar
  3. 通过标准输出流存储镜像包含所有父层的、tag、version
  1. Usage: docker search TERM
  3. 搜索docker 镜像
  5.  -notrunc=false: 不截断输出
  6.  -stars=0: 仅仅输出带有lastest标记的镜像
  7.  -trusted=false: 只显示被信任的构建

start

  1. Usage: docker start [OPTIONS] CONTAINER
  3. 启动一个停止的容器
  5.   -a=false: 附加标准输入和输出，并转发所有进程信号
  6.   -i=false: 附加标准输入

stop

  1. Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]
  3. 关闭一个容器
  5.   -t=10: 等待停止容器需要的时间

这个容器主进程接收终止进程信号，在一段时间内，终止

tag

  1. Usage: docker tag [OPTIONS] IMAGE REPOSITORY[:TAG]
  3. 给镜像仓库添加标签
  5.   -f=false: Force

top

  1. Usage: docker top CONTAINER [ps OPTIONS]
  3. 查看容器内运行的进程

docker top

version

显示docker的版本和最后更新版本信息

wait

  1. Usage: docker wait [OPTIONS] NAME
  3. 等待容器停止，打印出退出编码