¿Cómo instalar automáticamente los roles de Ansible Galaxy?

Todos mis libros de jugadas / roles de Ansible se registran en mi repositorio de git.

Sin embargo, para los roles de Ansible Galaxy siempre tengo que descargarlos explícitamente uno por uno en cada máquina desde la que quiero ejecutar Ansible.

Incluso es difícil saber de antemano exactamente qué roles de Ansible Galaxy son necesarios hasta que Ansible se queje de un rol faltante en tiempo de ejecución.

¿Cómo se supone que uno debe administrar las dependencias del rol Ansible Galaxy? Me gustaría hacer que se registren en mi repositorio de git junto con el resto de mi código ansible o que se identifiquen y descarguen automáticamente cuando ejecuto Ansible en una nueva máquina.

Debe usar un requirements.ymlarchivo para este caso de uso. Describa los roles que necesita, utilizando cualquiera de los diversos métodos de instalación:

# Install a role from the Ansible Galaxy
- src: dfarrell07.opendaylight

# Install a role from GitHub
- name: opendaylight
  src: https://github.com/dfarrell07/ansible-opendaylight

# Install a role from a specific git branch
- name: opendaylight
  src: https://github.com/dfarrell07/ansible-opendaylight
  version: origin/master

# Install a role at a specific tag from GitHub
- name: opendaylight
  src: https://github.com/dfarrell07/ansible-opendaylight
  version: 1.0.0

# Install a role at a specific commit from GitHub
- name: opendaylight
  src: https://github.com/dfarrell07/ansible-opendaylight
  version: <commit hash>

Luego instálalos:

ansible-galaxy install -r requirements.yml

Aquí hay un ejemplo de trabajo (instalación de OpenDaylight usando Ansible como un aprovisionador vagabundo). Consulte los documentos relevantes de Ansible para obtener más información.

Como se sugiere, puede usar galaxia ansible para esta necesidad.

Ansible tiene una función donde puede crear un requirements.ymlarchivo que enumera todas sus funciones. Puede averiguar sobre eso aquí: http://docs.ansible.com/ansible/latest/galaxy.html#installing-multiple-roles-from-a-file

Por ejemplo (require.yml):

- src: yatesr.timezone

Luego se ejecuta ansible-galaxy install -r requirements.ymlen este archivo para descargar todos los roles enumerados allí.

Si desea automatizarlo aún más, puede crear un script de shell simple que ejecute los dos comandos.

Por ejemplo (ansible.sh):

./ansible.sh

ansible-galaxy install -r requirements.yml
ansible-playbook playbook.yml -i inventory 

A menudo me encuentro instalando instalando un JDK de Java. Usar un rol hace que ese toque sea más fácil. He intentado un par de formas diferentes (incluyendo muchos .gitmodules y submódulos ... Tengo que usar múltiples sistemas git para el trabajo y todo se vuelve feo). Mi mayor requisito es que no verifique el código de rol en mi proyecto de libro de jugadas, principalmente para poder mantener todo en un solo lugar.

El contenido de mi archivo 'require.yml':

- src: https://github.com/staylorx/ansible-role-wls-prep.git
  version: master
  name: staylorx.wls-prep

- src: https://my-work-git-extravaganza.com
  version: 2.x
  name: coolplace.niftyrole

#From Ansible Galaxy
- src: staylorx.oracle-jdk

Ejecuto un libro de jugadas separado, install-roles.yml:

---

- hosts: localhost

  tasks:
    - file:
        path:  roles
        state: absent

    - local_action:
        command ansible-galaxy install -r requirements.yml --roles-path roles

    - lineinfile:
        dest:   .gitignore
        regexp: '^\/roles$'
        line:   '/roles'
        state:  present

Ejecuto este primer libro de jugadas, luego ejecuto mis roles en cualquier libro de jugadas normalmente. Para mí, el secreto es asegurar que git lo ignore para que no revise los roles por error. Además, como elimino la carpeta cada vez, me aseguro de no tener que forzar o ignorar los errores.

Otra solución es usar submódulos git. Después de todo, Ansible Galaxy solo es un directorio de repositorios de github ...

Uso este comando para agregar automáticamente cualquier rol Galaxy como submódulo:

ansible-galaxy info <package> | grep -A 1 github_repo | tr '\n' ' ' | sed -e "s/.*github_repo: \([^[:space:]]*\)[^\w]*github_user: \([^[:space:]]*\)[[:space:]]*/git submodule add git:\/\/github.com\/\2\/\1.git roles\/\2.\1/g" | sh

Confirma los cambios en tu repositorio de git. Cuando clone su repositorio en el futuro, asegúrese de clonarlo con submódulos, p. Ej.git clone ... --recursive

Una ventaja de esto es que un submódulo git siempre hace referencia a una versión específica (git commit-hash). Esto evitará que ejecute actualizaciones no probadas en su entorno productivo. Una nueva versión de un rol Galaxy podría tener errores o funcionar completamente diferente que antes. Con un submódulo git, usted decide si y cuándo actualiza un rol a la nueva versión.

Además, no tendrá que ocuparse adicionalmente de incluir en la lista negra los roles de galaxias en su .gitignorepara evitar comprometer su código en su repositorio.

Puede usar un rol Ansible para instalar los roles necesarios utilizando el módulo de comando .

Aquí hay un ejemplo muy básico que se ejecuta ansible-galaxy install:

- name: Install roles from Ansible Galaxy
  command: ansible-galaxy install {{ item.item }}
  with_items:
    - "{{ ansible_roles_list }}"

El ansible_roles_listpuede ser suministrado como una variable o como un parámetro de rol.

Si hace esto en un rol, debe aplicarse antes que cualquier otro rol que desee instalar usándolo, en un libro de jugadas separado. Esto se debe a que Ansible verifica si todos los roles están disponibles antes de ejecutar el libro de jugadas donde los referencia.

En este momento, hasta donde yo sé, no hay una forma automática de descargar roles en tiempo de ejecución. Su mejor opción es comprometerlos en su propio repositorio o tener una documentación adecuada que enumere todos los requisitos. Incluso podría crear un libro de jugadas previo al vuelo que instale sus roles. :)

Aquí, mis requisitos están en el rol y se usan en install.yml

main.yml

 # tasks file for MY_ROLE
- name: Install requirements
  local_action: command ansible-galaxy install -r {{ role_path }}/requirements.yml -p /etc/ansible/roles

- include_tasks: install.yml 

.  
├── playbook.yml  
├── inventory  
├── roles  
│    └── My_Role   
│        ├── tasks  
│        │   └── main.yml  
│        │   └── install.yml  
│        └── requirements.yml