5.6 KiB
Blog CI/CD
make-space의 Tekton 구조를 따릅니다. dahyeon/blog의 staging/prod push만
받으며 main, PR, 브랜치 삭제 이벤트는 배포하지 않습니다. 두 환경 모두 각각
소스 revision을 빌드합니다. staging 이미지의 별도 승격 파이프라인은 없습니다.
signed Gitea push
-> blog-clone (정확한 SHA와 브랜치 최신 커밋 확인)
-> blog-quality (fmt + Rust tests/architecture + SSR/WASM check)
-> blog-build-arm64 (rootless BuildKit -> Harbor)
-> blog-update-gitops (환경별 digest/source revision/replica 커밋)
-> Argo CD 자동 Sync
| 브랜치 | Pipeline | 갱신 파일 | URL |
|---|---|---|---|
staging |
blog-staging |
apps/blog/overlays/staging/kustomization.yaml |
https://blog.dahyeon.us |
prod |
blog-prod |
apps/blog/overlays/prod/kustomization.yaml |
https://rabbitmaus.com |
실행 계약
foundation.yaml은 ServiceAccount와 namespace RBAC, infisical-secret.yaml은 CI
자격 증명, tasks.yaml과 pipeline.yaml은 실행 단계, trigger.yaml과 ingress.yaml은
서명된 webhook 수신을 담당합니다. 클러스터 범위 권한과 공통 리소스 정책은 platform에 둡니다.
PipelineRun은 공유 tekton-ci의 ARM64 노드, 10 GiB local-path PVC를 사용합니다.
최대 시간은 90분(Tasks 85분)입니다. quality의 Cargo jobs는 2이며 debug symbols와
incremental cache를 줄입니다. 공통 quota와 완료 실행 정리는 platform-state 소유입니다.
quality는 앱 저장소의 sh tools/ci/check.sh를 실행합니다. Rust 1.100.0,
rustfmt, wasm32 target으로 ssr와 hydrate를 분리 검증하고 아키텍처 검사·전체 Rust
테스트를 실행합니다. MongoDB/Infisical에는 연결하지 않습니다. 상호작용·라우팅·폼·
hydration 변경 시 필요한 Playwright 검증은 앱 README의 별도 절차로 실행합니다.
이 초안은 DB 기반 브라우저 테스트를 자동화하지 않습니다.
빌드는 같은 SHA를 별도 디렉터리에 clone하고 앱 Dockerfile을 실행합니다.
sha-<40자리 소스 SHA>-<PipelineRun UID> 태그로 push한 뒤 실제 digest를 배포합니다.
이미지에는 SSR 바이너리·site·라이선스가 들어가며 Node와 dev-ui는 포함하지 않습니다.
DB/Entra ID Secret은 quality, Docker build, WASM 번들에서 사용하지 않습니다.
GitOps push 직전에 소스 브랜치 최신 SHA를 다시 확인합니다. service-state가 병렬 실행으로 앞서간 경우 자동 rebase나 force push 없이 실패하므로 최신 소스로 재실행합니다. 어느 Task든 실패하면 후속 GitOps 변경은 실행하지 않습니다.
처음 연결할 때
-
앱의 배포 브랜치에
Dockerfile,.dockerignore,tools/ci/check.sh와 컴파일에 필요한 생성 자산이 커밋되어 있어야 합니다. 로컬 미커밋 파일은 CI에 전달되지 않습니다. -
Harbor
dahyeon/blog접근 권한을 준비합니다. CI에는 push robot을,blog-staging/blog-prod의harbor-registry에는 pull 권한을 준비합니다. 기존 서비스와 동일하게 pull Secret 생성은 이 매니페스트의 범위 밖입니다. -
플랫폼 Infisical 프로젝트
8520b8c0-3796-4fd6-a03c-6f0508c8c42c, 환경prod, 경로/platform/tekton/blog에 다음 값을 등록합니다.키 용도 GITEA_USERNAME소스 읽기·service-state 쓰기 bot GITEA_TOKEN해당 bot의 토큰 HARBOR_DOCKER_CONFIG_JSONCI push용 Docker config JSON GITEA_WEBHOOK_SECRETpush 서명 검증 -
앱 런타임 Secret의 staging/prod 6개 키와 공유
infisical-authidentity의 프로젝트·환경·경로 권한을 확인합니다. -
platform-state의 네임스페이스·EventListener ClusterRole/Binding·
blog-ciApplication·prod 자동 Sync 허용·rabbitmaus.comHTTP-01 solver를 반영합니다. service-state의ci/blog, 앱 overlays도main에 반영합니다. 두 저장소 사이의 적용 순서는 sync-wave만으로 보장되지 않으므로 컨트롤러·네임스페이스·Secret이 준비된 뒤 첫 push를 보냅니다. 초안은 두 환경 모두 replica 0으로 시작합니다. -
앱 DNS가 Ingress로 연결되도록 설정합니다.
rabbitmaus.com의 HTTP-01 challenge 경로는 외부에서 접근 가능해야 합니다. 모든 블로그 Ingress는 SSL redirect를 끕니다. -
Gitea
dahyeon/blog에 JSON push webhookhttps://tekton-hook.dahyeon.us/blog를 등록하고 동일한 서명 secret을 사용합니다. 공유 webhook 호스트의 TLS Secret은 기존 lolympus Ingress가 발급합니다.
초안 작성만으로 webhook, Harbor 권한, Secret 값, DNS를 생성하거나 클러스터에 적용하지 않습니다. DB 마이그레이션·시드와 Entra ID 기능 구현도 실행하지 않습니다.
검증과 운영
kubectl kustomize ci/blog
kubectl kustomize apps/blog/overlays/staging
kubectl kustomize apps/blog/overlays/prod
CRD와 namespace가 준비된 클러스터에서는 별도로
kubectl apply --dry-run=server -k ci/blog를 실행합니다. 실제 연결 검증은 서명된 staging
push 한 건으로 PipelineRun, Harbor digest, service-state 커밋, Argo CD Sync, /healthz와
SSR/hydration을 확인합니다. 잘못된 서명·다른 브랜치·삭제 SHA는 실행을 만들면 안 됩니다.
Secret 갱신 후 앱 Pod 재생성이 필요하며, 파이프라인의 성공은 Argo CD rollout 완료를 의미하지 않습니다. 배포 완료는 해당 Application의 Synced/Healthy 상태까지 확인합니다.