Guida utente
Questa sezione è rivolta a chi ha già accesso a un Project di Semaphore. Tutto quanto descritto qui avviene nell'interfaccia web oppure tramite l'API del Project. L'installazione del server, la sua configurazione e il collegamento di un identity provider sono trattati nella Guida all'amministrazione.
Il lavoro in Semaphore segue un'unica catena. Un Project contiene tutto il resto. Al suo interno si registrano le risorse necessarie a un'esecuzione: un Repository con i propri playbook o script, le chiavi usate per raggiungerlo e per raggiungere i propri host, un Inventory delle macchine di destinazione e i Variable Group con valori e segreti. Un Task Template combina questi elementi in una definizione di ciò che va eseguito, e ogni esecuzione di quel Task Template è un Task. Le pianificazioni, i Workflow e i webhook in ingresso avviano i Task Template al posto dell'utente.
Configurare un Project
In questo ordine, perché ogni passaggio dipende dal precedente.
| Pagina | Contenuto |
|---|---|
| Project | Creare un Project, le sezioni della barra laterale, backup e ripristino. |
| Team | I quattro ruoli integrati e i ruoli personalizzati su Enterprise. |
| Key Store | Chiavi SSH, credenziali di accesso e storage di segreti esterni. |
| Repository | Repository Git e percorsi locali che contengono la propria automazione. |
| Inventory | Host e impostazioni di connessione per Ansible, workspace per Terraform. |
| Variable Group | Variabili e segreti riutilizzabili passati ai Task. |
Definire ed eseguire il lavoro
| Pagina | Contenuto |
|---|---|
| Task Template | Ogni campo del modulo del Task Template, oltre ai tipi di Task Template. |
| Applicazioni | Che cosa esegue ciascuna applicazione: Ansible, Terraform, OpenTofu, Terragrunt e gli script. |
| Task | Avviare un Task, stati dei Task, log, arresto e riesecuzione. |
| Pianificazioni | Eseguire i Task Template secondo una pianificazione cron. |
| Workflow | Concatenare i Task Template con approvazioni e diramazioni. |
| Integration | Avviare i Task da webhook in ingresso. |
| Runner del Project | Inviare i Task di un Project ai propri runner. |
| Il proprio account | Impostazioni personali e token API. |
Da dove iniziare
Se si è appena stati aggiunti a un Project, leggere Project per orientarsi, quindi Task per eseguirne uno e leggerne il log. Se invece si sta configurando un Project da zero, seguire la tabella qui sopra nell'ordine indicato.
Si è completamente nuovi a Semaphore? Iniziare da Primi passi.