Premiers pas
Cette page vous guide depuis une installation fraîche jusqu'à votre première tâche réussie. Chaque étape renvoie vers la page contenant les détails.
De zéro à la première tâche
- Installez Semaphore avec la méthode de votre choix : Installation.
- Connectez-vous avec l'utilisateur administrateur créé lors de l'installation, ou via les variables
SEMAPHORE_ADMIN_*sous Docker. - Créez un projet. Un projet isole les équipes, les infrastructures ou les applications les unes des autres : Projets.
- Connectez ce dont votre automatisation a besoin :
- Le code source contenant les playbooks, modules ou scripts : Dépôts.
- Les clés SSH, tokens et mots de passe : Coffre de clés.
- Les hôtes cibles et les paramètres de connexion : Inventaire.
- Les variables réutilisables : Groupes de variables.
- Créez un modèle de tâche et exécutez-le. Choisissez le guide correspondant à votre outil : Ansible, Terraform/OpenTofu, Shell, PowerShell ou Python. Puis exécutez-le et suivez son déroulement : Tâches.
- Automatisez et industrialisez :
- Exécution planifiée : Planifications.
- Contrôle de qui peut faire quoi : Équipes et rôles personnalisés.
- Alertes sur les résultats : Notifications.
Concepts clés
Ces termes apparaissent partout dans l'interface.
| Terme | Signification |
|---|---|
| Projet | L'unité principale de séparation. Chaque projet possède ses propres dépôts, clés, inventaires, modèles et équipe. Projets |
| Dépôt | Un dépôt Git ou un chemin local où résident les playbooks, modules ou scripts. Dépôts |
| Inventaire | Hôtes, groupes et paramètres de connexion pour les exécutions de type Ansible. Inventaire |
| Groupe de variables | Variables réutilisables et configuration d'environnement, aussi appelé Environnement. Groupes de variables |
| Coffre de clés | Identifiants chiffrés tels que clés SSH, tokens et mots de passe. Coffre de clés |
| Modèle de tâche | La définition d'une exécution : application, dépôt, inventaire, variables et options. Modèles de tâches |
| Tâche | Une exécution unique d'un modèle, avec son journal et son statut. Tâches |
| Workflow | Un graphe de modèles avec branchements, approbations et délais. Fonctionnalité Pro. Workflows |
| Runner | L'endroit où les tâches s'exécutent : le serveur lui-même ou un runner distant. Runners |
Étapes suivantes
- Placez Semaphore derrière TLS avec un reverse proxy.
- Connectez votre fournisseur d'identité : LDAP ou OpenID Connect.
- Pilotez Semaphore depuis votre CI ou vos scripts avec l'API et la CLI.