antigen_bundles

Роль Ansible: Пакеты Antigen

Роль Ansible для добавления пакетов в вашу конфигурацию Antigen для Zsh. Полезно сочетать эту роль с метками Ansible для условной установки определенных пакетов.

Важно: необходимо установить Antigen с помощью роли gantsign.antigen (и настроить Antigen для того же пользователя), чтобы эта роль работала.

:thumbsdown: Уведомление об устаревании :thumbsdown:

Последний релиз Antigen был v2.2.3 4 января 2018 года. Поскольку Antigen, похоже, больше не поддерживается, мы не рекомендуем использовать эту роль. Эта роль будет поддерживаться до тех пор, пока GantSign не перейдет на другой менеджер плагинов для Zsh.

Требования

Ansible >= 2.9
Дистрибутив Linux
- Семейство Debian
  - Debian
    - Stretch (9)
    - Buster (10)
    - Bullseye (11)
  - Ubuntu
    - Bionic (18.04)
    - Focal (20.04)
- Семейство RedHat
  - Rocky Linux
    - 8
  - Fedora
    - 35
- Семейство SUSE
  - openSUSE
    - 15.3
- Примечание: другие версии, вероятно, будут работать, но не тестировались.

Переменные роли

Следующие переменные изменят поведение этой роли:

# Antigen настраивается для каждого пользователя, поэтому вам нужно указать пользователей для установки
users:
  - username: # Имя пользователя для установки Antigen
    antigen_bundles:
      - name: # Имя пакета Antigen (например, один из плагинов, входящих в состав Oh-My-Zsh)
        url: # Необязательно. Если это не один из плагинов Oh-My-Zsh, вы должны указать URL (используйте сокращение owner/repo для GitHub)
        location: # Необязательно. Директория в репозитории, содержащая плагин
        branch: # Необязательно. Git ветка для проверки.
        tag: # Необязательно. Git тег для проверки (приоритетнее, чем ветка)
        args: [] # Необязательно. Аргументы командной строки для передачи Antigen
        env: {} # Необязательно. Переменные окружения для установки
      # дополнительные пакеты здесь
  # дополнительные пользователи здесь

Примеры плейбуков

Пример, показывающий только конфигурацию для этой роли:

- hosts: servers
  roles:
    - role: gantsign.antigen_bundles
      users:
        - username: example
          antigen_bundles:
            # Пакет из стандартного репозитория (oh-my-zsh от robbyrussell)
            - name: command-not-found
            # Пакет для подсветки синтаксиса
            - name: zsh-syntax-highlighting # `name` обязателен (любое допустимое имя файла подойдет, если оно уникально для пакетов)
              url: zsh-users/zsh-syntax-highlighting

Пример с требуемой сопутствующей ролью 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

В приведенном выше примере пакет/плагин mvn не будет установлен, если вы скажете Ansible пропустить задачи с меткой java.

Другие роли от GantSign

Вы можете найти больше ролей от GantSign на Ansible Galaxy.

Разработка и тестирование

Этот проект использует Molecule для помощи в разработке и тестировании; роль тестируется с использованием Testinfra и pytest.

Чтобы разработать или протестировать, вам необходимо установить следующее:

Linux (например, Ubuntu)
Docker
Python (включая python-pip)
Ansible
Molecule

Так как установка вышеуказанного может быть сложной, этот проект включает Molecule Wrapper. Molecule Wrapper — это shell-скрипт, который устанавливает Molecule и его зависимости (кроме Linux), а затем выполняет Molecule с командой, которую вы ему передаете.

Чтобы протестировать эту роль с использованием Molecule Wrapper, выполните следующую команду из корневого каталога проекта: