테크 경제

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

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_at vs started_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