mongrelion.docker
Rol de Ansible: docker
Descripción
Instala y configura la plataforma de contenedorización docker.
Requisitos
- Ansible >= 2.4
Variables del Rol
Todas las variables que se pueden sobrescribir están almacenadas en el archivo defaults/main.yml así como en la tabla a continuación.
| Nombre | Valor por Defecto | Descripción |
|---|---|---|
docker_compose |
sí | Instalar el paquete docker-compose |
docker_proxy |
no | Habilitar la configuración de proxy HTTP |
docker_http_proxy |
"" | Dirección del servidor proxy HTTP |
docker_https_proxy |
"" | Dirección del servidor proxy HTTPS |
docker_no_proxy |
"" | Lista separada por comas de hosts que no usarán el proxy HTTP |
docker_version |
"17.06" | Versión de docker que debe instalarse en el servidor de destino. Se puede usar latest para actualizaciones |
docker_default_config |
[ storage-driver: devicemapper, log-level: info ] | Configuración del demonio Docker |
docker_users |
[] | Agregar usuarios al grupo de docker. Los usuarios deben existir antes de ser añadidos. Se puede construir como `- {{ ansible_env['SUDO_USER'] |
Ejemplo
Playbooks
Solo instalar Docker con la configuración por defecto
- hosts: servers
roles:
- mongrelion.docker
Instalar y configurar el demonio de docker
- hosts: servers
roles:
- role: mongrelion.docker
docker_config:
live-restore: true
userland-proxy: false
Pruebas Locales
La forma preferida de probar localmente el rol es usar Docker y molecule (v2.x). Deberás instalar Docker en tu sistema. Consulta "Comenzar" para encontrar un paquete de Docker adecuado para tu sistema. Estamos usando tox para simplificar el proceso de prueba en múltiples versiones de ansible. Para instalar tox ejecuta:
pip install tox
Para ejecutar pruebas en todas las versiones de ansible (ADVERTENCIA: esto puede llevar algún tiempo)
tox
Para ejecutar un comando molecule personalizado en un entorno personalizado con solo el escenario de prueba por defecto:
tox -e py27-ansible25 -- molecule test -s default
Para más información sobre molecule visita su documentación.
Si deseas realizar pruebas en un host docker remoto, especifica la variable DOCKER_HOST antes de ejecutar las pruebas con tox.
Licencia
Este proyecto está licenciado bajo la Licencia MIT. Consulta LICENSE para más detalles.
Información del Autor
Puedes encontrarme en Twitter: @mongrelion
Contribuyentes
- Carlos Leon (@mongrelion)
- Paweł Krupa (@paulfantom)
- Marcus Levine (@marcusianlevine)
- Manuel Hutter (@mhutter)
- Dmitri Bichko (@dbichko)
- Zane Westover (@zanewestover)
- Bruce Becker (@brucellino)
- David Wahlstrom (@drwahl)
- Max Oreshnikov (@maxim0r)
- Nicholas E. Rabenau (@nerab)
- Petr Balogh (@petr-balogh)
- ramz (@ageekymonk)
ansible-galaxy install mongrelion.docker