Concetti
I termini usati in questa documentazione, ognuno collegato alla sua pagina
Glossario
I termini usati in questa documentazione:
| Termine | Significato |
|---|---|
| Modulo | Una definizione YAML che raccoglie input ed esegue un playbook, un template o un workflow |
| Campo del modulo | Un input di un modulo, come text, enum o checkbox; il suo valore diventa un’extravar |
| Categoria | Un gruppo nell’albero dei moduli mostrato nella pagina Moduli, definito in config.yaml |
| Ruolo | Un insieme di utenti e gruppi; un modulo elenca i ruoli che possono vederlo ed eseguirlo, default per tutti |
| Espressione | JavaScript che calcola il valore di un campo, nel browser (runLocal: true) o sul server |
| Extravars | Le variabili inviate al playbook o al template, costruite dai valori dei campi |
| Credenziale | Un login salvato, cifrato con ENCRYPTION_SECRET: un utente e una password (e host, porta, database), o dalla 7.3.0 l’indirizzo e i segreti di una directory LDAP, di un provider SSO, di un runner o di un HashiCorp Vault |
| Archivio di segreti | Una connessione a HashiCorp Vault o CyberArk che fornisce l’utente e la password di una credenziale |
| Job | Un’esecuzione di un modulo, con il suo stato, le extravars e l’output, conservata nella cronologia dei job |
| Runner | Dove gira un job, aggiunto in Connessioni > Runner: rte per i playbook, awx (AWX, o la variante aap o ascender), semaphore, rundeck o jenkins per template e job. Un modulo ne sceglie uno con runner:, o gira sul runner predefinito rte (playbook) o awx (template) |
| RTE | Un ambiente di runtime: il server AnsibleForms avviato con AF_ROLE=rte nel suo container, accanto a python e ansible, che esegue i playbook di un runner di tipo rte |
| Punto di approvazione | Una pausa in un job finché un utente con un ruolo di approvazione non lo approva o lo rifiuta |
| Workflow | Un grafo di playbook, approvazioni e altri workflow collegati in caso di successo, di fallimento o sempre, con la sintassi di AWX |
| Modulo multistep | Deprecato dalla 7: un modulo che esegue più playbook o template in sequenza; lo sostituisce un workflow |
| Canale di notifica | Un server di posta, un webhook di Slack o Teams, una chat Telegram o un webhook a cui vanno le notifiche e le richieste di approvazione |
| Designer | L’editor nel browser per moduli, playbook, inventari e workflow, usato da una persona alla volta |
| Subform | Un insieme riutilizzabile di campi che descrive le righe di un campo list o l’oggetto di un campo yaml |
| config.yaml | Il file con le categorie, i ruoli e le costanti; i moduli stanno nei loro file |
| Config seed | Un file YAML (CONFIG_SEED_PATH) che dichiara gli oggetti di amministrazione, come runner e credenziali |
| Cartella persistente | La cartella che contiene i file che AnsibleForms deve conservare tra riavvii e aggiornamenti |