GitHub Actions 느린 문제 해결: YAML 설정으로 CI 속도 높이는 방법

PR 올릴 때마다 CI가 10분씩 도는 거, 코드 한 줄 고쳤는데도요. 이 글은 그 시간을 절반 이하로 줄이는 방법을 다뤄요.
핵심 요약
- YAML 설정 세 줄로 30–50% 단축 가능해요 (GitSpider 분석 기준)
- Docker 레이어 캐시가 npm 의존성 캐시보다 7배 더 효과적이에요 — 대부분 npm만 캐시하고 멈추죠
cancel-in-progress: true없이 쓰면, 이미 덮어씌워진 커밋의 CI가 끝까지 돌면서 runner 분을 낭비해요- macOS runner는 Linux 대비 10배 비싸요. matrix에 stray macOS 항목 하나라도 있으면 비용이 튀어요
- 더 빠른 머신이 아니라 불필요한 작업 자체를 없애는 게 먼저예요
1. 증상 확인
PR을 푸시할 때마다 GitHub Actions 탭에서 워크플로우가 큐에 걸리거나, 끝날 필요 없는 오래된 실행이 계속 돌아가는 걸 볼 수 있어요. 로그 상단에 Waiting for a runner to pick up this job이 수 분씩 떠 있거나, 같은 브랜치에서 실행이 두 개 동시에 보이면 전형적인 패턴이에요.
실제로 빌드 자체가 느린 게 아니라, 대기와 중복 실행이 체감 시간을 부풀리는 경우가 많아요. GitSpider 분석에 따르면 캐시와 동시 실행 취소만 적용해도 wall-clock 시간이 30–50% 줄어요.
가장 빠른 첫 번째 수정:
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
2. 가장 유력한 원인 세 가지
Cause 1: push와 pull_request 트리거가 동시에 걸려 있어요
확인: Actions 탭에서 같은 커밋 SHA에 실행이 두 개 보이면 바로 이 경우예요.
# 이렇게 되어 있으면 문제예요
on:
push:
pull_request:
수정:
on:
push:
branches:
- main
pull_request:
같은 저장소 브랜치에서 PR을 열면 push와 pull_request 이벤트가 동시에 발생해요. 별도 설정 없이 둘 다 쓰면 CI가 두 번 도는 거예요.
Cause 2: 오래된 실행이 취소되지 않고 끝까지 돌아요
확인: 연속으로 커밋을 푸시했을 때 이전 실행이 In progress로 계속 남아 있는지 보세요.
gh run list --branch <브랜치명> --status in_progress
두 개 이상 보이면 이 원인이에요.
수정:
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
GitHub의 기본값은 실행을 취소하지 않고 큐에 쌓아요. 명시하지 않으면 덮어씌워진 커밋의 CI가 끝까지 돌면서 runner 분을 소모해요.
Cause 3: 의존성이 매번 새로 설치돼요
확인: 워크플로우 로그에서 npm install 단계가 매번 30초 이상 걸리면 캐시가 없는 거예요.
수정:
- uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm' # 이 한 줄이 전부예요
GitHub Actions runner는 매번 클린 환경에서 시작해요. cache 옵션 없이는 node_modules를 항상 새로 받아요. GitSpider 분석 기준으로 Node/Python 프로젝트에서 30–90초 낭비예요.
Docker 쓰고 있다면. DEV Community 벤치마크 (2026년 9월, Node 20.20.2 기준)에서 Docker 레이어 캐시가 npm 캐시보다 7배 효과적이었어요. cold build 19.5초 → warm cache 5.8초. npm
cache:설정 다음 단계로 볼만해요.
3. 가능성은 낮지만 확인해볼 것들
- macOS runner가 matrix에 섞여 있음:
runs-on: macos-latest가 하나라도 있으면 Linux 대비 10배 비용이에요..github/workflows/*.yml에서macos검색해서 불필요한 항목 제거하세요. - path 필터 없음: 문서만 바꿔도 전체 CI가 돌아요.
on.push.paths에src/**,package.json처럼 실제 코드 경로를 넣어두면 돼요. - job timeout 없음: GitHub 기본값은 6시간이에요. 하나가 hung되면 그 시간까지 runner를 잡아요.
timeout-minutes: 15정도는 각 job에 넣어두세요. - 거대한 test matrix: PR마다 모든 OS × 버전 조합을 돌리고 있다면, PR은 단일 OS/버전으로, full matrix는
main브랜치나 nightly로 옮기는 게 맞아요.
4. 그래도 안 된다면
GitHub Community Discussions — Actions 카테고리가 가장 빠르게 답 받는 곳이에요. Stack Overflow라면 github-actions 태그로 질문하세요.
질문할 때 반드시 포함할 것들:
.github/workflows/ci.yml전체 (secrets 제외)- 느린 실행의 Run ID
created_atvsstarted_at타임스탬프- 이미 시도한 수정 내용
5. 다음번엔 이렇게 막아요
PR 템플릿이나 workflow 보일러플레이트에 아래 세 가지를 기본으로 넣어두면 처음부터 피할 수 있어요.
concurrency:
group: ${{ github.workflow }}-${{ github.ref }}
cancel-in-progress: true
jobs:
build:
timeout-minutes: 20
steps:
- uses: actions/setup-node@v4
with:
node-version: '20'
cache: 'npm'
StarSling 사례에서도 “측정 먼저, 수정 나중"을 권해요. created_at → started_at 갭이 크면 runner 공급 문제, 그 외에는 대부분 YAML 설정이에요. 더 빠른 머신보다 불필요한 실행을 없애는 게 먼저예요. 위 설정 적용하고 나서 타임스탬프로 꼭 비교해보세요.
Photo by Rubaitul Azad on Unsplash


