Runbook: riconciliazione deployment

Quando usarlo

Usare questo runbook quando un'operation Frontend è requested, dispatching, waiting_for_approval, queued, running o unknown e l'Admin proietta l'azione reconcile.

Prerequisiti

operation e ultimo attempt leggibili;
stesso ambiente, workflow e commit della richiesta originaria;
nessun secondo dispatch o retry;
Access attivo e permesso deployment:request;
provider e D1 disponibili per letture autorevoli;
autorizzazione single-use per una riconciliazione.

Procedura

Aprire il workspace Admin /admin/deployments/.
Selezionare l'operation esatta e leggere operation, attempt e azioni.
Confermare che l'unica azione prevista sia reconcile.
Invocare una sola volta Reconcile operation.
Attendere il readback dell'operation.
Confrontare run, workflow, branch, commit e stato terminale.
Se il risultato è succeeded, eseguire lo smoke limitato.
Se resta unknown, fermarsi senza una seconda invocazione.

Verifiche attese

nessuna nuova operation o attempt;
nessun nuovo dispatch;
run GitHub univoco e compatibile con il commit immutabile;
operation e attempt transitano insieme;
deployedCommitSha compare soltanto su successo;
evidenza precedente non viene modificata.

Condizioni di stop

Fermarsi se l'azione non è proiettata, il run è assente o multiplo, workflow, branch o commit non coincidono, D1 non conferma il readback, la risposta è ambigua o sarebbe necessaria una seconda invocazione.

Rollback o recupero

La riconciliazione non è un rollback. Su fallimento terminale valutare un nuovo Issue e il runbook del componente. Su unknown usare evidenza fallita o ambigua.

Evidenza da conservare

operation e attempt interessati;
stato prima e dopo;
run ID e URL sanitizzati;
commit richiesto e, su successo, distribuito;
conferma di zero nuovi dispatch, operation e attempt;
risultato smoke o motivo dello stop.