Rola Ansible ASDF

Rola Ansible, która instaluje menedżera wersji asdf z wtyczkami.

Wymagania

Brak

Zmienne roli

Dostępne zmienne są wymienione poniżej, wraz z wartościami domyślnymi (zobacz plik defaults/main.yml). Zmienna asdf_plugins określa listę wtyczek do zainstalowania:

asdf_plugins: []

Każdą wtyczkę można podać w następującym formacie:

asdf_plugins:
  - name: "erlang"    # nazwa wtyczki
    repository: ""    # repozytorium wtyczki, opcjonalne
    versions:         # lista wersji do zainstalowania
      - 18.3
      - 20.1
    global: 20.1      # ustaw jako wersję globalną, opcjonalne

Zmienna asdf_user ustawia użytkownika, dla którego rola jest instalowana:

asdf_user: "deploy"

Domyślnie rola instaluje asdf i jego wtyczki w ~/.asdf dla tego użytkownika. To zachowanie można zmienić, ustawiając asdf_dir. To jest przydatne w sytuacjach, gdzie wielu użytkowników potrzebuje dostępu do zainstalowanych wtyczek i narzędzi (np. użytkownik do wdrożeń, użytkownik aplikacji i potencjalnie użytkownicy deweloperscy).

asdf_dir: "/opt/asdf-vm"

Zmienna asdf_legacy_version_file określa, czy wtyczki, które obsługują tę funkcję, powinny czytać pliki wersji używane przez inne menedżery wersji (np. .ruby-version w przypadku rbenv dla Ruby).

asdf_legacy_version_file: "tak"

Zmienna asdf_plugin_dependencies ustawia pakiety potrzebne do wtyczek (zobacz defaults/main.yml):

asdf_plugin_dependencies: []

Zmienna asdf_version ustawia tag git dla asdf:

asdf_version: v0.9.0

Zależności

Brak

Przykład playbooka

Przykład playbooka jest podany poniżej:

- hosts: web
  roles:
  - rola: ansible-role-asdf
    asdf_plugins:
    - name: "erlang"
      versions: ["18.3", "20.1"]
      global: "20.1"
    - name: "elixir"
      versions: "1.3.1"

Bardziej złożony przykład dla CentOS to:

- name: instalacja asdf
  hosts: '*'
  become: true
  vars:
    asdf_version: v0.6.2
    asdf_user: ci
    asdf_plugins:
      - name: erlang
      - name: elixir
      - name: nodejs
        versions: ["8.11.3"]
        global: "8.11.3"
  roles:
    - asdf

Instalacja asdf w udostępnionym katalogu dostępnym dla grupy developers:

- name: instalacja asdf
  hosts: '*'
  become: true
  vars:
    asdf_user: deploy
    asdf_group: developers
    asdf_dir: /opt/asdf-vm
    asdf_plugins:
      - name: erlang
      - name: elixir
      - name: nodejs
        versions: ["8.11.3"]
        global: "8.11.3"
  roles:
    - asdf

Licencja

Licencjonowane na mocy Licencji MIT.