Files
clean-architecture-backend-…/docs/ci-cd/boundary.md
T
DongHyeonka a025f244c7 refactor(repo)!: 쓰지 않는 파일과 운영 인프라 파일을 지운다
문제: infra/ 43개 중 12개는 코드·테스트·workflow·스크립트 어디서도
읽지 않는다(httpclient·jpa·messaging·notification의 toxiproxy compose와
README). nginx 설정, Kubernetes PVC 인증 job, DB 역할 SQL 셋은 운영
인프라라 개발 repo에 둘 것이 아니다(소유자 결정 2026-11-07). release.yml
의 fileserver-pvc-certification job은 그 매니페스트 문자열만 grep했다.

고른 방법:
- 15개를 지운다.
- 운영 조건만 그 기능 문서에 한국어로 남긴다.
  docs/fileserver/operations.md 「운영 환경이 지켜야 할 조건」(nginx
  internal location·alias·X-Accel-Redirect 헤더 제거·스트리밍, PVC
  ReadWriteOnce·fsGroup), storage-certification.md(인증 절차),
  docs/jpa/security.md 「역할과 권한」·「서버 설정」(역할 SQL과
  jpa/postgres README 내용), docs/messaging/security.md(인증서 SAN).
  httpclient TLS README 내용은 docs/httpclient/security.md에 이미 있다.
- release.yml job과 needs 줄, fileserver-pr.yml·pr-adapters.yml의 지운
  경로 필터를 지운다.
- fileserver 지원 표의 "Kubernetes ReadWriteOnce PVC — Limited" 행은
  근거 job이 없어져 「주장하지 않음」으로 옮긴다.
버린 대안: 인프라 파일을 project-infra로 옮기기(설계 Q6). 그 repo는
특정 프로젝트용이라 범용 템플릿 파일을 받을 자리가 없다.

위험·한계: 지원 표에서 PVC 주장이 빠진다. 파생 서비스가 그 파일을
배포에 썼다면 병합이 지운다(B-50). 클러스터 인증은 이제 배포하는 쪽이
문서 절차로 한다.

검증(desktop, 트리 749a3328, ~/t1-layout-logs/):
- :composition:fileserver-platform:check :app-bootstrap:check
  :app-bootstrap:documentContractTest rc=0 (repositoryContractTest,
  FileserverDocumentationCoverageTest 실행)
- :verifyStrictLaneStages --dry-run rc=0
- scripts/verify-compose-profile-contracts.sh rc=0 (18 lane)
- check-work-docs.py, 상대 링크 검사 rc=0

Refs: design-docs repo-structure/01-backend-layout.md 4.4, 6.3
BREAKING CHANGE: infra/fileserver/nginx, infra/fileserver/kubernetes, infra/jpa, infra/httpclient, infra/messaging, infra/notification/toxiproxy와 release.yml fileserver-pvc-certification job이 없어진다. docs/upgrade/2026-11-maturity-review.md B-50.
2026-11-07 12:22:47 +09:00

3.7 KiB

CI/CD 경계 — GitHub Actions는 CI, Argo CD는 CD

결론

GitHub Actions는 검증하고 아티팩트를 만든다. Argo CD는 배포한다. 두 역할은 겹치지 않는다.

GitHub Actions 워크플로는 kubectl apply, helm upgrade, argocd app sync 중 어느 것도 하지 않는다. 그러므로 CI에는 클러스터 자격증명(kubeconfig, 서비스 계정 토큰)이 들어가지 않는다.

흐름

   git push / tag
        │
        ▼
  GitHub 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 release.yml이 수행
SBOM release.yml이 생성
이미지 서명 · 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 태그로 배포하지 않는다.