Guide utilisateur
Cette section s'adresse aux personnes qui ont déjà accès à un projet Semaphore. Tout se passe ici dans l'interface web ou via l'API du projet. L'installation du serveur, sa configuration et la connexion d'un fournisseur d'identité sont traitées dans le Guide d'administration.
Le travail dans Semaphore suit une seule chaîne. Un projet contient tout le reste. À l'intérieur, vous déclarez les ressources dont une exécution a besoin : un dépôt contenant vos playbooks ou scripts, les clés utilisées pour l'atteindre ainsi que vos hôtes, un inventaire des machines cibles et des groupes de variables avec des valeurs et des secrets. Un modèle de tâche combine tout cela en une définition de ce qu'il faut exécuter, et chaque exécution de ce modèle est une tâche. Les planifications, les workflows et les webhooks entrants démarrent les modèles à votre place.
Mettre en place un projet
Dans cet ordre, car chaque étape dépend de la précédente.
| Page | Contenu |
|---|---|
| Projets | Créer un projet, les sections de la barre latérale, la sauvegarde et la restauration. |
| Équipes | Les quatre rôles intégrés, et les rôles personnalisés sur Enterprise. |
| Magasin de clés | Clés SSH, identifiants de connexion et stockages de secrets externes. |
| Dépôts | Dépôts Git et chemins locaux qui contiennent votre automatisation. |
| Inventaire | Hôtes et paramètres de connexion pour Ansible, espaces de travail pour Terraform. |
| Groupes de variables | Variables et secrets réutilisables transmis aux tâches. |
Définir et exécuter le travail
| Page | Contenu |
|---|---|
| Modèles de tâches | Chaque champ du formulaire de modèle, ainsi que les types de modèle. |
| Applications | Ce que chaque application exécute : Ansible, Terraform, OpenTofu, Terragrunt et les scripts. |
| Tâches | Démarrer une tâche, statuts de tâche, journaux, arrêt et relance. |
| Planifications | Exécuter des modèles selon une planification cron. |
| Workflows | Enchaîner des modèles avec des approbations et des branchements. |
| Intégrations | Démarrer des tâches depuis des webhooks entrants. |
| Runners de projet | Envoyer les tâches d'un projet vers vos propres runners. |
| Votre compte | Paramètres personnels et tokens d'API. |
Par où commencer
Si quelqu'un vient de vous ajouter à un projet, lisez Projets pour vous repérer, puis Tâches pour en exécuter une et lire son journal. Si vous partez de zéro pour mettre en place un projet, suivez le tableau ci-dessus dans l'ordre.
Vous débutez complètement avec Semaphore ? Commencez par Premiers pas.