Aller au contenu principal

Dépôts

Un dépôt est un endroit où stocker et gérer du contenu Ansible tel que des playbooks et des rôles.

Semaphore reconnaît les dépôts suivants :

  • un système de fichiers local (/path/to/the/repo)
  • un dépôt Git local (file://)
  • un dépôt Git distant accessible via HTTPS (https://) ou SSH (ssh://)
  • le protocole git:// est pris en charge, mais il n'est pas recommandé pour des raisons de sécurité.

Tous les modèles de tâches nécessitent un dépôt pour s'exécuter.

Authentification​

Si vous utilisez un dépôt distant nécessitant une authentification, vous devrez configurer une clé dans la section Magasin de clés de Semaphore.

Pour les dépôts distants utilisant SSH, vous devrez utiliser votre clé SSH dans le magasin de clés.

Pour les dépôts distants sans authentification, vous pouvez créer une clé de type None.

Créer un nouveau dépôt​

  1. Assurez-vous d'avoir configuré, dans la section du magasin de clés, la clé correspondant au dépôt que vous allez ajouter.

  2. Allez dans la section Dépôts de Semaphore et cliquez sur le bouton Nouveau dépôt dans le coin supérieur droit.

  3. Configurez le dépôt :

    • Nommez le dépôt
    • Ajoutez l'URL. L'URL doit commencer par l'un des éléments suivants :
      • /path/to/the/repo pour un dossier local sur le système de fichiers
      • https:// pour un dépôt Git distant accessible via HTTPS
      • ssh:// pour un dépôt Git distant accessible via SSH
      • file:// pour un dépôt Git local
      • git:// pour un dépôt Git distant accessible via le protocole Git
    • Définissez la branche du dépôt ; si vous n'êtes pas sûr, il s'agit probablement de master ou main
    • Sélectionnez la clé d'accès que vous avez configurée avant de créer ce dépôt.

  4. Cliquez sur Enregistrer une fois la configuration terminée.

Modifier un dépôt existant​

  1. Allez dans la section Dépôts de Semaphore.

  2. Cliquez sur l'icône en forme de crayon à côté du dépôt à modifier ; la configuration du dépôt s'affiche alors.

Supprimer un dépôt​

Assurez-vous que le dépôt à supprimer n'est utilisé par aucun modèle de tâche. Un dépôt ne peut pas être supprimé s'il est utilisé dans un modèle de tâche :

  1. Allez dans la section Dépôts de Semaphore.

  2. Cliquez sur l'icône de corbeille du dépôt à supprimer.

  3. Cliquez sur Oui dans la fenêtre de confirmation si vous êtes sûr de vouloir supprimer ce dépôt.

Requirements​

Lors de l'initialisation du projet, Semaphore recherche et installe les rôles et collections Ansible à partir des fichiers requirements.yml situés aux emplacements suivants, dans cet ordre.

Rôles​

  • playbook_dir/roles/requirements.yml
  • playbook_dir/requirements.yml
  • repo_path/roles/requirements.yml
  • repo_path/requirements.yml

Collections​

  • playbook_dir/collections/requirements.yml
  • playbook_dir/requirements.yml
  • repo_path/collections/requirements.yml
  • repo_path/requirements.yml

Logique de traitement​

  • Chaque fichier est traité indépendamment
  • Si un fichier existe, il est traité selon son type (rôle ou collection)
  • Si le traitement d'un fichier produit une erreur, le processus d'installation s'arrête et renvoie l'erreur
  • Le même fichier requirements.yml situé dans les répertoires racines (playbook_dir/requirements.yml et repo_path/requirements.yml) est traité deux fois : une fois pour les rôles et une fois pour les collections

Semaphore tente de traiter tous ces emplacements, que les emplacements précédents aient été trouvés ou traités avec succès ou non, sauf en cas d'erreur.