Vai al contenuto
CloseYourItdocsPagine
Torna al sitoENITInstalla

Documentazione / Usare CloseYourIt

Release

Le versioni che girano in ogni ambiente, legate ai tag di GitHub, e gli errori che tornano dopo una correzione.

Una release è la versione del tuo programma che gira in un ambiente. CloseYourIt la usa per dirti in quale versione è nato un errore, in quale è stato risolto e se è tornato dopo.

Da dove arrivano le release

In due modi:

  • Dalla CI. Dopo il rilascio, la pipeline registra la versione con un token del progetto con permesso ingest.
  • Dagli errori. Il primo errore che porta una versione (release nell'SDK) crea la release da solo.

La chiamata dalla CI:

curl -X POST https://bugs.example.com/api/v1/projects/$PROJECT_ID/releases \
  -H "Authorization: Bearer $CYI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"version": "v1.4.2", "sha": "'"$GITHUB_SHA"'"}'
  • version è obbligatoria. sha (il commit) e build_time sono facoltativi.
  • L'ambiente è quello del token, non si scrive nel corpo. Per lo staging usa il token dello staging.
  • Ripetere la chiamata non crea doppioni.

La stessa versione in staging e in produzione sono due release diverse.

Dove le vedi

Nella pagina del progetto, la sezione Release mostra le ultime: versione, ambiente, il commit accorciato a 7 caratteri, quanti eventi ha ricevuto e quando. Vedi tutte → apre l'elenco completo. Dalla riga di comando: cyi releases list --project <id o chiave>.

Nella pagina di un errore trovi Introdotto in (la prima versione in cui è comparso) e Ultima release (l'ultima in cui si è visto). Se sono la stessa, leggi Comparso e ancora presente in.

La release «live»

Il segno live dice quale versione gira adesso in un ambiente. Per averlo serve GitHub collegato: la creazione della App è in GitHub.

  1. Nel progetto apri la scheda GitHub, scegli il repository e premi Aggancia repo.
  2. Accendi Binding tag → release.
  3. Scegli l'Environment di produzione e l'Environment di staging.

Da quel momento:

  • un tag stabile (per esempio v1.2.3) marca la release live in produzione;
  • un tag di prova (per esempio v1.2.3-beta) la marca in staging.

La release diventa live quando sono arrivati tutti e due i segnali: la registrazione dalla CI per quell'ambiente e il tag su GitHub con la stessa versione. L'ordine non conta. In ogni ambiente c'è una sola release live: la nuova toglie il segno alla precedente.

Errori che tornano

Quando risolvi un errore, CloseYourIt annota la release live in quel momento: nel riquadro della risoluzione leggi Risolto nella versione ….

Se poi l'errore si ripresenta:

  • da una versione uguale o più nuova di quella della correzione, l'errore si riapre ed è una regressione. L'avviso dice Errore riemerso e in quale versione (vedi Avvisi);
  • da una versione sicuramente più vecchia, l'errore resta risolto. È un client vecchio che non è ancora aggiornato, non un guasto nuovo.

Le versioni come v1.4.2 si confrontano per numero. Le altre, per esempio un commit, per data di prima comparsa. Se il progetto non ha una release live, o l'ordine non si capisce, l'errore si riapre sempre: meglio un avviso in più che una regressione nascosta.