gantsign.antigen_bundles

Ansibleロール: Antigen Bundles

Zsh用のAntigen設定にバンドルを追加するためのAnsibleロールです。このロールは、特定のバンドルを条件付きでインストールするために、Ansibleタグと組み合わせると便利です。

重要: このロールを使用するには、gantsign.antigenロールを使用してAntigenをインストールし、同じユーザーのためにAntigenを設定しておく必要があります。

:thumbsdown: 廃止通知 :thumbsdown:

最後のAntigenのリリースは、2018年1月4日のv2.2.3でした。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に付属のプラグインの1つ）
        url: # 任意。Oh-My-Zshのプラグインでない場合、URLを指定する必要があります（GitHubのオーナー/リポシュート記法を使用）
        location: # 任意。プラグインが含まれるリポジトリ内のディレクトリ
        branch: # 任意。チェックアウトするGitブランチ。
        tag: # 任意。チェックアウトするGitタグ（ブランチより優先されます）
        args: [] # 任意。Antigenに渡すコマンドライン引数
        env: {} # 任意。設定する環境変数
      # ここにさらにバンドルを書いてください
  # ここにさらにユーザーを書いてください

例 Playbook

このロールの設定だけを示す例：

- hosts: servers
  roles:
    - role: gantsign.antigen_bundles
      users:
        - username: example
          antigen_bundles:
            # デフォルトリポジトリからのバンドル (robbyrussellのoh-my-zsh)
            - 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