# CI/CD 경계 — Gitea Actions는 CI, Argo CD는 CD ## 결론 Gitea Actions(`.gitea/workflows`)는 **검증하고 아티팩트를 만든다**. Argo CD는 **배포한다**. 두 역할은 겹치지 않는다. Gitea Actions 워크플로는 `kubectl apply`, `helm upgrade`, `argocd app sync` 중 어느 것도 하지 않는다. 그러므로 CI에는 클러스터 자격증명(kubeconfig, 서비스 계정 토큰)이 들어가지 않는다. ## 흐름 ```text git push / tag │ ▼ Gitea Actions ─────────────── CI ───────────────┐ • 테스트 · 정적분석 · 아키텍처 검증 │ • 컨테이너 이미지 빌드 │ • 취약점 스캔 (Trivy) │ • SBOM 생성 │ • 레지스트리에 이미지 push │ │ │ │ 이미지 태그(다이제스트)를 manifest에 기록 │ ▼ │ GitOps 저장소 (배포 희망 상태) ──────────────────┘ │ │ Argo CD가 watch ▼ Argo CD ──────────────────── CD ─────────────── │ auto-sync ▼ Kubernetes ``` 용어 한 줄 풀이: - **GitOps 저장소** — 클러스터에 무엇이 떠 있어야 하는지를 적어 둔 Git 저장소. 애플리케이션 소스와 분리한다. - **manifest** — Kubernetes에 넣을 YAML(Deployment, Service 등). - **auto-sync** — Argo CD가 GitOps 저장소의 변경을 스스로 감지해 클러스터에 반영하는 모드. 이걸 쓰면 CI가 Argo CD API 서버에 접근할 필요가 없다. ## 왜 이렇게 나누나 1. **자격증명 반경.** CI가 배포하면 CI 러너가 프로덕션 클러스터에 대한 쓰기 권한을 갖는다. 포크된 PR, 서드파티 액션, 캐시 오염이 모두 그 권한에 닿는다. auto-sync를 쓰면 그 권한은 클러스터 안의 Argo CD에만 있고, CI는 Git에 커밋만 한다. 2. **현재 상태의 소유자가 하나.** 클러스터에 무엇이 떠 있는지는 GitOps 저장소가 답한다. CI가 직접 apply 하면 답이 두 개가 된다 — Git에 적힌 것과 실제로 떠 있는 것. 3. **롤백이 revert.** 배포를 되돌리는 것이 `git revert`가 된다. ## 이 저장소의 현재 위치 | 항목 | 상태 | | --- | --- | | 이미지 빌드/스캔/push | `.gitea/workflows/release.yml`이 수행. 이 Gitea의 컨테이너 레지스트리 | | SBOM | `release.yml`이 생성(CycloneDX, 이미지 검사 전) | | 이미지 서명 | `release.yml`이 digest를 cosign 키 쌍으로 서명하고 확인한다(태그에서만) | | provenance attestation | **없음.** 추가 대상 | | GitOps 저장소 | **없음.** 별도 저장소로 만들 예정 | | Argo CD Application 정의 | **없음.** GitOps 저장소에 둘 예정 | | CI에서의 클러스터 접근 | 없음 — 유일했던 `kubectl apply`는 제거됨 | PVC 매니페스트와 그 파일을 검사하던 `release.yml` 잡(`fileserver-pvc-certification`)은 2026-11-07에 지웠다(소유자 결정: Kubernetes·프록시 설정은 이 repo 밖). 클러스터 인증은 배포하는 쪽이 `docs/fileserver/storage-certification.md` 절차로 하고, volume 조건은 `docs/fileserver/operations.md` 「운영 환경이 지켜야 할 조건」에 있다. ## 규칙 - 워크플로에 클러스터 자격증명 secret을 추가하지 않는다. - 배포 대상이 바뀌면 GitOps 저장소의 manifest를 바꾼다. 워크플로를 바꾸지 않는다. - CI가 만드는 것은 **불변 다이제스트로 지정된 이미지**다. `latest` 태그로 배포하지 않는다.