igor_nikiforov.docker
Rol de Ansible: Docker
Esta rol instala y configura Docker así como compose y el SDK de Docker para Python.
Requisitos
Esta rol fue desarrollada y probada con las siguientes versiones de Ansible:
Nombre | Versión |
---|---|
ansible | >= 2.9.13 |
ansible-base | >= 2.10.1 |
ansible-core | >= 2.11.2 |
Otras versiones de Ansible no fueron probadas, pero probablemente funcionen.
Instalación
Usa ansible-galaxy install igor_nikiforov.docker
para instalar la última versión estable de la rol.
También puedes instalarla desde los requisitos usando ansible-galaxy install -r requirements.yml
:
# requirements.yml
---
roles:
- name: igor_nikiforov.docker
version: v1.1.0
Plataformas
Nombre | Versión |
---|---|
Debian | buster |
Ubuntu | focal, groovy |
CentOS | 7.4+, 8 |
RedHat | 7.4+, 8 |
Otras distribuciones de SO no fueron probadas, pero probablemente funcionen. En caso de que no, ¡por favor abre un PR!
Variables
Nombre | Descripción | Por defecto |
---|---|---|
docker_supported_architectures | Lista de arquitecturas soportadas por Docker | ["x86_64", "arm64", "armhf", "s390x"] |
docker_install | Si es verdadero, se instalará Docker | true |
docker_version | Versión de Docker | latest |
docker_bash_completion_install | Si es verdadero, se instalará la finalización de bash de Docker | true |
docker_daemon_config | Configuración del daemon de Docker | {} |
docker_service_enabled | Si el servicio de Docker debería iniciarse al arrancar | true |
docker_service_state | Estado del servicio de Docker | started |
docker_users | Lista de usuarios a agregar al grupo de docker | [] |
docker_sdk_for_python_install | Si es verdadero, se instalará el SDK de Docker para Python | false |
docker_sdk_for_python_version | Versión del SDK de Docker para Python | latest |
docker_compose_install | Si es verdadero, se instalará Docker Compose | false |
docker_compose_version | Versión de Docker Compose | latest |
docker_compose_bash_completion_install | Si es verdadero, se instalará la finalización de bash de Docker Compose | true |
Uso
La rol soporta todos los parámetros de configuración del daemon de Docker que pueden ser pasados a través de la variable docker_daemon_config
. Puedes encontrar un ejemplo del formato de configuración JSON en la documentación oficial de Docker. Para usarlo en la rol, debes convertir la configuración de JSON a formato YAML, por ejemplo usando esta herramienta en línea.
Ejemplos
# playbook.yml
---
- hosts: all
become: True
gather_facts: False
pre_tasks:
- wait_for_connection: { timeout: 300 }
- setup:
vars:
docker_sdk_for_python_install: True
docker_compose_install: True
docker_daemon_config:
default-address-pools:
- { base: 172.16.0.0/16, size: 26 }
log-driver: "json-file"
log-opts:
max-size: "10m"
max-file: "3"
tasks:
- name: Instalar Docker
import_role:
name: docker
Licencia
MIT
Información del Autor
Install and configure Docker
ansible-galaxy install igor_nikiforov.docker