GitHub Actions Reference

GitHub Actions Reference 소개

GitHub Actions 레퍼런스는 .github/workflows/에 저장하는 GitHub Actions 워크플로 파일의 YAML 구문 치트 시트입니다. 워크플로 수준 설정(name, 파일 위치, permissions, 전역 env 변수, 불필요한 실행을 취소하는 concurrency 제어), 트리거 이벤트(브랜치 및 경로 필터가 포함된 on: push, pull_request 이벤트, cron 스케줄, 입력 파라미터가 있는 수동 workflow_dispatch, 재사용 가능 워크플로를 위한 workflow_call), 작업 정의(jobs 블록, Ubuntu/macOS/Windows 러너를 위한 runs-on, 작업 의존성을 위한 needs, 조건부 실행을 위한 if, postgres 및 redis 같은 서비스 컨테이너), 스텝 지시어(actions/checkout@v4 및 actions/setup-node@v4 같은 서드파티 액션을 위한 uses, 셸 명령을 위한 run, 액션 파라미터를 위한 with, github 컨텍스트 변수, 스텝 출력 참조), 시크릿과 변수(${{ secrets.NAME }}, GITHUB_TOKEN, ${{ vars.NAME }}, 환경 범위 시크릿), 매트릭스 전략(다차원 빌드 매트릭스, include/exclude 조합, fail-fast 동작, max-parallel 제한)의 여섯 가지 핵심 영역을 다룹니다.

GitHub Actions는 GitHub에 직접 내장된 CI/CD 플랫폼으로 전 세계 수백만 개의 오픈소스 및 엔터프라이즈 개발 팀이 사용합니다. 프론트엔드 개발자는 PR에서 npm 빌드와 테스트를 자동화하고, 백엔드 엔지니어는 Docker 이미지를 빌드하여 클라우드 플랫폼에 배포합니다. DevOps 팀은 여러 Node.js 버전과 운영체제에 걸쳐 동시에 테스트하는 매트릭스 빌드를 구성합니다. 재사용 가능한 workflow_call 트리거는 저장소 전체에서 DRY 파이프라인 아키텍처를 가능하게 합니다.

이 레퍼런스의 모든 항목은 정확한 YAML 키, 간결한 설명, 워크플로 파일에 바로 복사할 수 있는 실제 값이 포함된 완전한 YAML 블록을 제공합니다. if 조건으로 메인 브랜치에서만 작업 실행, $GITHUB_OUTPUT으로 스텝 간 데이터 전달, concurrency 그룹으로 진행 중인 실행 취소, strategy: matrix로 다중 환경 테스트 같은 실무 패턴을 여섯 개의 필터 가능한 카테고리로 정리합니다.

주요 기능

• 워크플로 설정: name, .github/workflows 경로, permissions(contents/packages/pull-requests), env, cancel-in-progress를 포함한 concurrency
• 트리거: on: push(브랜치/경로), pull_request(types), schedule(cron), workflow_dispatch(inputs), workflow_call(재사용)
• 작업: jobs 블록, runs-on(ubuntu/macos/windows), 의존성을 위한 needs, 조건부를 위한 if, 서비스(postgres/redis)
• 스텝: uses(actions/checkout@v4, setup-node@v4), run(셸 명령), with(액션 입력), github 컨텍스트 변수
• 스텝 출력: ${{ steps.id.outputs.name }} 패턴, 스텝 간 값 전달을 위한 $GITHUB_OUTPUT 환경 파일
• 시크릿과 변수: ${{ secrets.NAME }}, 자동 제공되는 GITHUB_TOKEN, ${{ vars.NAME }}, 환경 범위 시크릿
• 매트릭스 전략: 다차원 os/node-version 매트릭스, include/exclude 조합, fail-fast, max-parallel
• 불필요한 실행을 취소하는 concurrency 그룹, 보안 워크플로를 위한 permissions 범위 설정

자주 묻는 질문