Passa al contenuto principale

Applicazioni

Un'applicazione è lo strumento che un Task Template esegue. Semaphore include sette applicazioni integrate; gli amministratori possono attivarle, disattivarle e registrarne di proprie.

ApplicazioneIDCosa esegue un Task TemplateGuida
Ansible Playbookansibleansible-playbook con l'Inventory selezionatoAnsible
Terraform Codeterraformterraform nella sottodirectory e nel workspace selezionatiTerraform/OpenTofu
OpenTofu Codetofutofu, con le stesse opzioni di TerraformTerraform/OpenTofu
Terragrunt Codeterragruntterragrunt come wrapper di Terraform o OpenTofuTerragrunt
Bash Scriptbashuno script di shell con /bin/bashShell
PowerShell Scriptpowershelluno script .ps1 con pwshPowerShell
Python Scriptpythonuno script .py con python3Python

Lo strumento stesso deve essere installato sulla macchina che esegue i Task: il server Semaphore oppure il Runner. L'immagine Docker ufficiale contiene Ansible, Terraform, OpenTofu, Bash e Python.

Gestione delle applicazioni

Gli amministratori aprono Applications dal menu dell'account in fondo alla barra laterale.

Pagina Applications

L'interruttore presente in ogni riga abilita o disabilita l'applicazione. Un'applicazione disabilitata non viene proposta nel modulo del Task Template, mentre i Task Template esistenti continuano a funzionare. Solo le applicazioni abilitate vengono mostrate durante la creazione di un Task Template, quindi è opportuno disabilitare gli strumenti che non sono installati sul proprio server.

Fare clic su un'applicazione per modificarne il titolo, l'icona, il percorso del file binario e la priorità (l'ordine nel modulo del Task Template).

Applicazioni personalizzate

New App registra come applicazione qualsiasi strumento a riga di comando:

CampoDescrizione
IDIdentificatore breve utilizzato nell'API e nei Task Template, ad esempio pulumi.
IconIcona mostrata accanto al nome.
NameTitolo mostrato nel modulo del Task Template.
PathPercorso dell'eseguibile sul server o sul Runner.
PriorityPosizione nell'elenco delle applicazioni.
ActiveIndica se l'applicazione viene proposta nei Task Template.

Un Task Template di un'applicazione personalizzata esegue l'eseguibile passando come argomento il file di script presente nel Repository e riceve i Variable Group come variabili d'ambiente, allo stesso modo dei Task Template Bash.

Le applicazioni possono essere predefinite anche nella configurazione del server, vedere la sezione apps in Configurazione.