Ansible ASDF Rolle

Eine Ansible-Rolle, die den asdf Versionsmanager mit Plugins installiert.

Anforderungen

Keine

Rollenvariablen

Verfügbare Variablen sind unten aufgeführt, zusammen mit Standardwerten (siehe defaults/main.yml). Die Variable asdf_plugins gibt eine Liste von zu installierenden Plugins an:

asdf_plugins: []

Jedes Plugin kann in folgendem Format angegeben werden:

asdf_plugins:
  - name: "erlang"    # ein Pluginname
    repository: ""    # ein Plugin-Repository, optional
    versions:         # eine Liste von zu installierenden Versionen
      - 18.3
      - 20.1
    global: 20.1      # als globale Version festlegen, optional

Die Variable asdf_user legt den Benutzer fest, für den die Rolle installiert wird:

asdf_user: "deploy"

Standardmäßig installiert die Rolle asdf und seine Plugins im ~/.asdf für diesen Benutzer. Dieses Verhalten kann durch Setzen von asdf_dir geändert werden. Dies ist nützlich in Situationen, in denen mehrere Benutzer auf installierte Plugins und Tools zugreifen müssen (z. B. ein Deploy-Benutzer, der App-Benutzer und möglicherweise Entwickler).

asdf_dir: "/opt/asdf-vm"

Die Variable asdf_legacy_version_file gibt an, ob Plugins, die diese Funktion unterstützen, die Versionsdateien lesen sollen, die von anderen Versionsmanagern verwendet werden (z. B. .ruby-version im Fall von Rubys rbenv).

asdf_legacy_version_file: "ja"

Die Variable asdf_plugin_dependencies legt die Pakete fest, die für die Plugins benötigt werden (siehe defaults/main.yml):

asdf_plugin_dependencies: []

Die Variable asdf_version legt das Git-Tag von asdf fest:

asdf_version: v0.9.0

Abhängigkeiten

Keine

Beispiel-Playbook

Ein Beispiel-Playbook ist unten angegeben:

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

Ein komplexeres Beispiel für CentOS:

- name: asdf installieren
  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

Installation von asdf in ein gemeinsames Verzeichnis, das für die Gruppe developers zugänglich ist:

- name: asdf installieren
  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

Lizenz

Lizenziert unter der MIT-Lizenz.