Skip to content

CICD Pipeline

wcorn edited this page Jun 15, 2026 · 2 revisions

CI/CD 파이프라인

GitHub Actions 기반 CI/CD 구조를 정의한다.

1. 전체 흐름

PR 생성 (feature → main)
    ↓
CI: 빌드 + 테스트 + 린트
    ↓
코드 리뷰 → 머지
    ↓
CD: Docker 이미지 빌드 → GHCR 푸시
    ↓
ArgoCD Image Updater: 새 이미지 감지 → digest 커밋
    ↓
ArgoCD: Git 변경 감지 → 클러스터 동기화 → Rolling Update

2. CI (Pull Request)

PR이 main 브랜치로 열릴 때 변경된 경로에 따라 실행된다.

워크플로우 트리거 경로 실행 내용
BE CI be/** ./gradlew build (컴파일 + 테스트)
FE CI fe/** npm ci → npm run lint → npm run build
Infra CI infra/** yamllint → helm lint → kubeconform

BE CI

  • JDK 25 (Temurin) + Gradle 설정
  • ./gradlew build가 컴파일, 테스트, JAR 패키징을 모두 수행
  • TestContainers 테스트는 GitHub Actions의 Docker 환경에서 자동 실행

FE CI

  • Node.js 22 + npm 캐싱
  • lint: ESLint로 코드 품질 검사
  • build: TypeScript 타입 체크 (tsc -b) + Vite 번들링

Infra CI

3개 잡이 병렬로 실행된다.

잡 도구 역할
yaml-lint yamllint YAML 문법/포맷 검사
helm-lint helm lint Chart 구조/값 검증
kubeconform kubeconform 생성된 K8s 매니페스트의 스키마 검증
  • helm-lint와 kubeconform은 upstream dependency를 build한 후 실행
  • kubeconform은 자체 템플릿 Chart(be, fe, mysql, redis)만 대상으로 검증

Terraform / Ansible (IaC) CI

infra/terraform/**·infra/ansible/** 변경 시 전용 워크플로우가 PR에서 미리보기/검증한다.

워크플로우 PR에서 인증/접근
terraform terraform plan (결과를 job summary로 출력) AWS OIDC(정적 키 없음), role github-actions-terraform
ansible ansible-lint + ansible-playbook --syntax-check —

3. CD (Push to main)

main 브랜치에 머지되면 변경된 경로에 따라 실행된다.

워크플로우 트리거 경로 실행 내용
BE CD be/** Docker 이미지 빌드 → GHCR 푸시
FE CD fe/** Docker 이미지 빌드 → GHCR 푸시
terraform infra/terraform/** terraform apply -auto-approve (OIDC)
ansible infra/ansible/** ansible-playbook (tailnet 경유 노드 적용, ANSIBLE_APPLY_ENABLED 게이트)

IaC 자동 적용 (Terraform / Ansible)

terraform/ansible은 수동 apply하지 않는다 — PR로 plan/lint 확인 후 main 머지 시 자동 반영.

  • Terraform: GitHub Actions가 OIDC로 AWS STS 단기 자격증명을 받아(role-to-assume: github-actions-terraform, trust는 repo:wcorn/orino로 제한) terraform apply. 정적 AWS 키 없음. state는 S3 backend.
  • Ansible: 러너는 GitHub-hosted라 NAT 뒤 노드(note1/note2)에 직접 못 닿음 → tailscale/github-action(OAuth tag:ci)으로 tailnet에 ephemeral 조인 + 클러스터의 **Tailscale Connector(subnet router)**가 광고한 192.168.0.0/24 경유로 노드 SSH 후 ansible-playbook. 노드 호스트엔 아무것도 설치하지 않는다. CI SSH 키·become 비번은 GitHub Secret.
    • subnet route는 tailnet에서 승인돼야 한다(autoApprovers ACL 또는 admin 콘솔 수동 approve).

이미지 빌드 및 푸시

1. GHCR 로그인 (GITHUB_TOKEN)
2. 메타데이터 추출 (태그 생성)
3. Docker 빌드 + 푸시

이미지 태깅 전략

태그 형식 용도
SHA {커밋 해시} 특정 커밋 추적, 롤백 시 사용
latest latest Image Updater가 감시하는 태그

모든 이미지는 ghcr.io/{owner}/{repo}/{be|fe} 경로에 저장된다.

자동 배포 (Image Updater → ArgoCD)

GHCR에 latest 태그로 새 이미지 푸시
    ↓
ArgoCD Image Updater: latest 태그의 digest 변경 감지
    ↓
Helm values의 image.tag를 새 digest로 업데이트 → Git 커밋
    ↓
ArgoCD: Git 변경 감지 → Helm template 렌더링 → 클러스터 동기화
    ↓
Deployment Rolling Update (health probe 기반)
  • updateStrategy: digest — 동일 태그(latest)의 SHA256 변경을 추적
  • 이미지 내용이 변경되지 않으면 배포가 발생하지 않음

4. 롤백

이미지 롤백

ArgoCD에서 이전 sync revision으로 롤백하거나, Image Updater가 커밋한 digest를 이전 값으로 되돌린다.

인프라 롤백

Git에서 해당 커밋을 revert하면 ArgoCD가 자동으로 이전 상태로 동기화한다.

5. 워크플로우 추가 가이드

새 애플리케이션의 CI/CD 워크플로우를 추가할 때:

CI 워크플로우

on:
  pull_request:
    branches: [ main ]
    paths:
      - '{app}/**'

CD 워크플로우

on:
  push:
    branches: [ main ]
    paths:
      - '{app}/**'
  • 이미지 이름: ghcr.io/{owner}/{repo}/{app}
  • 태그: SHA + latest
  • Dockerfile: {app}/Dockerfile
  • Image Updater에 감시 대상 등록 필요

Clone this wiki locally