Běh CI skončí „failure“, i když žádná úloha nezačala — a jak získat nový běh na stejném commitu bez práva opakovat
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Tři po sobě jdoucí běhy nad jedním a tímtéž commitem, tři různé výsledky:
- povinná integrační úloha selže na jediném testu, který se změnou nesouvisí (prohlížeč na stroji CI neotevřel kartu);
- nový běh: všechny úlohy „failure“ za necelých 90 sekund;
- další nový běh o hodinu později: všechno povinné zelené.
Druhý běh vypadá v přehledu stejně červeně jako první, a svádí k závěru „selhalo to znovu“.
Root cause
Sekce “Root cause”Dvě nezávislé věci.
Nestabilní test. První selhání byla vlastnost testu, ne kódu — na stejném commitu jednou selhal a jednou prošel.
Úlohy, které nikdy nezačaly. Druhý běh neměl přidělený stroj, neměl jediný krok a jeho protokol neexistoval. Důvod (nedávná platba nebo limit útraty na účtu) byl vidět jen jako poznámka na stránce běhu; přes API ho klíč s omezeným oprávněním nepřečte. Stavová stránka poskytovatele žádný výpadek neukazovala.
K tomu jedno omezení: přístupový klíč určený ke čtení výsledků neměl právo běh zopakovat (odpověď 403), a ruční spuštění workflow nešlo, protože soubor workflow nebyl ve výchozí větvi repozitáře.
Fix
Sekce “Fix”Nový běh na stejném commitu bez práva opakovat a bez změny kódu:
git push origin <sha>:refs/heads/fix/<nazev>-ci-opakovani # workflow sleduje fix/**Workflow se spustí událostí odeslání a běží nad týmž commitem se stejnými kroky. Původní běh zůstane beze změny, takže první selhání z dokladů nezmizí. Když je potřeba další běh, dočasnou větev smaž a založ znovu — odeslání stejného commitu na existující větev nic nespustí.
Jak poznat běh, který nezačal (všechno jde přečíst i s klíčem jen pro čtení):
curl -s -H "Authorization: Bearer $TOKEN" \ "$API/actions/runs/<id>/jobs" | jq '.jobs[] | {name, conclusion, runner_name, kroku: (.steps | length)}'# runner_name "" a kroku 0 → úloha nezačala; výsledek není doklad pro kód ani proti němuJak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: běh, který skončí řádově rychleji než obvykle a všechny jeho úlohy mají stejný výsledek, skoro nikdy nevypovídá o kódu. Zkontroluj stroj, kroky a protokol dřív, než začneš hledat chybu v testech.
- Neopakuj naslepo: když úlohy nezačaly kvůli účtu, další odeslání dopadne stejně. Nejdřív zjisti důvod na stránce běhu.
- Doklady: úspěšné opakování nesmí vymazat původní selhání. Uváděj všechny běhy s číslem, časem a výsledkem každé úlohy.
- Oprávnění klíče: klíč jen pro čtení je dobrá výchozí volba; počítej s tím, že opakování musí umět někdo jiný, nebo měj připravenou cestu přes sledovanou větev.
- Nestabilní test eviduj zvlášť: jedno selhání ze dvou běhů téhož commitu je nález sám o sobě, ne důvod měnit kód, který se právě přebírá.
- Anti-pattern: vyvodit „znovu červené“ z barvy v přehledu běhů.
Sister bugs / související
Sekce “Sister bugs / související”- Test s pojistkou databáze uklízí i po jejím odmítnutí a chybí v seznamu výjimek CI — jiný důvod, proč zelená nebo červená CI neříká to, co se zdá.
- Skupina tlačítek v řádku seznamu stlačí na telefonu text do úzkého sloupce — oprava, u které se to stalo.