ci(blog): publish and verify CDN assets before GitOps updates

Export the runtime image and assets together, gate deployment on verified S3 release completion, and share AWS credentials from /platform/tekton/blog in ap-southeast-2.
This commit is contained in:
dahyeon committed 2026-11-18 21:15:53 +09:00
1 parent c313573442
commit 87a1d04da1
6 files changed
+206 -6

No files matched your search

+29 -3
View File
@@ -8,8 +8,8 @@
signed Gitea push
-> blog-clone (정확한 SHA와 브랜치 최신 커밋 확인)
-> blog-quality (Dockerfile quality: fmt + SSR tests/architecture + WASM check)
-> blog-build-arm64 (rootless BuildKit -> Harbor)
-> blog-update-gitops (환경별 digest/source revision/replica 커밋)
-> blog-build-arm64 (CDN 도구 검사 -> BuildKit image+rootfs -> CDN package/upload/HEAD 검증)
-> blog-update-gitops (환경별 digest/source revision/CDN release/replica 커밋)
-> Argo CD 자동 Sync
```
@@ -48,6 +48,30 @@ hydration 변경 시 필요한 Playwright 검증은 앱 README의 별도 절차
이미지에는 SSR 바이너리·site·라이선스가 들어가며 Node와 dev-ui는 포함하지 않습니다.
DB/Entra ID Secret은 quality, Docker build, WASM 번들에서 사용하지 않습니다.
`cdn.yaml`은 공용 버킷 `rabbitmaus`(`ap-southeast-2`)와 `https://cdn.rabbitmaus.com`을
사용합니다. prod 프로젝트는 `blog`, staging은 `blog-staging`이므로 HTTPS 원본도 서로 다른
prefix로 선택할 수 있습니다. CI에서 source SHA + LF + PipelineRun UID의 SHA-256 앞 16자를
계산하고 같은 CDN 설정을 SSR·WASM에 컴파일합니다. BuildKit은 단일 solve에서 image와 local
rootfs를 함께 내보냅니다. `/app/site`를 다시 빌드하지 않고 앱 저장소 `tools/cdn`으로 포장합니다.
`pkg/`는 원본·br·gzip, `assets/`는 WOFF2 원본만 S3에 게시합니다. 나머지 공개 파일은
프로젝트 HTTPS 원본이 제공합니다. 모든 객체를 조건부 PUT 후 checksum-enabled HEAD로
검사하며, 완료 매니페스트가 성공해야 CDN Task 결과와 후속 GitOps 갱신을 허용합니다.
GitOps annotation에는 release ID와 S3 완료 키도 남깁니다. 충돌하는 객체는 덮어쓰지 않고
실패하며 이전 릴리즈·부분 업로드를 자동 삭제하지 않습니다.
Infisical 플랫폼 프로젝트의 `prod` 환경, 기존 `/platform/tekton/blog` 경로에
`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`를 등록합니다. 기존 `blog-ci-credentials`가
공용 Kubernetes Secret `blog-cdn`으로 동기화하며 prod/staging의 `publish-cdn` step만 받습니다.
이 공용 CI 주체에는 버킷의 `blog/*`, `blog-staging/*` 두 prefix에 대한
`s3:PutObject`·`s3:GetObject` 권한이 필요합니다. 임시 자격 증명은
`AWS_SESSION_TOKEN`을 Secret template에 추가합니다. 앱 Pod에는 S3 쓰기 권한이 없습니다.
CloudFront 리소스와 Function은 이 변경에 포함하지 않습니다. 두 S3 behavior와
`/blog/*` → prod HTTPS, `/blog-staging/*` → staging HTTPS, CORS·OAC·압축 선택을 먼저 구성해야
합니다. 업로드 성공은 CF 설정의 정확성까지 보장하지 않습니다. 앱 저장소의
`tools/cdn/README.md`에 객체·메타데이터·참조 변환과 로컬 검증 계약을 정리했습니다.
두 BuildKit 작업은 `registry.dahyeon.us/dahyeon/blog`의
`cache-quality-deps-arm64-<staging|prod>`, `cache-quality-arm64-<staging|prod>`,
`cache-release-arm64-<staging|prod>` 태그를 `mode=max`로 저장합니다.
@@ -65,7 +89,7 @@ GitOps push 직전에 소스 브랜치 최신 SHA를 다시 확인합니다. ser
## 처음 연결할 때
1. 앱의 배포 브랜치에 `Dockerfile`, `.dockerignore`, `tools/ci/check.sh`와 컴파일에
1. 앱의 배포 브랜치에 `Dockerfile`, `.dockerignore`, `tools/ci/check.sh`, `tools/cdn`(잠금 파일 포함)과 컴파일에
필요한 생성 자산이 커밋되어 있어야 합니다. 로컬 미커밋 파일은 CI에 전달되지 않습니다.
2. Harbor `dahyeon/blog` 접근 권한을 준비합니다. CI에는 push robot을,
`blog-staging`/`blog-prod`의 `harbor-registry`에는 pull 권한을 준비합니다.
@@ -79,6 +103,8 @@ GitOps push 직전에 소스 브랜치 최신 SHA를 다시 확인합니다. ser
| `GITEA_TOKEN` | 해당 bot의 토큰 |
| `HARBOR_DOCKER_CONFIG_JSON` | CI push용 Docker config JSON |
| `GITEA_WEBHOOK_SECRET` | push 서명 검증 |
| `AWS_ACCESS_KEY_ID` | prod/staging 공용 S3 게시 자격 증명 |
| `AWS_SECRET_ACCESS_KEY` | 해당 AWS 키의 비밀 키 |
4. [앱 런타임 Secret](../../apps/blog/README.md)의 staging/prod 6개 키와 공유
`infisical-auth` identity의 프로젝트·환경·경로 권한을 확인합니다.