개발 문서/기타

GitHub Actions로 CI/CD 구축하기

copg 2025. 3. 16. 18:27
728x90
반응형

최근 소프트웨어 개발 환경에서는 지속적 통합(CI) 및 지속적 배포(CD)가 필수입니다. GitHub Actions는 이러한 CI/CD 파이프라인을 손쉽게 구현할 수 있는 도구입니다. 이번 포스팅에서는 GitHub Actions를 사용하여 CI/CD 구축 방법을 자세히 설명합니다.


🎯 GitHub Actions란?

GitHub Actions는 GitHub에서 제공하는 자동화된 워크플로우 도구로, 소스 코드 빌드, 테스트, 배포와 같은 작업을 자동화할 수 있게 합니다.


🔧 GitHub Actions의 작동 원리

GitHub Actions는 워크플로우 파일을 이용해 작업을 수행합니다.

  • .github/workflows 폴더 안에 YAML 형식으로 작성된 워크플로우 파일을 추가하면 자동으로 감지하여 실행합니다.

📌 GitHub Actions로 CI/CD 구축하기 (예제)

1️⃣ 워크플로우 기본 구조

name: CI/CD

on:
  push:
    branches:
      - main

jobs:
  build:
    runs-on: ubuntu-latest

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

      - name: Setup Python
        uses: actions/setup-python@v4
        with:
          python-version: '3.11'

      - name: Install dependencies
        run: |
          python -m pip install --upgrade pip
          pip install -r requirements.txt

      - name: Run Tests
        run: |
          pytest

이 파일은 메인 브랜치에 푸시될 때마다 실행되며, Python 환경을 구성하고 테스트를 수행합니다.

2️⃣ Docker 이미지 빌드 및 배포 예제

Docker를 사용하여 앱을 배포하는 방법도 쉽게 자동화할 수 있습니다.

name: Docker Build and Deploy

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: ubuntu-latest

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

      - name: Login to DockerHub
        uses: docker/login-action@v2
        with:
          username: ${{ secrets.DOCKER_USERNAME }}
          password: ${{ secrets.DOCKER_PASSWORD }}

      - name: Build and Push Docker Image
        uses: docker/build-push-action@v4
        with:
          context: .
          push: true
          tags: username/repository:latest

Docker Hub 계정 정보를 GitHub Secrets에 추가한 뒤 위의 파일을 사용하면 자동으로 Docker 이미지를 빌드하고 배포할 수 있습니다.


🛡️ 보안 설정

  • 민감한 정보는 반드시 GitHub Secrets에 저장하여 관리하세요.
  • GitHub Secrets는 Repository의 Settings → Secrets and variables → Actions에서 설정할 수 있습니다.

🚨 트러블슈팅

  • CI/CD 실패 시, GitHub Actions의 "Actions" 탭에서 로그를 확인하고 문제를 쉽게 파악할 수 있습니다.

🌟 결론

GitHub Actions를 통해 쉽고 빠르게 CI/CD 환경을 구축하여 개발 효율성을 극대화할 수 있습니다. 간단한 설정만으로도 강력한 자동화 환경을 구축할 수 있으니 지금 바로 시작해 보세요!