🚀 GitHub Actions CI 워크플로

🚀 GitHub Actions CI 워크플로우: 구성과 단계 완벽 가이드

 

“GitHub Actions을 활용해 CI/CD 자동화를 구축하는 핵심 개념과 실전 예제를 정리해보자!”

📌 목차

 

1️⃣ 워크플로우 파일 생성

2️⃣ 트리거 이벤트 정의

3️⃣ 작업(Jobs) 및 단계(Steps) 정의

4️⃣ 실행 환경 지정

5️⃣ CI/CD 실전 예제

6️⃣ 결론

1️⃣ 워크플로우 파일 생성

 

GitHub Actions의 CI/CD 프로세스는 .github/workflows/ 폴더 내부의 YAML 파일에서 관리된다.

 

📌 기본적인 파일 구조

📂 프로젝트 루트
 ├── 📂 .github
 │    ├── 📂 workflows
 │    │    ├── 🔧 ci.yml  # CI/CD 설정 파일

📌 워크플로우 파일 생성 방법

 

1️⃣ 프로젝트 루트에 .github/workflows/ci.yml 파일 생성

2️⃣ YAML 형식으로 설정을 정의

name: CI Pipeline  # 워크플로우 이름

on: [push, pull_request]  # 실행 트리거 (이벤트)

💡 파일 생성 후 GitHub에 Push하면 자동으로 실행된다!

2️⃣ 트리거 이벤트 정의

 

워크플로우 실행을 트리거하는 이벤트를 설정한다.

 

📌 주요 트리거 이벤트

이벤트설명

push	특정 브랜치에 코드가 푸시될 때 실행
pull_request	PR이 생성되거나 업데이트될 때 실행
schedule	크론 스케줄러를 활용한 주기적 실행
workflow_dispatch	수동 실행 버튼 제공
release	릴리즈가 생성될 때 실행

📌 예제: push, pull_request 트리거 설정

on:
  push:
    branches:
      - main
      - develop
  pull_request:
    branches:
      - main

✅ main 및 develop 브랜치에 푸시되거나, PR이 생성될 때 실행

3️⃣ 작업(Jobs) 및 단계(Steps) 정의

 

GitHub Actions의 핵심은 작업(Jobs)과 단계(Steps) 이다.

 

📌 Jobs: 독립적인 실행 단위

 

각 Job은 독립적으로 실행되며, 병렬 실행 가능

jobs:
  test-job:
    runs-on: ubuntu-latest
    steps:
      - name: Print Hello
        run: echo "Hello, GitHub Actions!"

💡 여러 개의 Job을 정의하고, needs 키워드로 Job 간의 의존성을 설정 가능!

📌 Steps: Job 내부에서 실행되는 작업 단위

 

Step은 하나 이상의 명령어 실행(run:) 또는 액션 사용(uses:) 을 포함

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v3  # GitHub 리포지토리 코드 가져오기
      - name: Install dependencies
        run: npm install  # 의존성 설치
      - name: Run tests
        run: npm test  # 테스트 실행

4️⃣ 실행 환경 지정 (runs-on)

 

GitHub Actions은 다양한 OS에서 실행 가능

🔹 ubuntu-latest (리눅스)

🔹 windows-latest (윈도우)

🔹 macos-latest (맥)

 

📌 예제: OS별 실행

jobs:
  test:
    strategy:
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]  # 다중 OS 테스트
    runs-on: ${{ matrix.os }}
    steps:
      - name: Run Node.js Test
        run: npm test

✅ Ubuntu, MacOS, Windows에서 동시에 테스트 실행!

5️⃣ CI/CD 실전 예제

 

📌 1️⃣ Node.js 프로젝트에서 CI 실행

name: Node.js CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Set up Node.js
        uses: actions/setup-node@v3
        with:
          node-version: 16

      - name: Install dependencies
        run: npm install

      - name: Run tests
        run: npm test

✅ Node.js 16 환경에서 프로젝트 테스트 실행!

📌 2️⃣ React 프로젝트 빌드 및 Lint 테스트

name: React CI/CD Pipeline

on:
  push:
    branches:
      - main

jobs:
  build-and-test:
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v3

      - name: Install dependencies
        run: npm ci

      - name: Run ESLint
        run: npm run lint  # 린트 검사 실행

      - name: Run Unit Tests
        run: npm test  # 테스트 실행

      - name: Build Project
        run: npm run build  # 빌드 실행

✅ ESLint 검사 & 유닛 테스트 실행 후 React 프로젝트 빌드!

🎯 결론: GitHub Actions, 이렇게 활용하자!

 

✅ GitHub Actions을 활용하면 CI/CD 파이프라인을 쉽게 구축 가능!

✅ YAML 기반으로 직관적인 설정 가능!

✅ 다양한 OS 환경에서 병렬 실행 가능!

✅ CI/CD 자동화를 통해 개발 프로세스를 효율화 가능!

 

🚀 “이제 GitHub Actions로 자동화된 CI/CD 구축에 도전해보자!” 🚀

 

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