M6: CI/CD 고도화¶

개요¶

M6 단계에서는 4단계에 걸쳐 CI/CD 파이프라인을 체계적으로 고도화했다. 총 16개의 GitHub Actions 워크플로우를 구축하여 코드 품질, 보안, 배포, 모니터링을 자동화하고, 폐쇄망 환경을 위한 오프라인 배포 패키지를 제공한다.

4단계 고도화 구조¶

graph TD
    subgraph "1단계: 기반 구축"
        A[ci.yml] --> B[reusable-test.yml]
        C[docker-publish.yml] --> D[GHCR 배포]
        E[security.yml] --> F[Trivy + CodeQL]
    end

    subgraph "2단계: 품질 게이트"
        G[pr-labeler.yml] --> H[자동 라벨링]
        I[dependabot-auto-merge.yml] --> J[의존성 자동 머지]
        K[publish-package.yml] --> L[PyPI 배포]
    end

    subgraph "3단계: 배포 확장"
        M[selective-deploy.yml] --> N[Feature Flag 배포]
        O[deploy-cloud-run.yml] --> P[Cloud Run]
        Q[offline-package.yml] --> R[오프라인 패키지]
    end

    subgraph "4단계: 관측/실험"
        S[dora-metrics.yml] --> T[DORA 메트릭]
        U[lean-experiment.yml] --> V[Lean 실험 스코어]
        W[monitor-cloud-run.yml] --> X[Cloud Run 모니터링]
    end

    A --> G --> M --> S

워크플로우 목록¶

1단계: CI/CD 기반 구축¶

2단계: 품질 게이트 강화¶

3단계: 배포 전략 확장¶

4단계: 관측 및 실험¶

Docker GHCR + Trivy 보안¶

Docker 이미지 빌드 및 배포¶

docker-publish.yml이 main 브랜치 push 또는 태그 생성 시 Docker 이미지를 빌드하여 GitHub Container Registry(GHCR)에 배포한다.

코드 Push / Tag
    |
    v
Docker Build (멀티 스테이지)
    |
    v
Trivy 취약점 스캔
    |
    v  CRITICAL/HIGH 취약점 0건 확인
GHCR Push (ghcr.io/govon-org/govon)

보안 스캔 구성¶

security.yml이 매일 정기 스캔과 PR/push 시 실시간 스캔을 수행한다.

Shift-Left 테스트 + 커버리지 가드¶

ci.yml에서 모든 PR에 대해 린트, 테스트, 커버리지를 검증한다.

테스트 파이프라인¶

PR 생성
    |
    v
Black (코드 포맷팅) + isort (임포트 정렬) + flake8 (린트)
    |
    v
pytest --cov=src (단위 테스트 + 커버리지)
    |
    v  커버리지 기준 미달 시 실패
PR 머지 가능

재사용 가능 테스트¶

reusable-test.yml은 여러 워크플로우에서 호출 가능한 공용 테스트 잡이다. Python 버전 매트릭스, 캐싱, 의존성 설치를 표준화하여 중복을 제거했다.

오프라인 배포 패키지¶

공공기관 폐쇄망 환경에서 인터넷 연결 없이 시스템을 설치할 수 있도록 오프라인 배포 패키지를 생성한다.

패키지 구성¶

offline-package.yml이 릴리즈 생성 시 자동으로 아래 항목을 번들링한다.

폐쇄망 설치 절차¶

# 1. 오프라인 패키지를 USB 등으로 폐쇄망 서버에 전달
# 2. 압축 해제 및 설치
tar xzf govon-offline-v1.0.0.tar.gz
cd govon-offline-v1.0.0
./install.sh

Lean Startup 실험¶

lean-experiment.yml은 프로젝트의 Lean Startup 실험 메트릭을 자동으로 산출한다.

측정 항목¶

DORA 메트릭¶

dora-metrics.yml은 매일 DevOps 핵심 지표를 수집한다.

Feature Flag 기반 배포¶

selective-deploy.yml은 Feature Flag를 기반으로 기능 단위의 선택적 배포를 수행한다. 새로운 기능을 전체 사용자에게 한 번에 배포하지 않고, 특정 조건(환경, 사용자 그룹)에 따라 점진적으로 릴리즈할 수 있다.

Cloud Run 배포 및 모니터링¶

배포¶

deploy-cloud-run.yml이 main 브랜치 push 또는 태그 생성 시 Google Cloud Run에 자동 배포한다.

모니터링¶

monitor-cloud-run.yml이 정기적으로 Cloud Run 서비스의 헬스 상태를 확인한다.

관련 PR¶

M6 고도화는 총 46개의 PR(#238 -- #283)을 통해 완료되었다. 모든 작업은 2026-03-27에 마무리되었다.