Aller au contenu principal

Applications

Une application est l'outil qu'exécute un modèle de tâche. Semaphore est livré avec sept applications intégrées ; les administrateurs peuvent les activer, les désactiver et enregistrer les leurs.

ApplicationIDCe qu'exécute un modèleGuide
Ansible Playbookansibleansible-playbook avec l'inventaire sélectionnéAnsible
Terraform Codeterraformterraform dans le sous-répertoire et l'espace de travail sélectionnésTerraform/OpenTofu
OpenTofu Codetofutofu, avec les mêmes options que TerraformTerraform/OpenTofu
Terragrunt Codeterragruntterragrunt encapsulant Terraform ou OpenTofuTerragrunt
Bash Scriptbashun script shell avec /bin/bashShell
PowerShell Scriptpowershellun script .ps1 avec pwshPowerShell
Python Scriptpythonun script .py avec python3Python

L'outil lui-même doit être installé sur la machine qui exécute les tâches : le serveur Semaphore ou le runner. L'image Docker officielle contient Ansible, Terraform, OpenTofu, Bash et Python.

Gérer les applications

Les administrateurs ouvrent Applications depuis le menu du compte, en bas de la barre latérale.

Page Applications

L'interrupteur présent sur chaque ligne active ou désactive l'application. Une application désactivée n'est plus proposée dans le formulaire de modèle ; les modèles existants continuent de fonctionner. Seules les applications activées apparaissent lors de la création d'un modèle : désactivez donc les outils qui ne sont pas installés sur votre serveur.

Cliquez sur une application pour modifier son titre, son icône, le chemin de son binaire et sa priorité (l'ordre dans le formulaire de modèle).

Applications personnalisées

Nouvelle application permet d'enregistrer n'importe quel outil en ligne de commande comme application :

ChampDescription
IDIdentifiant court utilisé dans l'API et dans les modèles, par exemple pulumi.
IcôneIcône affichée à côté du nom.
NomTitre affiché dans le formulaire de modèle.
CheminChemin de l'exécutable sur le serveur ou le runner.
PrioritéPosition dans la liste des applications.
ActifIndique si l'application est proposée dans les modèles.

Un modèle d'application personnalisée exécute l'exécutable en lui passant en argument le fichier de script issu du dépôt et reçoit les groupes de variables sous forme de variables d'environnement, de la même façon que les modèles Bash.

Les applications peuvent également être prédéfinies dans la configuration du serveur, voir la section apps dans Configuration.