🚀 GitHub Actions 완벽 가이드

🚀 GitHub Actions 완벽 가이드: CI/CD 자동화의 시작!

 

“GitHub Actions이 뭔지, 왜 써야 하는지, 그리고 어떻게 활용하는지를 상세히 파헤쳐 보자!”

📌 목차

 

1️⃣ GitHub Actions란?

2️⃣ GitHub Actions의 특징

3️⃣ GitHub Actions 워크플로우 구조

4️⃣ 주요 구성 요소 (이벤트, 작업, 단계, 액션, 러너)

5️⃣ GitHub Actions 주요 문법 및 예제

6️⃣ 결론

1️⃣ GitHub Actions란?

 

GitHub Actions는 GitHub 리포지토리에서 CI/CD 자동화를 구현할 수 있는 워크플로우 기반의 자동화 도구이다.

🔹 코드 푸시, PR, 머지, 이슈 생성 등 다양한 이벤트를 트리거로 실행 가능

🔹 YAML 파일을 사용하여 간단하게 설정 가능

🔹 GitHub 내에서 직접 실행되므로 추가 설정 없이 쉽게 사용 가능

 

💡 쉽게 말하면?

✔️ “코드가 push되면 테스트 & 배포 자동 실행해줘!”

✔️ “PR이 올라오면 코드 리뷰 전에 lint 검사를 자동으로 돌려줘!”

✔️ “버그 이슈가 생성되면 Slack에 알림을 보내줘!”

2️⃣ GitHub Actions의 특징

 

✅ GitHub 네이티브 통합

✔️ GitHub 리포지토리와 긴밀하게 연결되어 있으며, PR, 이슈, 푸시 등의 이벤트에 반응 가능

 

✅ YAML 기반 설정

✔️ .github/workflows/ 디렉터리에 YAML 파일을 생성하여 간편하게 워크플로우 작성

 

✅ 멀티 OS 및 환경 지원

✔️ Linux, Windows, macOS에서 실행 가능 (runs-on: ubuntu-latest 등)

✔️ 자체 호스팅 러너(Self-hosted Runner)도 가능

 

✅ 병렬 실행 및 매트릭스 전략 지원

✔️ 여러 환경에서 병렬로 실행 가능 (matrix를 활용한 다양한 Node.js 버전 테스트)

 

✅ 마켓플레이스 지원

✔️ GitHub Actions Marketplace에서 다양한 액션 재사용 가능 (uses: 활용)

 

✅ 비용 효율적

✔️ GitHub에서 기본 제공 (퍼블릭 리포지토리는 무료, 개인 리포지토리는 무료 제한 있음)

3️⃣ GitHub Actions 워크플로우 구조

 

GitHub Actions은 워크플로우(Workflow) 기반으로 작동한다.

🔹 워크플로우는 하나 이상의 **작업(Job)**으로 구성

🔹 작업(Job)은 여러 개의 **단계(Step)**을 가짐

🔹 단계(Step)는 하나 이상의 **액션(Action)**을 실행

 

📌 GitHub Actions 실행 흐름

📂 .github/workflows/
  ├── 🔧 my-workflow.yml

name: My CI Workflow  # 워크플로우 이름
on: push              # 푸시될 때 실행

jobs:
  test:               # 작업(Job) 이름
    runs-on: ubuntu-latest  # 실행 환경
    steps:            # 단계(Steps)
      - name: Checkout repository
        uses: actions/checkout@v3  # 액션 사용
      - name: Run test
        run: npm test  # 커맨드 실행

4️⃣ GitHub Actions 주요 구성 요소

 

🟢 1. 이벤트 (Event)

 

워크플로우를 실행시키는 트리거(Trigger) 역할을 한다.

🔹 코드 푸시 (push)

🔹 PR 생성 (pull_request)

🔹 이슈 생성 (issues)

🔹 특정 시간마다 실행 (schedule)

on:
  push:
    branches:
      - main

🟡 2. 작업 (Job)

 

각 Job은 독립적인 실행 단위이며, 여러 개의 Job을 하나의 워크플로우에서 실행할 수 있다.

🔹 여러 Job을 병렬로 실행 가능

🔹 Job 간 의존 관계 설정 가능 (needs:)

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Build Project
        run: npm run build

🟠 3. 단계 (Step)

 

각 Job 내부에서 실행되는 작업 단위

🔹 스크립트 실행 가능 (run:)

🔹 액션 사용 가능 (uses:)

steps:
  - name: Checkout code
    uses: actions/checkout@v3
  - name: Install dependencies
    run: npm install

🔵 4. 액션 (Action)

 

GitHub Actions에서 제공하는 재사용 가능한 작업 단위

🔹 공식 액션 또는 커스텀 액션 사용 가능

uses: actions/setup-node@v3
with:
  node-version: '16'

🟣 5. 러너 (Runner)

 

GitHub Actions이 실행되는 서버 환경

🔹 GitHub에서 제공하는 호스팅 러너 (runs-on: ubuntu-latest)

🔹 직접 설정 가능한 셀프 호스팅 러너 (self-hosted)

runs-on: ubuntu-latest

5️⃣ GitHub Actions 주요 문법 및 예제

 

1️⃣ PR이 생성될 때 Lint & Test 실행

name: Lint and Test

on:
  pull_request:
    branches: [main]

jobs:
  lint-test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v3
      - name: Install dependencies
        run: npm install
      - name: Run Lint
        run: npm run lint
      - name: Run Tests
        run: npm test

2️⃣ 다중 OS & Node.js 버전에서 테스트 실행 (Matrix Strategy)

name: Matrix Test

on: push

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [14, 16, 18]
        os: [ubuntu-latest, windows-latest]

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3
      - name: Setup Node.js
        uses: actions/setup-node@v3
        with:
          node-version: ${{ matrix.node-version }}
      - name: Install dependencies
        run: npm install
      - name: Run Tests
        run: npm test

3️⃣ 매일 오전 6시에 자동 실행 (Cron Schedule)

name: Daily Job

on:
  schedule:
    - cron: "0 6 * * *"  # UTC 기준 오전 6시 실행 (한국 시간 오후 3시)

jobs:
  run-scheduled-task:
    runs-on: ubuntu-latest
    steps:
      - name: Run Scheduled Task
        run: echo "Running scheduled task!"

🎯 결론: GitHub Actions, 왜 써야 할까?

 

✅ GitHub 네이티브 지원 → 설정이 간편하다

✅ YAML 기반 → 직관적인 워크플로우 작성 가능

✅ GitHub Marketplace 활용 → 다양한 액션 재사용 가능

✅ 병렬 실행 & 매트릭스 전략 → 테스트 자동화 최적화 가능

✅ 무료 플랜 제공 (퍼블릭 리포지토리)

 

“GitHub Actions를 활용하여, 효율적인 CI/CD 파이프라인을 구축해보세요!” 🚀

 

🌷 전설의 개발자가 되어봅시당! 🌷