Colección de Ansible para la administración de Nextcloud

Este repositorio alberga la Colección de Ansible nextcloud.admin (anteriormente el rol aalaesar.install_nextcloud).

La colección incluye una variedad de contenido de Ansible para ayudar a automatizar la gestión de Nextcloud, así como la provisión y mantenimiento de instancias de Nextcloud.

Compatibilidad con versiones de Ansible

Esta colección ha sido probada con las siguientes versiones de Ansible: >=2.14.0.

Los plugins y módulos dentro de una colección pueden ser probados solo con versiones específicas de Ansible.

Soporte de Python

• Colección probada en 3.11+

Versiones de Nextcloud soportadas

Esta colección soporta las versiones de Nextcloud: 25, 26, 27 (última)

Contenido incluido

Módulos

Roles

Instalación y uso

Dependencias

Biblioteca Python netaddr

El contenido de esta colección requiere la biblioteca de manipulación de direcciones de red para manipular direcciones de red. Puedes instalarla con:

    pip3 install netaddr

roles independientes requeridos

Por defecto, algunos roles en esta colección dependen de roles independientes de otros espacios de nombres. (esto se puede desactivar).

Debido a algunas limitaciones, ansible-galaxy no los instala automáticamente, por lo que necesitarás instalarlos después.

Una vez que la colección esté instalada, ejecuta el comando ansible-galaxy role install -r <esta_carpeta_de_colección>/requirements.yml.

Alternativamente, también puedes agregar el contenido de este archivo en tu propio archivo requirements.yml antes de instalar la colección.

Instalando la colección desde Ansible Galaxy

Antes de usar la colección de Nextcloud, necesitas instalarla con el CLI de Ansible Galaxy:

ansible-galaxy collection install nextcloud.admin

También puedes incluirla en un archivo requirements.yml e instalarla mediante ansible-galaxy collection install -r requirements.yml, usando el formato:

---
collections:
  - name: nextcloud.admin
    version: 2.0.0

Usando módulos de la colección Nextcloud en tus playbooks

Es preferible usar el contenido de esta colección utilizando su Espacio de Nombres de Colección Totalmente Calificado (FQCN), por ejemplo nextcloud.admin.run_occ:

---
- hosts: nextcloud_host
  gather_facts: false
  become: true
  tasks:
    - name: listar apps instaladas
      nextcloud.admin.run_occ:
        nextcloud_path: /var/www/nextcloud
        command: app:list

Si actualizas playbooks antiguos de <2.0.0, puedes minimizar tus cambios definiendo collections en tu playbook y refiriéndote al rol de esta colección como install_nextcloud, en lugar de nextcloud.admin.install_nextcloud, como en este ejemplo:

---
- hosts: localhost
  gather_facts: false
  connection: local

  collections:
    - nextcloud.admin

  tasks:
    - name: desplegar nextcloud y dependencias
      include_role:
        name: install_nextcloud
        # anteriormente:
        # name: aalaesar.install_nextcloud

Para la documentación sobre cómo usar:

• módulos individuales: utiliza el comando ansible-doc después de instalar esta colección.
• roles incluidos: según el estándar de Ansible, los roles de Ansible están documentados en su propio archivo README.

Pruebas y desarrollo

Si deseas desarrollar nuevo contenido para esta colección o mejorar lo que ya está aquí, la forma más fácil de trabajar en la colección es clonarla en una de las rutas configuradas COLLECTIONS_PATHS, y trabajar allí.

Pruebas con molecule

El directorio tests contiene playbooks para realizar pruebas de integración en varios escenarios. También hay pruebas de integración en el directorio molecule.

Publicación de nuevas versiones

Las versiones se construyen y suben automáticamente a Ansible Galaxy para cualquier nueva etiqueta.

Licencia

BSD

Consulta la LICENCIA para ver el texto completo.