Automatisches Neustarten deines GitHub-Workflows nach einem Fehlschlag
Manchmal ist dein GitHub Actions-Workflow launisch und schlägt aus zufälligen Gründen fehl. Lass uns sehen, wie du ihn automatisch neu starten kannst, um Zeit zu sparen.
GaoFounder
Verschwenden Sie keine Wochen mit Benutzerauthentifizierung
Bringen Sie sichere Apps schneller mit Logto auf den Markt. Integrieren Sie Benutzerauthentifizierung in Minuten und konzentrieren Sie sich auf Ihr Kernprodukt.
Wir lieben GitHub Actions. Es ist leistungsstark und bietet eine großzügige kostenlose Stufe.
Während unser Projekt wächst, haben wir immer mehr Integrationstests hinzugefügt, die in unserem GitHub Actions-Workflow ausgeführt werden sollen. Wie bei anderen coolen Projekten führen wir unsere Tests bei jedem Pull Request, Push und Release aus.
Allerdings schlägt unser Workflow aufgrund der Natur von Integrationstests manchmal aus zufälligen Gründen fehl. Es könnte ein Netzwerkproblem, ein Browser-Hickup oder andere schwer reproduzierbare Gründe sein.
Wenn der Workflow fehlschlägt, müssen wir ihn manuell neu starten. Am Anfang ist das keine große Sache, aber für hocheffiziente Entwickler wie uns ist es dennoch ärgerlich.
Zum Zeitpunkt des Schreibens bietet GitHub Actions keine eingebaute Möglichkeit, einen fehlgeschlagenen Workflow automatisch neu zu starten. Schauen wir also, wie wir dies erreichen können.
Wenn ein Workflow NICHT läuft und fehlgeschlagen ist, kannst du ihn manuell neu starten, indem du auf die Schaltfläche "Jobs erneut ausführen" klickst. Es wird ein Dropdown-Menü geöffnet und bietet eine nette Option "Fehlgeschlagene Jobs erneut ausführen", um die erfolgreichen Jobs zu überspringen.
Die Idee ist also einfach:
Wir müssen erkennen, wann ein Workflow fehlgeschlagen ist.
Wir müssen die Neustart-Aktion NACHDEM der Workflow abgeschlossen ist, auslösen.
Offensichtlich können wir dies nicht im selben Workflow tun, da ein Workflow nichts tun kann, wenn er nicht läuft. Also benötigen wir einen anderen Workflow, um den Status des vorherigen Workflows zu überwachen und die Neustart-Aktion auszulösen. Dies kann wie folgt veranschaulicht werden:
Erstelle eine neue Workflow-Datei in deinem Repository, z.B. .github/workflows/rerun.yml:
Dank der GitHub CLI können wir den Status eines Workflows einfach überwachen und ihn mit zwei einfachen Befehlen neu starten:
gh run watch, um den Status eines Workflows zu überwachen (Dokumentation hier).
gh run rerun, um einen Workflow erneut auszuführen. Das Flag --failed führt nur die fehlgeschlagenen Jobs erneut aus (Dokumentation hier).
Alles, was du tun musst, ist die run_id des fehlgeschlagenen Workflows bereitzustellen, was durch Verwendung des github.run_id-Kontexts geschehen kann. Zum Beispiel kannst du den Neustart-Workflow auslösen, indem du den folgenden Schritt zu deinem Original-Workflow hinzufügst:
Die Bedingung if: failure() löst den Schritt nur aus, wenn der Job fehlgeschlagen ist. Die Bedingung fromJSON(github.run_attempt) < 3 führt nur die ersten 2 Versuche erneut aus. Du kannst die Anzahl entsprechend deiner Bedürfnisse anpassen.
Dieser Schritt verwendet den Befehl gh workflow run, um den Neustart-Workflow auszulösen. Siehe die Dokumentation für weitere Details.
Bonus: Den Neustart-Workflow aus dem fehlerhaften Branch ausführen#
Wenn du den Neustart-Workflow aus dem fehlerhaften Branch und nicht aus dem Standard-Branch ausführen möchtest, kannst du den folgenden Befehl verwenden:
Der Kontext github.head_ref wird verwendet, wenn es sich um einen Pull Request handelt, ansonsten wird github.ref_name verwendet.
%3btext-align:center%3b%7d%23mermaid-0 .edgeLabel p%7bbackground-color:rgba(232%2c232%2c232%2c 0.8)%3b%7d%23mermaid-0 .edgeLabel rect%7bopacity:0.5%3bbackground-color:rgba(232%2c232%2c232%2c 0.8)%3bfill:rgba(232%2c232%2c232%2c 0.8)%3b%7d%23mermaid-0 .labelBkg%7bbackground-color:rgba(232%2c 232%2c 232%2c 0.5)%3b%7d%23mermaid-0 .cluster rect%7bfill:%23ffffde%3bstroke:%23aaaa33%3bstroke-width:1px%3b%7d%23mermaid-0 .cluster text%7bfill:%23333%3b%7d%23mermaid-0 .cluster span%7bcolor:%23333%3b%7d%23mermaid-0 div.mermaidTooltip%7bposition:absolute%3btext-align:center%3bmax-width:200px%3bpadding:2px%3bfont-family:arial%2csans-serif%3bfont-size:12px%3bbackground:hsl(80%2c 100%25%2c 96.2745098039%25)%3bborder:1px solid %23aaaa33%3bborder-radius:2px%3bpointer-events:none%3bz-index:100%3b%7d%23mermaid-0 .flowchartTitleText%7btext-anchor:middle%3bfont-size:18px%3bfill:%23333%3b%7d%23mermaid-0 rect.text%7bfill:none%3bstroke-width:0%3b%7d%23mermaid-0 .icon-shape%2c%23mermaid-0 .image-shape%7bbackground-color:rgba(232%2c232%2c232%2c 0.8)%3btext-align:center%3b%7d%23mermaid-0 .icon-shape p%2c%23mermaid-0 .image-shape p%7bbackground-color:rgba(232%2c232%2c232%2c 0.8)%3bpadding:2px%3b%7d%23mermaid-0 .icon-shape rect%2c%23mermaid-0 .image-shape rect%7bopacity:0.5%3bbackground-color:rgba(232%2c232%2c232%2c 0.8)%3bfill:rgba(232%2c232%2c232%2c 0.8)%3b%7d%23mermaid-0 :root%7b--mermaid-font-family:arial%2csans-serif%3b%7d%3c/style%3e%3cg%3e%3cmarker orient='auto' markerHeight='8' markerWidth='8' markerUnits='userSpaceOnUse' refY='5' refX='5' viewBox='0 0 10 10' class='marker flowchart-v2' id='mermaid-0_flowchart-v2-pointEnd'%3e%3cpath style='stroke-width: 1%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' d='M 0 0 L 10 5 L 0 10 z'/%3e%3c/marker%3e%3cmarker orient='auto' markerHeight='8' markerWidth='8' markerUnits='userSpaceOnUse' refY='5' refX='4.5' viewBox='0 0 10 10' class='marker flowchart-v2' id='mermaid-0_flowchart-v2-pointStart'%3e%3cpath style='stroke-width: 1%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' d='M 0 5 L 10 10 L 10 0 z'/%3e%3c/marker%3e%3cmarker orient='auto' markerHeight='11' markerWidth='11' markerUnits='userSpaceOnUse' refY='5' refX='11' viewBox='0 0 10 10' class='marker flowchart-v2' id='mermaid-0_flowchart-v2-circleEnd'%3e%3ccircle style='stroke-width: 1%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' r='5' cy='5' cx='5'/%3e%3c/marker%3e%3cmarker orient='auto' markerHeight='11' markerWidth='11' markerUnits='userSpaceOnUse' refY='5' refX='-1' viewBox='0 0 10 10' class='marker flowchart-v2' id='mermaid-0_flowchart-v2-circleStart'%3e%3ccircle style='stroke-width: 1%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' r='5' cy='5' cx='5'/%3e%3c/marker%3e%3cmarker orient='auto' markerHeight='11' markerWidth='11' markerUnits='userSpaceOnUse' refY='5.2' refX='12' viewBox='0 0 11 11' class='marker cross flowchart-v2' id='mermaid-0_flowchart-v2-crossEnd'%3e%3cpath style='stroke-width: 2%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' d='M 1%2c1 l 9%2c9 M 10%2c1 l -9%2c9'/%3e%3c/marker%3e%3cmarker orient='auto' markerHeight='11' markerWidth='11' markerUnits='userSpaceOnUse' refY='5.2' refX='-1' viewBox='0 0 11 11' class='marker cross flowchart-v2' id='mermaid-0_flowchart-v2-crossStart'%3e%3cpath style='stroke-width: 2%3b stroke-dasharray: 1%2c 0%3b' class='arrowMarkerPath' d='M 1%2c1 l 9%2c9 M 10%2c1 l -9%2c9'/%3e%3c/marker%3e%3cg class='root'%3e%3cg class='clusters'%3e%3cg data-look='classic' id='Neustart-Workflow' class='cluster'%3e%3crect height='228' width='544.21875' y='8' x='651.1875' style=''/%3e%3cg transform='translate(857.6484375%2c 8)' class='cluster-label'%3e%3cforeignObject height='24' width='131.296875'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eNeustart-Workflow%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg data-look='classic' id='subGraph0' class='cluster'%3e%3crect height='133' width='593.1875' y='91.5' x='8' style=''/%3e%3cg transform='translate(243.6875%2c 91.5)' class='cluster-label'%3e%3cforeignObject height='24' width='121.8125'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eOriginal workflow%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3c/g%3e%3cg class='edgePaths'%3e%3cpath marker-end='url(%23mermaid-0_flowchart-v2-pointEnd)' style='' class='edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link' id='L_A_B_0' d='M280%2c158.5L285.492%2c158.417C290.984%2c158.333%2c301.969%2c158.167%2c312.37%2c158.083C322.771%2c158%2c332.589%2c158%2c337.497%2c158L342.406%2c158'/%3e%3cpath marker-end='url(%23mermaid-0_flowchart-v2-pointEnd)' style='' class='edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link' id='L_B_D_1' d='M576.188%2c158L580.354%2c158C584.521%2c158%2c592.854%2c158%2c601.188%2c158C609.521%2c158%2c617.854%2c158%2c626.188%2c158C634.521%2c158%2c642.854%2c158%2c650.604%2c158.07C658.354%2c158.141%2c665.521%2c158.281%2c669.105%2c158.351L672.688%2c158.422'/%3e%3cpath marker-end='url(%23mermaid-0_flowchart-v2-pointEnd)' style='' class='edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link' id='L_D_E_2' d='M805.255%2c139L823.228%2c127.5C841.201%2c116%2c877.148%2c93%2c901.363%2c81.5C925.578%2c70%2c938.063%2c70%2c944.305%2c70L950.547%2c70'/%3e%3cpath marker-end='url(%23mermaid-0_flowchart-v2-pointEnd)' style='' class='edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link' id='L_D_F_3' d='M872.141%2c158.5L878.966%2c158.417C885.792%2c158.333%2c899.443%2c158.167%2c923.754%2c159.956C948.065%2c161.746%2c983.036%2c165.491%2c1000.522%2c167.364L1018.007%2c169.237'/%3e%3cpath marker-end='url(%23mermaid-0_flowchart-v2-pointEnd)' style='' class='edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link' id='L_F_D_4' d='M1021.984%2c179.692L1003.836%2c182.244C985.688%2c184.795%2c949.391%2c189.897%2c920.999%2c189.783C892.608%2c189.669%2c872.122%2c184.338%2c861.879%2c181.673L851.637%2c179.007'/%3e%3c/g%3e%3cg class='edgeLabels'%3e%3cg transform='translate(312.953125%2c 158)' class='edgeLabel'%3e%3cg transform='translate(-8.453125%2c -12)' class='label'%3e%3cforeignObject height='24' width='16.90625'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' class='labelBkg' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='edgeLabel'%3e%3cp%3eJa%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg class='edgeLabel'%3e%3cg transform='translate(0%2c 0)' class='label'%3e%3cforeignObject height='0' width='0'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' class='labelBkg' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='edgeLabel'%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(913.09375%2c 70)' class='edgeLabel'%3e%3cg transform='translate(-16.453125%2c -12)' class='label'%3e%3cforeignObject height='24' width='32.90625'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' class='labelBkg' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='edgeLabel'%3e%3cp%3eNein%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(913.09375%2c 158)' class='edgeLabel'%3e%3cg transform='translate(-8.453125%2c -12)' class='label'%3e%3cforeignObject height='24' width='16.90625'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' class='labelBkg' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='edgeLabel'%3e%3cp%3eJa%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg class='edgeLabel'%3e%3cg transform='translate(0%2c 0)' class='label'%3e%3cforeignObject height='0' width='0'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' class='labelBkg' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='edgeLabel'%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3c/g%3e%3cg class='nodes'%3e%3cg transform='translate(156.25%2c 158)' id='flowchart-A-0' class='node default'%3e%3cpolygon transform='translate(-123.25%2c31.5)' class='label-container' points='15.75%2c0 230.75%2c0 246.5%2c-31.5 230.75%2c-63 15.75%2c-63 0%2c-31.5'/%3e%3cg transform='translate(-100%2c -24)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='48' width='200'%3e%3cdiv style='display: table%3b white-space: break-spaces%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b width: 200px%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eOriginalworkflow fehlgeschlagen%3f%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(461.296875%2c 158)' id='flowchart-B-1' class='node default'%3e%3crect height='54' width='229.78125' y='-27' x='-114.890625' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-99.890625%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='199.78125'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eNeustart-Workflow ausl%c3%b6sen%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(773.9140625%2c 158)' id='flowchart-D-3' class='node default'%3e%3cpolygon transform='translate(-97.7265625%2c19.5)' class='label-container' points='9.75%2c0 185.703125%2c0 195.453125%2c-19.5 185.703125%2c-39 9.75%2c-39 0%2c-19.5'/%3e%3cg transform='translate(-80.4765625%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='160.953125'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eOriginalworkflow l%c3%a4uft%3f%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(1062.4765625%2c 70)' id='flowchart-E-5' class='node default'%3e%3crect height='54' width='215.859375' y='-27' x='-107.9296875' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-92.9296875%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='185.859375'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eOriginalworkflow ausl%c3%b6sen%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(1062.4765625%2c 174)' id='flowchart-F-7' class='node default'%3e%3crect height='54' width='80.984375' y='-27' x='-40.4921875' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-25.4921875%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='50.984375'%3e%3cdiv style='display: table-cell%3b white-space: nowrap%3b line-height: 1.5%3b max-width: 200px%3b text-align: center%3b' xmlns='http://www.w3.org/1999/xhtml'%3e%3cspan class='nodeLabel'%3e%3cp%3eWarten%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3c/g%3e%3c/g%3e%3c/g%3e%3c/svg%3e)