Repository navigation
CICD Pipeline
wcorn edited this page Jun 15, 2026
·
2 revisions
GitHub Actions 기반 CI/CD 구조를 정의한다.
PR 생성 (feature → main)
↓
CI: 빌드 + 테스트 + 린트
↓
코드 리뷰 → 머지
↓
CD: Docker 이미지 빌드 → GHCR 푸시
↓
ArgoCD Image Updater: 새 이미지 감지 → digest 커밋
↓
ArgoCD: Git 변경 감지 → 클러스터 동기화 → Rolling Update
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 |
- JDK 25 (Temurin) + Gradle 설정
-
./gradlew build가 컴파일, 테스트, JAR 패키징을 모두 수행 - TestContainers 테스트는 GitHub Actions의 Docker 환경에서 자동 실행
- Node.js 22 + npm 캐싱
- lint: ESLint로 코드 품질 검사
- build: TypeScript 타입 체크 (
tsc -b) + Vite 번들링
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)만 대상으로 검증
infra/terraform/**·infra/ansible/** 변경 시 전용 워크플로우가 PR에서 미리보기/검증한다.
| 워크플로우 | PR에서 | 인증/접근 |
|---|---|---|
| terraform |
terraform plan (결과를 job summary로 출력) |
AWS OIDC(정적 키 없음), role github-actions-terraform
|
| ansible |
ansible-lint + ansible-playbook --syntax-check
|
— |
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 게이트) |
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(OAuthtag: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} 경로에 저장된다.
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 변경을 추적 - 이미지 내용이 변경되지 않으면 배포가 발생하지 않음
ArgoCD에서 이전 sync revision으로 롤백하거나, Image Updater가 커밋한 digest를 이전 값으로 되돌린다.
Git에서 해당 커밋을 revert하면 ArgoCD가 자동으로 이전 상태로 동기화한다.
새 애플리케이션의 CI/CD 워크플로우를 추가할 때:
on:
pull_request:
branches: [ main ]
paths:
- '{app}/**'on:
push:
branches: [ main ]
paths:
- '{app}/**'- 이미지 이름:
ghcr.io/{owner}/{repo}/{app} - 태그: SHA + latest
- Dockerfile:
{app}/Dockerfile - Image Updater에 감시 대상 등록 필요