Avvio rapido: avviare la prima pipeline e leggerne il registro

Il percorso più breve da «il plugin è installato» a «un'esecuzione è registrata, attribuita a voi, e i suoi tre flussi di registro sono leggibili». Tre passi, circa dieci minuti.

Prerequisiti

wkdopipelines, wkdocore, wkdostorage e wkcore sono installati e attivati.
Un progetto e, al suo interno, una pipeline definita. Se non ce n'è, la schermata lo dice: Nessuna pipeline definita per questo progetto.
Il permesso di avviare, che non coincide con quello di guardare — vedi il passo 1.
Il server può eseguire ciò che la pipeline richiama, e come utente del server web.

Passo 1: verificare quale permesso avete

Due domande diverse governano questo plugin:

Azione	Interroga
Guardare esecuzioni e registri	il vostro ruolo nel progetto
Avviare un'esecuzione	il contesto più ampio dei permessi

Poter vedere una pipeline non implica poterla avviare. Quello squilibrio è voluto: leggere una cronologia è ordinaria appartenenza al progetto, avviare un processo sul server non lo è.

Passo 2: avviare

Aprire l'hub Pipeline del progetto:

/doku.php?id=it:projects:acme:pipelines&do=wkdopipelines

Scegliere una pipeline dall'elenco e avviarla.

Passo 3: leggere il registro

Aprire l'esecuzione. Il registro è raccolto in tre flussi distinti:

Flusso	Contiene
`out`	Ciò che il processo ha scritto sullo standard output.
`err`	Ciò che il processo ha scritto sullo standard error.
`sys`	Ciò che ha fatto l'esecutore stesso — il suo resoconto del tentativo.

Il terzo è quello che nessuno si aspetta ed è quello che risponde alla prima domanda dopo un fallimento.

Verifica del risultato

L'esecuzione compare nell'elenco con Stato (in coda, in corso, riuscita, fallita, annullata), Avvio, Fine, Uscita e Avviata da — e lì compare il vostro nome.
Tutti e tre i flussi sono leggibili separatamente.
La cronologia contiene le esecuzioni precedenti con i loro esecutori ed esiti. «Ieri funzionava» diventa così verificabile invece che ricordato.

Ecco come con sys si separano i due fallimenti che altrimenti si somigliano — il processo è fallito, oppure l'esecutore non lo ha mai avviato:

Qualcosa in out/err e un fallimento → il processo è partito ed è fallito.
Nulla in out/err, qualcosa in sys → non è mai partito, e sys dice perché.

Un registro unico rende proprio quella distinzione la più difficile da recuperare. Flussi distinti la rendono la prima cosa che si vede.

Passo successivo

wkdodashboard — le pipeline del progetto sulla sua pagina d'ingresso.
wkdopipelines (in tedesco) — la pagina del pacchetto: le regole di esecuzione, l'esecutore e il registratore.