darkwizard242.docker
Rol de Ansible: docker
Rol para instalar (por defecto) el paquete docker o desinstalar (si se pasa como variable) en sistemas Ubuntu, Debian y CentOS.
Requisitos
Ninguno.
Variables del Rol
Las variables disponibles están listadas a continuación (ubicadas en defaults/main.yml):
Lista de Variables:
docker_architecture_map:
amd64: amd64
x86_64: amd64
armv6l: armhfv6
armv7l: armhfv6
aarch64: arm64
32-bit: "386"
64-bit: amd64
docker_apps:
- docker-ce
- docker-ce-cli
- containerd.io
docker_apps_desired_state: present
docker_service_name: docker
docker_service_desired_state: restarted
docker_service_desired_boot_enabled: yes
docker_group: docker
docker_group_desired_state: present
docker_user: docker
docker_user_home: "/home/{{ docker_user }}"
docker_user_shell: /bin/bash
docker_user_desired_state: present
docker_repo_gpg_key: https://download.docker.com/linux/{{ ansible_distribution | lower }}/gpg
docker_nonroot_users:
- darkwizard242
- ubuntu
docker_add_nonroot_users: false
docker_centos_pre_reqs:
- device-mapper-persistent-data
- lvm2
docker_centos_pre_reqs_desired_state: present
docker_repo_centos: https://download.docker.com/linux/centos/7/$basearch/stable
docker_repo_centos_gpg_key: https://download.docker.com/linux/centos/gpg
docker_repo_centos_name: docker-ce-stable
docker_repo_centos_description: Docker CE Stable - $basearch
docker_repo_centos_gpgcheck: yes
docker_repo_centos_enabled: yes
docker_repo_centos_filename: docker-ce
docker_repo_centos_desired_state: present
docker_debian_pre_reqs:
- apt-transport-https
- ca-certificates
- curl
- gnupg
- lsb-release
docker_debian_pre_reqs_desired_state: present
docker_repo_debian: "deb [arch={{ ansible_architecture }}] https://download.docker.com/linux/debian {{ ansible_lsb['codename'] }} stable"
docker_repo_debain_filename: docker-ce
docker_repo_debian_desired_state: present
Tabla de Variables:
| Variable | Descripción |
|---|---|
| docker_architecture_map | Variable para tipos de arquitectura del sistema. |
| docker_apps | Nombre de los paquetes de aplicación de docker que se requieren para ser instalados, es decir, docker-ce, docker-ce-cli, containerd.io |
| docker_apps_desired_state | Estado de los paquetes docker_apps (es decir, docker-ce, docker-ce-cli, containerd.io). Ya sea instalar, verificar si están disponibles o desinstalar (valores del módulo ansible apt: present, latest, o absent) |
| docker_service_name | Nombre del servicio predeterminado para Docker. |
| docker_service_desired_state | Estado deseado para el servicio de Docker. |
| docker_service_desired_boot_enabled | Estado deseado habilitado/deshabilitado para el servicio de Docker. |
| docker_group | Nombre del grupo al que pertenecerá el propietario de docker. Cualquier usuario que necesite usar la aplicación docker debe ser miembro del grupo docker. |
| docker_group_desired_state | present indica crear el grupo si no existe. La alternativa es absent. |
| docker_user | Nombre del usuario que será el propietario de docker. |
| docker_user_home | Directorio personal del usuario de docker. |
| docker_user_shell | Shell para docker_user. |
| docker_user_desired_state | present indica crear el usuario si no existe. La alternativa es absent. |
| docker_nonroot_users | Lista de usuarios para agregar al grupo docker. |
| docker_add_nonroot_users | Variable booleana. Los valores pueden ser true o false. Establecer en true ejecutará la tarea que agregará a los usuarios proporcionados en la variable docker_nonroot_users al grupo docker. Si se establece en false, se omite la tarea específica que agrega usuarios al grupo docker. Por defecto es false. |
| docker_repo_gpg_key | GPG repo para el repositorio de docker. |
| docker_centos_pre_reqs | Docker recomienda la instalación de estos dos paquetes en el sistema host de EL/CentOS y, por lo tanto, se consideran requisitos previos. |
| docker_centos_pre_reqs_desired_state | Estado deseado para las aplicaciones de requisitos previos de Docker en sistemas EL/CentOS. |
| docker_repo_centos | URL base del repositorio para Docker en sistemas basados en EL/CentOS. |
| docker_repo_centos_name | Nombre del repositorio para Docker en sistemas basados en EL/CentOS. |
| docker_repo_centos_description | Descripción que se agregará al archivo del repositorio de EL/CentOS para Docker. |
| docker_repo_centos_gpgcheck | Booleano para verificar si se realiza la verificación gpg contra Docker en sistemas basados en EL/CentOS. |
| docker_repo_centos_enabled | Booleano para habilitar el repositorio de Docker en sistemas basados en EL/CentOS. |
| docker_repo_centos_filename | Nombre del archivo del repositorio que se almacenará en /yum/sources.list.d/docker-ce.repo en sistemas basados en EL/CentOS. |
| docker_repo_centos_desired_state | present indica crear el archivo del repositorio si no existe en sistemas basados en EL/CentOS. La alternativa es absent (no recomendado, ya que impedirá la instalación de paquetes docker). |
| docker_debian_pre_reqs_desired_state | Estado deseado para las aplicaciones de requisitos previos de Docker en sistemas de familia Debian. |
| docker_repo_debian | URL del repo de Docker para sistemas Debian. Utiliza hechos como ansible_architecture. |
| docker_repo_debain_filename | Nombre del archivo del repositorio que se almacenará en /etc/apt/sources.list.d/ en sistemas basados en Debian. |
| docker_repo_debian_desired_state | present indica crear el archivo del repositorio si no existe en sistemas basados en Debian. La alternativa es absent (no recomendado, ya que impedirá la instalación de paquetes docker). |
Dependencias
Ninguna
Ejemplo de Playbook
Para el comportamiento predeterminado del rol (es decir, instalación del paquete docker) en los playbooks de ansible.
- hosts: servers
roles:
- darkwizard242.docker
Para personalizar el comportamiento del rol (es decir, agregar una lista de usuarios al grupo de docker - el ejemplo a continuación agrega ubuntu y darkwizard al grupo docker) en los playbooks de ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_add_nonroot_users: true
docker_nonroot_users:
- darkwizard242
- ubuntu
Para personalizar el comportamiento del rol (es decir, omitir la tarea que agrega una lista de usuarios al grupo docker) en los playbooks de ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_add_nonroot_users: false
Para personalizar el comportamiento del rol (es decir, desinstalación de los paquetes docker-ce, docker-ce-cli, containerd.io) en los playbooks de ansible.
- hosts: servers
roles:
- darkwizard242.docker
vars:
docker_apps_desired_state: absent
Licencia
Información del Autor
Este rol fue creado por Ali Muhammad.
Acerca del proyecto
Docker-ce stable version installation/uninstallation.
Instalar
ansible-galaxy install darkwizard242.dockerLicencia
mit
Descargas
4.9k
Propietario
Senior DevOps/CloudOps Engineer.
Dedicated to Automating everything I come across.
Love to work on and learn new technologies/tools everyday!