xanmanning.github_downloader

Rôle Ansible : github_downloader

Rôle Ansible pour télécharger des fichiers binaires à partir d'une version d'un dépôt GitHub vers un emplacement désiré.

Exigences

Ce rôle a été testé sur Ansible 2.10.0+ et devrait fonctionner sur des plateformes basées sur Linux/UNIX.

Avertissement

Si vous rencontrez des problèmes, veuillez créer un problème sur GitHub, je maintiens ce rôle pendant mon temps libre, donc je ne peux pas promettre une solution rapide.

Variables du rôle

Voici une liste de variables. Pour une description plus détaillée, veuillez vous référer à defaults/main.yml.

Variable	Description courte	Valeur par défaut
`github_download_packages`	Liste des binaires à télécharger. Voir exemple ci-dessous.	`[]`
`github_download_location`	Emplacement où télécharger.	`$HOME/bin`
`github_download_pat_token`	Token PAT pour interroger l'API	Aucun
`github_download_hostname`	Nom d'hôte pour GitHub.	`github.com`
`github_download_api_hostname`	Nom d'hôte pour l'API GitHub.	`api.github.com`

Modèles de noms de fichiers

Les variables suivantes peuvent être utilisées dans les noms de fichiers et seront remplacées par des valeurs découvertes par Ansible facts.

Variable	Description	Exemple
`%ARCH%`	Architecture du système d'exploitation	`amd64`
`%ARCHRAW%`	Architecture du système (ne remplace pas `x86_64` par `amd64`)	`x86_64`
`%OS%`	Famille du système d'exploitation (minuscules)	`linux` / `darwin`
`%OSCAPITALIZED%`	Famille du système d'exploitation (majuscules)	`Linux` / `Darwin`
`%VERSION%`	Version du package	`v1.20.0`
`%NVERSION%`	Version du package (sans le préfixe `v`)	`1.20.0`

Dépendances

Pas de dépendances sur d'autres rôles.

Exemple de Playbook

Exemple de playbook pour créer une liste d'utilisateurs à partir de GitHub.

- hosts: all
  become: true
  vars:
    github_download_packages:
      - name: package_name
        repo: owner/repo
        version: 1.0.2  # Peut être 'latest'
        filename: package_name-%VERSION%-%OS%-%ARCH%.tar.gz  # Voir modèles de noms de fichiers dans README.md
        extracted_filename: package_name-%VERSION%
        command: package_name install
        command_become: false  # devenir root pour cette commande
  roles:
    - role: xanmanning.github_downloader