개발 문서/기타
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 환경을 구축하여 개발 효율성을 극대화할 수 있습니다. 간단한 설정만으로도 강력한 자동화 환경을 구축할 수 있으니 지금 바로 시작해 보세요!