docker - 使用 Ansible 管理 docker 容器

注:作者是 Cove Schneider,Joshua Conner, Pavel Antonov。原文是 Ansible 的官方文档中 docker – manage docker containers

大纲

在 Ansible 的 1.4 版本及以上支持。

管理 docker 容器的生命周期。

选项

属性必需默认值选择说明
commandno在启动的时候设置一个命令来运行容器
countno1设置运行的容器的数量
detachnotrue以 detached 模式启动,让容器在后台运行
dnsno为容器设置自定义的 DNS 服务器
docker_api_versionnodocker-py default remote API version使用的 Remote API 版本,默认的是当前 docker-py 默认指定的版本(在 Ansible 1.8 中添加)
docker_urlnounix://var/run/docker.sockdocker 主机发出命令的 URL
envno设置环境变量,(比如:env=”PASSWORD=sEcRe7,WORKERS=4″)
exposeno设置容器 expose 的端口,用于映射和 links。(如果这个端口已经在 Dockerfile 中 EXPOSE 了,你不需要再次 expose 它)。在 Ansible 1.5 中添加
hostnameno设置容器的主机名
imageyes设置使用的镜像
linksno把容器与其他容器连接起来(比如:links=redis,postgresql:db)。在 Ansible 1.5 中添加
lxc_confnoLXC 配置参数,比如: lxc.aa_profile:unconfined
memory_limitno256 MB设置给容器分配的内存
nameno设置容器的名字,不能与 count 参数同时使用,在 Ansible 1.5 中添加
netno为 容器设置网络模式(bridge, none, container:<name|id>, host). 要求 docker >= 0.11. (在 Ansible 1.8 中被添加))
passwordno设置远程API 的密码
portsno使用 docker CLI-style 语法,设置私有到公共端口的映射技术参数, [([ :[host_port]])|( ):] [/udp] (在 Ansible 1.5 中添加)
privilegedno设置容器是否应该允许在 privileged 模式
publish_all_portsno发布所有的暴露端口给主机接口,在 Ansible 1.5 中添加
registryno用于拉取镜像的远程仓库的 URL,(在 Ansible 1.8 中添加 )
statenopresentpresent running stopped absent killed restarted设置容器的状态
stdin_openno保持 stdin 打开。(在 Ansible 1.6 中添加)
ttyno分配一个 pseudo-tty (在 Ansible 1.6 添加)
usernameno设置远程 API 的名称
volumesno设置挂载在容器中的 volume
volumes_fromno从另外一个容器中设置共享卷

注意:要求 docker-py >= 0.3.0
注意:docker >= 0.10.0

示例:

在 web 组的每台主机上启动一个运行 tomcat 的容器,并且把 tomcat 的监听端口绑定到主机的 8080:

- hosts: web
  sudo: yes
  tasks:
  - name: run tomcat servers
    docker: image=centos command="service tomcat6 start" ports=8080

tomcat 服务器的端口是 NAT 到主机上的一个动态端口,但是你可以决定服务器哪个端口与 Docker 容器做映射:

- hosts: web
  sudo: yes
  tasks:
  - name: run tomcat servers
    docker: image=centos command="service tomcat6 start" ports=8080 count=5
  - name: Display IP address and port mappings for containers
    debug: msg={{inventory_hostname}}:{{item['HostConfig']['PortBindings']['8080/tcp'][0]['HostPort']}}
    with_items: docker_containers

正如前面的例子,但是是用一个 sequence 迭代 docker 容器的列表:

- hosts: web
  sudo: yes
  vars:
    start_containers_count: 5
  tasks:
  - name: run tomcat servers
    docker: image=centos command="service tomcat6 start" ports=8080 count={{start_containers_count}}
  - name: Display IP address and port mappings for containers
    debug: msg="{{inventory_hostname}}:{{docker_containers[{{item}}]['HostConfig']['PortBindings']['8080/tcp'][0]['HostPort']}}"
    with_sequence: start=0 end={{start_containers_count - 1}}

停止、移除所有正在运行的 tomcat 容器,并且从停止的容器中列出退出码:

- hosts: web
  sudo: yes
  tasks:
  - name: stop tomcat servers
    docker: image=centos command="service tomcat6 start" state=absent
  - name: Display return codes from stopped containers
    debug: msg="Returned {{inventory_hostname}}:{{item}}"
    with_items: docker_containers

创建一个命名的容器:

- hosts: web
  sudo: yes
  tasks:
  - name: run tomcat server
    docker: image=centos name=tomcat command="service tomcat6 start" ports=8080

创建多个命名的容器:

- hosts: web
  sudo: yes
  tasks:
  - name: run tomcat servers
    docker: image=centos name={{item}} command="service tomcat6 start" ports=8080
    with_items:
      - crookshank
      - snowbell
      - heathcliff
      - felix
      - sylvester

创建容器并通过使用 sequence 命名:

- hosts: web
  sudo: yes
  tasks:
  - name: run tomcat servers
    docker: image=centos name={{item}} command="service tomcat6 start" ports=8080
    with_sequence: start=1 end=5 format=tomcat_%d.example.com

创建两个连接的容器:

- hosts: web
  sudo: yes
  tasks:
  - name: ensure redis container is running
    docker: image=crosbymichael/redis name=redis

  - name: ensure redis_ambassador container is running
    docker: image=svendowideit/ambassador ports=6379:6379 links=redis:redis name=redis_ambassador_ansible

创建容器,指定选项作为键值对和列表:

- hosts: web
  sudo: yes
  tasks:
  - docker:
        image: namespace/image_name
        links:
          - postgresql:db
          - redis:redis

Create containers with options specified as strings and lists as comma-separated strings:

- hosts: web
  sudo: yes
  tasks:
  docker: image=namespace/image_name links=postgresql:db,redis:redis

创建一个没有 networking 的容器:

- hosts: web
  sudo: yes
  tasks:
  docker: image=namespace/image_name net=none
    原文作者:yexiaobai
    原文地址: https://segmentfault.com/a/1190000000656649
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞