Zbiór Ansible do zarządzania Nextcloud

To repozytorium zawiera kolekcję Ansible nextcloud.admin (wcześniej rola aalaesar.install_nextcloud).

Kolekcja zawiera różne zasoby Ansible, które pomagają automatyzować zarządzanie Nextcloud̨, a także tworzenie i konserwację instancji Nextcloud̨.

Kompatybilność z wersjami Ansible

Ta kolekcja była testowana z następującymi wersjami Ansible: >=2.14.0.

Wtyczki i moduły w kolekcji mogą być testowane tylko z określonymi wersjami Ansible.

Wsparcie dla Pythona

• Kolekcja testowana na wersji 3.11+

Obsługiwane wersje Nextcloud

Ta kolekcja wspiera wersje Nextcloud: 25, 26, 27 (najnowsza)

Zawartość

Moduły

Role

Instalacja i użycie

Wymagania

Biblioteka Python netaddr

Zawartość tej kolekcji wymaga biblioteki do manipulacji adresami sieciowymi. Możesz ją zainstalować za pomocą:

    pip3 install netaddr

wymagane samodzielne role

Domyślnie niektóre role w tej kolekcji są zależne od samodzielnych ról z innych nazw przestrzeni. (można to wyłączyć).

Z powodu niektórych ograniczeń, ansible-galaxy nie instaluje ich automatycznie, więc muszą być zainstalowane później.

Po zainstalowaniu kolekcji uruchom polecenie ansible-galaxy role install -r <folder_kolekcji>/requirements.yml.

Alternatywnie, możesz również dodać zawartość tego pliku do własnego pliku requirements.yml przed zainstalowaniem kolekcji.

Instalacja kolekcji z Ansible Galaxy

Zanim użyjesz kolekcji Nextcloud, musisz ją zainstalować za pomocą CLI Ansible Galaxy:

ansible-galaxy collection install nextcloud.admin

Możesz również uwzględnić ją w pliku requirements.yml i zainstalować za pomocą ansible-galaxy collection install -r requirements.yml, używając formatu:

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

Użycie modułów z kolekcji Nextcloud w swoich playbookach

Warto używać zawartości w tej kolekcji przy użyciu ich FQCN (Fully Qualified Collection Namespace), na przykład nextcloud.admin.run_occ:

---
- hosts: nextcloud_host
  gather_facts: false
  become: true
  tasks:
    - name: wyświetl zainstalowane aplikacje
      nextcloud.admin.run_occ:
        nextcloud_path: /var/www/nextcloud
        command: app:list

Jeśli aktualizujesz starsze playbooki z wersji <2.0.0, możesz zminimalizować zmiany, definiując collections w swoim playbooku i odwołując się do roli tej kolekcji jako install_nextcloud, zamiast nextcloud.admin.install_nextcloud, jak w tym przykładzie:

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

  collections:
    - nextcloud.admin

  tasks:
    - name: wdrożenie nextcloud i zależności
      include_role:
        name: install_nextcloud
        # wcześniej:
        # name: aalaesar.install_nextcloud

Dokumentacja dotycząca użycia:

• indywidualne moduły: proszę używać komendy ansible-doc po zainstalowaniu tej kolekcji.
• uwzględnione role: zgodnie ze standardem ansible, role ansible są dokumentowane w ich własnym pliku README.

Testowanie i rozwój

Jeśli chcesz rozwijać nową zawartość dla tej kolekcji lub poprawić to, co już jest, najłatwiej jest sklonować ją do jednego z skonfigurowanych COLLECTIONS_PATHS i pracować tam.

Testowanie z molecule

Katalog tests zawiera playbooki do przeprowadzania testów integracyjnych w różnych scenariuszach. Są również testy integracyjne w katalogu molecule.

Publikacja nowych wersji

Wydania są automatycznie budowane i publikowane w Ansible Galaxy dla każdego nowego tagu.

Licencja

BSD

Zobacz LICENCJA, aby zobaczyć pełny tekst.