Rola Ansible: GitHub Release

Ogólna rola do instalacji aplikacji binarnej wydanej na GitHubie w systemie Linux opartym na architekturze x86_64.

Wymagania

Rola jest przeznaczona dla systemów opartych na Debianie i RHEL, zbudowanych na architekturze x86_64.

Rola ma działać na zdalnej maszynie, co oznacza, że zdalna maszyna musi być podłączona do internetu.

Ta rola jest dość ogólna, więc należy zachować ostrożność przy instalacji pakietów.

Ważne: Zawsze przeglądaj pakiety, które chcesz zainstalować, ponieważ nie ma sposobu na weryfikację sumy kontrolnej pobrania w sposób ogólny.

Zmienne Roli

Wymagane:

ghr_org_name: # Nazwa ważnej organizacji GitHub
ghr_app_name: # Nazwa ważnego repozytorium GitHub, należącego do organizacji

Domyślne:

ghr_app_version: "latest" # Ważna wydana wersja z: https://github.com/{{ ghr_org_name }}/{{ ghr_app_name }}/releases/

ghr_app_binary_dest: "/opt/{{ ghr_app_name }}" # Katalog docelowy, w którym zostanie umieszczony plik binarny `ghr_app_name`

ghr_app_cleanup_after: false # Jeśli ustawione na true, wszystkie pobrane pliki zostaną usunięte

ghr_app_configure_system_path: true # Czy katalog `ghr_app_binary_dest` powinien być dodany do systemowego `PATH`
ghr_app_system_path_prepend: false # Czy dodać czy umieścić katalog `ghr_app_binary_dest` do `PATH`, JEŚLI (ghr_app_configure_system_path jest True).

ghr_app_tmp_dir: # Tymczasowy folder do przechowywania pobranego archiwum

ghr_app_releases_url: # Adres URL wydania na GitHubie.
ghr_app_archive: # Nazwa archiwum.

Zależności

Brak

Przykład Pliku Playbook

Uruchamianie roli wielokrotnie może prowadzić do konfliktów zmiennych.

Zalecane jest uruchamianie jednej roli na wykonanie hosta.

    - hosts: localhost
      roles:
        - role: nioniosfr.github_release
          vars:
            ghr_org_name: "digitalocean"
            ghr_app_name: "doctl"
            ghr_app_version: "1.18.0"
            ghr_app_tmp_dir: "/mnt/nfs_share/downloads" # Przechowuj pobrane archiwum w bardziej trwałej lokalizacji niż '/tmp'

    - hosts: localhost
      roles:
        - role: nioniosfr.github_release
          vars:
            ghr_org_name: "stedolan"
            ghr_app_name: "jq"
            ghr_app_version: "1.6"
            ghr_app_releases_endpoint: "{{ ghr_app_name }}-{{ ghr_app_version }}"
            ghr_app_archive: "{{ ghr_app_name }}-linux64"
            ghr_app_is_binary: true

    - hosts: localhost
      roles:
        - role: nioniosfr.github_release
          vars:
            ghr_org_name: "digitalocean"
            ghr_app_name: "doctl"
            ghr_app_version: "1.18.0"
            ghr_app_binary_dest: "/usr/local/bin" # Instalacja w wspólnej ścieżce użytkownika
            ghr_app_configure_system_path: false # Nie manipuluj systemową ścieżką dla użytkowników
            ghr_app_tmp_dir: "/mnt/nfs_share/downloads" # Zmień folder używany do pobrań
            ghr_app_cleanup_after: true # Usuń zarówno pobrany plik, jak i profil systemowy dla `app`, jeśli był już utworzony podczas poprzedniego wykonania

Licencja

MIT

Informacje o autorze

NioniosFr