한국어
실패 후 GitHub 워크플로우 자동 재실행
가끔씩 GitHub Actions 워크플로우가 제멋대로 작동하며 무작위로 실패할 수 있습니다. 시간을 절약하기 위해 이를 자동으로 다시 실행하는 방법을 알아봅시다.
Gao
Founder
Founder
가끔씩 GitHub Actions 워크플로우가 제멋대로 작동하며 무작위로 실패할 수 있습니다. 시간을 절약하기 위해 이를 자동으로 다시 실행하는 방법을 알아봅시다.
우리는 GitHub Actions를 사랑합니다. 강력하며 무료로 넉넉한 사용량을 제공합니다.
프로젝트가 성장하면서 GitHub Actions 워크플로우에서 실행할 통합 테스트를 점점 더 많이 추가하게 되었습니다. 다른 멋진 프로젝트들처럼, 우리는 각 풀 리퀘스트, 푸시, 릴리스마다 테스트를 실행합니다.
그러나 통합 테스트의 특성상, 가끔 무작위 이유로 워크플로우가 실패할 수 있습니다. 네트워크 문제, 브라우저 문제 등 재현하기 어려운 여러 가지 이유가 있을 수 있습니다.
워크플로우가 실패하면 이를 수동으로 다시 실행해야 합니다. 처음에는 큰 문제는 아니지만, 우리와 같은 고효율 개발자들에게는 여전히 성가신 일입니다.
이 글을 작성하는 시점에서, GitHub Actions는 실패한 워크플로우를 자동으로 다시 실행하는 내장 기능을 제공하지 않습니다. 따라서 이를 달성하기 위해 문제를 나눠서 봅시다.
워크플로우가 실행 중이 아니고 실패했을 때, "다시 실행" 버튼을 클릭하여 수동으로 다시 실행할 수 있습니다. 드롭다운 메뉴가 열리며, 성공한 작업을 건너뛰기 위한 "실패한 작업 다시 실행" 옵션이 표시됩니다.
아이디어는 간단합니다:
명백히, 같은 워크플로우 내에서 이 작업을 수행할 수는 없습니다. 왜냐하면 실행 중이 아닌 워크플로우는 아무 작업도 할 수 없기 때문입니다. 따라서 이전 워크플로우의 상태를 모니터링하고 다시 실행 작업을 트리거하는 다른 워크플로우가 필요합니다. 이를 아래와 같이 설명할 수 있습니다:
%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='subGraph1' class='cluster'%3e%3crect height='228' width='551.9375' y='8' x='607.265625' style=''/%3e%3cg transform='translate(828.1015625%2c 8)' class='cluster-label'%3e%3cforeignObject height='24' width='110.265625'%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%3eRerun 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='124' width='549.265625' y='96' x='8' style=''/%3e%3cg transform='translate(221.7265625%2c 96)' 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='M241.406%2c158.5L247.665%2c158.417C253.924%2c158.333%2c266.443%2c158.167%2c278.378%2c158.083C290.313%2c158%2c301.664%2c158%2c307.34%2c158L313.016%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='M532.266%2c158L536.432%2c158C540.599%2c158%2c548.932%2c158%2c557.266%2c158C565.599%2c158%2c573.932%2c158%2c582.266%2c158C590.599%2c158%2c598.932%2c158%2c606.682%2c158.07C614.433%2c158.141%2c621.599%2c158.281%2c625.183%2c158.351L628.766%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='M777.425%2c139L796.746%2c127.5C816.067%2c116%2c854.709%2c93%2c879.706%2c81.5C904.703%2c70%2c916.055%2c70%2c921.73%2c70L927.406%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='M855.797%2c158.5L862.056%2c158.417C868.315%2c158.333%2c880.833%2c158.167%2c902.576%2c159.86C924.319%2c161.553%2c955.286%2c165.106%2c970.769%2c166.882L986.253%2c168.659'/%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='M990.227%2c180.412L974.081%2c182.843C957.935%2c185.275%2c925.643%2c190.137%2c898.438%2c189.892C871.233%2c189.647%2c849.115%2c184.294%2c838.056%2c181.617L826.997%2c178.941'/%3e%3c/g%3e%3cg class='edgeLabels'%3e%3cg transform='translate(278.9609375%2c 158)' class='edgeLabel'%3e%3cg transform='translate(-13.0546875%2c -12)' class='label'%3e%3cforeignObject height='24' width='26.109375'%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%3eYes%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(893.3515625%2c 70)' class='edgeLabel'%3e%3cg transform='translate(-10.2265625%2c -12)' class='label'%3e%3cforeignObject height='24' width='20.453125'%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%3eNo%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(893.3515625%2c 158)' class='edgeLabel'%3e%3cg transform='translate(-13.0546875%2c -12)' class='label'%3e%3cforeignObject height='24' width='26.109375'%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%3eYes%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(136.953125%2c 158)' id='flowchart-A-0' class='node default'%3e%3cpolygon transform='translate(-103.953125%2c19.5)' class='label-container' points='9.75%2c0 198.15625%2c0 207.90625%2c-19.5 198.15625%2c-39 9.75%2c-39 0%2c-19.5'/%3e%3cg transform='translate(-86.703125%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='173.40625'%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 failed%3f%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(424.640625%2c 158)' id='flowchart-B-1' class='node default'%3e%3crect height='54' width='215.25' y='-27' x='-107.625' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-92.625%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='185.25'%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%3eTrigger the rerun workflow%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(743.78125%2c 158)' id='flowchart-D-3' class='node default'%3e%3cpolygon transform='translate(-111.515625%2c19.5)' class='label-container' points='9.75%2c0 213.28125%2c0 223.03125%2c-19.5 213.28125%2c-39 9.75%2c-39 0%2c-19.5'/%3e%3cg transform='translate(-94.265625%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='188.53125'%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 running%3f%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(1032.8046875%2c 70)' id='flowchart-E-5' class='node default'%3e%3crect height='54' width='202.796875' y='-27' x='-101.3984375' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-86.3984375%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='172.796875'%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%3eTrigger original workflow%3c/p%3e%3c/span%3e%3c/div%3e%3c/foreignObject%3e%3c/g%3e%3c/g%3e%3cg transform='translate(1032.8046875%2c 174)' id='flowchart-F-7' class='node default'%3e%3crect height='54' width='85.15625' y='-27' x='-42.578125' ry='5' rx='5' style='' class='basic label-container'/%3e%3cg transform='translate(-27.578125%2c -12)' style='' class='label'%3e%3crect/%3e%3cforeignObject height='24' width='55.15625'%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%3eHold on%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)
저장소에 새로운 워크플로우 파일을 생성하세요, 예를 들어 .github/workflows/rerun.yml:
GitHub CLI 덕분에 두 개의 간단한 명령어로 워크플로우 상태를 쉽게 감시하고 다시 실행할 수 있습니다:
gh run watch를 사용하여 워크플로우 상태를 감시합니다 (문서 여기에서 확인).gh run rerun을 사용하여 워크플로우를 다시 실행합니다. --failed 플래그는 실패한 작업만 다시 실행합니다 (문서 여기에서 확인).실패한 워크플로우의 run_id만 제공하면 됩니다. 이는 github.run_id 컨텍스트를 사용하여 가능합니다. 예를 들어, 원래의 워크플로우에 다음 스텝을 추가하여 재실행 워크플로우를 트리거할 수 있습니다:
if: failure() 조건은 작업이 실패했을 때만 이 스텝을 트리거합니다. fromJSON(github.run_attempt) < 3 조건은 처음 2번만 재실행합니다. 필요에 따라 숫자를 조정할 수 있습니다.
이 스텝은 gh workflow run 명령을 사용하여 재실행 워크플로우를 트리거합니다. 자세한 내용은 문서를 참조하세요.
실패한 브랜치에서 기본 브랜치 대신 재실행 워크플로우를 실행하려면, 다음 명령을 사용할 수 있습니다:
github.head_ref 컨텍스트는 풀 리퀘스트일 때 사용되고, 그렇지 않으면 github.ref_name이 사용됩니다.
이 접근 방식의 아이디어는 이 GitHub 논의 댓글에서 처음 나왔습니다.