diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 34 |
1 files changed, 20 insertions, 14 deletions
@@ -6,9 +6,9 @@ Docker-Ansible base images | |||
6 | 6 | ||
7 | ## Summary | 7 | ## Summary |
8 | 8 | ||
9 | Repository name in Docker Hub: **[williamyeh/ansible](https://registry.hub.docker.com/u/williamyeh/ansible/)** | 9 | Repository name in Docker Hub: **[williamyeh/ansible](https://hub.docker.com/r/williamyeh/ansible/)** |
10 | 10 | ||
11 | This repository contains Dockerized [Ansible](https://github.com/ansible/ansible), published to the public [Docker Hub](https://registry.hub.docker.com/) via **automated build** mechanism. | 11 | This repository contains Dockerized [Ansible](https://github.com/ansible/ansible), published to the public [Docker Hub](https://hub.docker.com/) via **automated build** mechanism. |
12 | 12 | ||
13 | 13 | ||
14 | 14 | ||
@@ -18,19 +18,25 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
18 | 18 | ||
19 | - OS: Debian (jessie, wheezy), Ubuntu (xenial, trusty, precise), CentOS (7, 6), Alpine (3). | 19 | - OS: Debian (jessie, wheezy), Ubuntu (xenial, trusty, precise), CentOS (7, 6), Alpine (3). |
20 | 20 | ||
21 | - Ansible: four variants - | 21 | - Ansible: four versions - |
22 | 22 | ||
23 | 1. provides the most recent *stable* version of Ansible; suitable for most people. | 23 | 1. provides the most recent *stable* version of Ansible; suitable for most people. |
24 | 2. this variant is designed for building *minimal* images out of playbooks; i.e., the Ansible body will be removed when mission completed. | 24 | 2. same as stable version, but is designed for building *minimal* images out of playbooks; i.e., the Ansible body will be removed when mission completed. |
25 | 3. provides the old 1.9 version of Ansible. | 25 | 3. provides the old 1.9 version of Ansible. |
26 | 4. provides the *experimental* version of Ansible. | 26 | 4. provides the *experimental* version of Ansible; i.e., the master branch of git. |
27 | |||
28 | |||
29 | Each version is further divided into two variants: | ||
30 | |||
31 | - Normal variant: intended to be used as Ansible *control machines*, or in cases that is unsuitable in the onbuild variants. | ||
32 | - Onbuild variant: intended to be used to build Docker images. | ||
27 | 33 | ||
28 | 34 | ||
29 | ## Images and tags | 35 | ## Images and tags |
30 | 36 | ||
31 | ### Stable version (installed from official PyPI repo): | 37 | ### Stable version (installed from official PyPI repo): |
32 | 38 | ||
33 | - Normal series: | 39 | - Normal variants: |
34 | 40 | ||
35 | - `williamyeh/ansible:debian8` | 41 | - `williamyeh/ansible:debian8` |
36 | - `williamyeh/ansible:debian7` | 42 | - `williamyeh/ansible:debian7` |
@@ -41,7 +47,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
41 | - `williamyeh/ansible:centos6` | 47 | - `williamyeh/ansible:centos6` |
42 | - `williamyeh/ansible:alpine3` | 48 | - `williamyeh/ansible:alpine3` |
43 | 49 | ||
44 | - Onbuild series (*recommended for common cases*): | 50 | - Onbuild variants (*recommended for common cases*): |
45 | 51 | ||
46 | - `williamyeh/ansible:debian8-onbuild` | 52 | - `williamyeh/ansible:debian8-onbuild` |
47 | - `williamyeh/ansible:debian7-onbuild` | 53 | - `williamyeh/ansible:debian7-onbuild` |
@@ -55,7 +61,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
55 | 61 | ||
56 | ### Minimal configuration (the Ansible body will be removed when mission completed): | 62 | ### Minimal configuration (the Ansible body will be removed when mission completed): |
57 | 63 | ||
58 | - Onbuild series: | 64 | - Onbuild variants: |
59 | 65 | ||
60 | - `williamyeh/ansible:mini-alpine3` | 66 | - `williamyeh/ansible:mini-alpine3` |
61 | - `williamyeh/ansible:mini-debian8` | 67 | - `williamyeh/ansible:mini-debian8` |
@@ -63,7 +69,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
63 | 69 | ||
64 | ### Old 1.9 version: | 70 | ### Old 1.9 version: |
65 | 71 | ||
66 | - Normal series: | 72 | - Normal variants: |
67 | 73 | ||
68 | - `williamyeh/ansible:1.9-debian8` | 74 | - `williamyeh/ansible:1.9-debian8` |
69 | - `williamyeh/ansible:1.9-debian7` | 75 | - `williamyeh/ansible:1.9-debian7` |
@@ -73,7 +79,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
73 | - `williamyeh/ansible:1.9-centos6` | 79 | - `williamyeh/ansible:1.9-centos6` |
74 | - `williamyeh/ansible:1.9-alpine3` | 80 | - `williamyeh/ansible:1.9-alpine3` |
75 | 81 | ||
76 | - Onbuild series (*recommended for common cases*): | 82 | - Onbuild variants (*recommended for common cases*): |
77 | 83 | ||
78 | - `williamyeh/ansible:1.9-debian8-onbuild` | 84 | - `williamyeh/ansible:1.9-debian8-onbuild` |
79 | - `williamyeh/ansible:1.9-debian7-onbuild` | 85 | - `williamyeh/ansible:1.9-debian7-onbuild` |
@@ -86,7 +92,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
86 | 92 | ||
87 | ### Experimental version (building directly from the git `master` source tree; use at your own risk!): | 93 | ### Experimental version (building directly from the git `master` source tree; use at your own risk!): |
88 | 94 | ||
89 | - Normal series: | 95 | - Normal variants: |
90 | 96 | ||
91 | - `williamyeh/ansible:master-debian8` | 97 | - `williamyeh/ansible:master-debian8` |
92 | - `williamyeh/ansible:master-debian7` | 98 | - `williamyeh/ansible:master-debian7` |
@@ -96,7 +102,7 @@ These are Docker images for [Ansible](https://github.com/ansible/ansible) softwa | |||
96 | - `williamyeh/ansible:master-centos7` | 102 | - `williamyeh/ansible:master-centos7` |
97 | - `williamyeh/ansible:master-centos6` | 103 | - `williamyeh/ansible:master-centos6` |
98 | 104 | ||
99 | - Onbuild series (*recommended for common cases*): | 105 | - Onbuild variants (*recommended for common cases*): |
100 | 106 | ||
101 | - `williamyeh/ansible:master-debian8-onbuild` | 107 | - `williamyeh/ansible:master-debian8-onbuild` |
102 | - `williamyeh/ansible:master-debian7-onbuild` | 108 | - `williamyeh/ansible:master-debian7-onbuild` |
@@ -143,7 +149,7 @@ For more advanced usage, the role in Ansible Galaxy [`williamyeh/nginx`](https:/ | |||
143 | 149 | ||
144 | ## Why yet another Ansible image for Docker? | 150 | ## Why yet another Ansible image for Docker? |
145 | 151 | ||
146 | There has been quite a few Ansible images for Docker (e.g., [search](https://registry.hub.docker.com/search?q=ansible) in the Docker Hub), so why reinvent the wheel? | 152 | There has been quite a few Ansible images for Docker (e.g., [search](https://hub.docker.com/search/?q=ansible&isAutomated=0&isOfficial=0&page=1&pullCount=1&starCount=0) in the Docker Hub), so why reinvent the wheel? |
147 | 153 | ||
148 | In the beginning I used the [`ansible/ansible-docker-base`](https://github.com/ansible/ansible-docker-base) created by Ansible Inc. It worked well, but left some room for improvement: | 154 | In the beginning I used the [`ansible/ansible-docker-base`](https://github.com/ansible/ansible-docker-base) created by Ansible Inc. It worked well, but left some room for improvement: |
149 | 155 | ||
@@ -235,7 +241,7 @@ RUN ansible-playbook -i inventory playbook.yml \ | |||
235 | --connection=local --sudo | 241 | --connection=local --sudo |
236 | ``` | 242 | ``` |
237 | 243 | ||
238 | You may also work with `onbuild` series, which take care of many routine steps for you: | 244 | You may also work with `onbuild` variants, which take care of many routine steps for you: |
239 | 245 | ||
240 | ```dockerfile | 246 | ```dockerfile |
241 | # Dockerfile | 247 | # Dockerfile |