ansible/centos7-ansible

Ansible-Docker-Base 镜像文档

镜像已弃用通知

这些镜像已被弃用

Ansible不再直接在Dockerhub维护镜像。Dockerhub上有多个由Ansible社区成员维护的Ansible镜像，可通过https://hub.docker.com/search/?q=ansible&page=1&isAutomated=0&isOfficial=0&pullCount=1&starCount=0%E6%89%BE%E5%88%B0%E3%80%82

镜像概述和主要用途

Ansible-Docker-Base是包含Ansible的基础Docker镜像。

这些镜像由Ansible, Inc维护，旨在帮助用户通过Ansible playbook轻松构建Docker镜像。

尽管Ansible模块可用于部署容器镜像（以及准备主机依赖以运行容器），本文档主要介绍如何使用Ansible高效描述和构建容器镜像。

从DockerHub获取镜像

Ansible, Inc在DockerHub上的内容位于：https://registry.hub.docker.com/u/ansible/

目前提供基于CentOS 7和Ubuntu 14.04 LTS的基础镜像，同时包含最新稳定版Ansible和开发分支快照版本。

基于Ansible镜像构建自己的容器

通过指定Dockerfile，可以使用非常简洁的Dockerfile来描述主要由Ansible playbook定义的容器镜像。

可参考https://github.com/ansible/ansible-docker-base/blob/master/examples/webserver-simple/Dockerfile%E6%9F%A5%E7%9C%8B%E7%A4%BA%E4%BE%8B%E3%80%82

要构建此镜像，只需进入包含Dockerfile的目录并运行：

bash
docker build -t webserver_simple .

这将生成一个标记为"webserver_simple"的镜像，基于Ansible playbook运行结果。https://github.com/ansible/ansible-docker-base/blob/master/examples/webserver-simple/ansible/site.yml%E3%80%82

您自己的内容应保存在独立的git仓库中。建议将包含Ansible+Docker playbook的仓库连接到DockerHub，以便在底层Ansible playbook或其嵌入的应用程序发生变化时触发容器镜像的自动重建。

选择Ansible版本

上述DockerFile选择了Ansible Docker镜像的最新CentOS标签。如需使用不同的操作系统或Ansible版本，可修改DockerFile的第一行。

可用选项如下：

dockerfile
FROM docker.xuanyuan.run/ansible/centos7-ansible:stable
FROM docker.xuanyuan.run/ansible/centos7-ansible:devel
FROM docker.xuanyuan.run/ansible/ubuntu14.04-ansible:stable
FROM docker.xuanyuan.run/ansible/ubuntu14.04-ansible:devel

DockerHub上的Ansible镜像会定期更新。

使用Ansible Galaxy扩展Docker内容

Ansible提供240多个模块用于管理IT组件的各个方面，是描述应用程序的良好起点。[***]

要在Docker中使用现有的ansible-role内容，只需切换到playbook目录并下载角色。例如，要配置ELK栈：

bash
mkdir roles/
cd roles/
ansible-galaxy install bakhti.elk

然后在playbook中使用该角色内容：

yaml
- hosts: localhost
  roles:
    - bakhti.elk

这样，一个3行的playbook即可在容器镜像中部署完整的ELK栈。

使用Ansible部署基于Ansible构建的Docker容器

镜像推送到仓库后，可使用http://docs.ansible.com/docker_module.html%E8%BF%9B%E8%A1%8C%E9%83%A8%E7%BD%B2%E3%80%82%E8%BF%99%E6%98%AF%E4%B8%80%E7%A7%8D%E8%BD%BB%E9%87%8F%E7%BA%A7%E6%96%B9%E5%BC%8F%EF%BC%8C%E7%94%A8%E4%BA%8E%E6%8C%87%E5%AE%9A%E5%93%AA%E4%BA%9B%E5%AE%B9%E5%99%A8%E5%BA%94%E5%9C%A8%E5%93%AA%E4%BA%9B%E4%B8%BB%E6%9C%BA%E4%B8%8A%E8%BF%90%E8%A1%8C%E3%80%82

以下是在所有主机上运行Tomcat容器的简单示例：

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

将"image"参数替换为您仓库中的镜像名称。

有关更多信息，请参考http://docs.ansible.com/docker_module.html%E3%80%82

随着需求变得更加复杂，如需为不同主机指定不同容器，可在Ansible主机组中定义"run_containers"列表，指定每台主机应运行的容器。这使Ansible可作为轻量级云平台使用，无需额外组件。

当Ansible镜像更新时自动重建

如果使用Docker Hub自动构建来构建镜像，可设置镜像在基础Ansible镜像（由Ansible, Inc托管）更新时自动重建：

1. 进入Docker Hub上您的仓库页面。
2. 在标有"设置"的侧边栏中，找到"仓库链接"条目。
3. 在"仓库链接"页面，输入您的镜像所基于的Ansible仓库。例如，如果使用ubuntu14.04-ansible仓库，在"仓库名称"框中输入ansible/ubuntu14.04-ansible，然后点击"添加"。
4. 此后，当该Ansible仓库有新构建时，Docker Hub将自动重建您的镜像。

问题支持

如想讨论Ansible+Docker相关问题，可访问https://groups.google.com/forum/#!forum/ansible-project%E6%88%96IRC%E9%A2%91%E9%81%93irc.freenode.net%E4%B8%8A%E7%9A%84#ansible%E3%80%82