gantsign.antigen_bundles

Rola Ansible: Antigen Bundles

Rola Ansible do dodawania pakietów do Twojej konfiguracji Antigen dla Zsh. Można ją używać w połączeniu z tagami Ansible do warunkowej instalacji określonych pakietów.

Ważne: Musisz zainstalować Antigen przy użyciu roli gantsign.antigen oraz skonfigurować Antigen dla tego samego użytkownika, aby ta rola działała.

:thumbsdown: Powiadomienie o deprecjacji :thumbsdown:

Ostatnia wersja Antigen to v2.2.3 z 4 stycznia 2018. Ponieważ Antigen wydaje się już nie być rozwijany, odradzamy korzystanie z tej roli. Rola ta będzie nadal utrzymywana, dopóki GantSign nie przejdzie na inny menedżer wtyczek Zsh.

Wymagania

Ansible >= 2.9
Dystrybucja Linux
- Rodzina Debian
  - Debian
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Rodzina RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Rodzina SUSE
  - openSUSE
    - 15.3
- Uwaga: inne wersje mogą działać, ale nie były testowane.

Zmienna Roli

Poniższe zmienne zmieniają zachowanie tej roli:

# Antigen jest konfigurowany per użytkownik, więc musisz określić użytkowników, dla których chcesz go zainstalować
users:
  - username: # Nazwa użytkownika, dla którego chcesz zainstalować Antigen
    antigen_bundles:
      - name: # Nazwa pakietu Antigen (np. jedna z wtyczek, które są dołączone do Oh-My-Zsh)
        url: # Opcjonalne. Jeśli nie jest to jedna z wtyczek Oh-My-Zsh, musisz podać URL (użyj skrótu owner/repo dla GitHub)
        location: # Opcjonalne. Katalog w repozytorium zawierający wtyczkę
        branch: # Opcjonalne. Gałąź Gita do wycheckoutowania.
        tag: # Opcjonalne. Etykieta Gita do wycheckoutowania (ma pierwszeństwo przed gałęzią)
        args: [] # Opcjonalne. Argumenty wiersza poleceń do przekazania do Antigen
        env: {} # Opcjonalne. Zmienne środowiskowe do ustawienia
      # więcej pakietów tutaj
  # więcej użytkowników tutaj

Przykład Playbooks

Przykład z samą konfiguracją tej roli:

- hosts: servers
  roles:
    - role: gantsign.antigen_bundles
      users:
        - username: example
          antigen_bundles:
            # Pakiet z domyślnego repozytorium (oh-my-zsh robbyrussella)
            - name: command-not-found
            # Pakiet do podświetlania składni
            - name: zsh-syntax-highlighting # `name` jest wymagane (dowolna poprawna nazwa pliku, o ile jest unikalna w przypadku pakietów)
              url: zsh-users/zsh-syntax-highlighting

Przykład z wymagającą rolą towarzyszącą gantsign.antigen:

- hosts: servers
  roles:
    - role: gantsign.antigen
      users:
        - username: example
          antigen_libraries:
            - name: oh-my-zsh
          antigen_theme:
            name: robbyrussell
          antigen_bundles:
            - name: command-not-found
            - name: docker
            - name: git

    - role: gantsign.antigen_bundles
      tags:
        - java
      users:
        - username: example
          antigen_bundles:
            - name: mvn

W powyższym przykładzie pakiet/plugin mvn nie zostanie zainstalowany, jeśli powiesz Ansible, aby pominął zadania z tagiem java.

Więcej ról od GantSign

Więcej ról od GantSign można znaleźć na Ansible Galaxy.

Rozwój i Testowanie

Ten projekt korzysta z Molecule aby pomóc w rozwoju i testowaniu; rola jest testowana jednostkowo za pomocą Testinfra oraz pytest.

Aby rozwijać lub testować, musisz zainstalować następujące:

Linux (np. Ubuntu)
Docker
Python (w tym python-pip)
Ansible
Molecule

Ponieważ powyższe może być trudne do zainstalowania, ten projekt zawiera Molecule Wrapper. Molecule Wrapper to skrypt powłoki, który instaluje Molecule i jego zależności (poza Linuxem) i następnie wykonuje Molecule z poleceniem, które mu przekażesz.

Aby przetestować tę rolę za pomocą Molecule Wrapper uruchom następujące polecenie z katalogu głównego projektu: