107 lines
6.8 KiB
Markdown
107 lines
6.8 KiB
Markdown
# Blog CI/CD
|
|
|
|
`make-space`의 Tekton 구조를 따릅니다. `dahyeon/blog`의 `staging`/`prod` push만
|
|
받으며 `main`, PR, 브랜치 삭제 이벤트는 배포하지 않습니다. 두 환경 모두 각각
|
|
소스 revision을 빌드합니다. staging 이미지의 별도 승격 파이프라인은 없습니다.
|
|
|
|
```text
|
|
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 커밋)
|
|
-> Argo CD 자동 Sync
|
|
```
|
|
|
|
| 브랜치 | Pipeline | 갱신 파일 | URL |
|
|
| --- | --- | --- | --- |
|
|
| `staging` | `blog-staging` | `apps/blog/overlays/staging/kustomization.yaml` | `https://blog-staging.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의 메모리 요청은 6Gi, 이미지 빌드는 2Gi이며
|
|
두 빌드의 메모리 제한은 10Gi입니다. Cargo jobs는 1이며 incremental은 끕니다.
|
|
quality는 dev/test debug symbols도 끕니다.
|
|
공통 quota와 완료 실행 정리는 platform-state 소유입니다.
|
|
|
|
quality는 rootless BuildKit으로 앱 Dockerfile의 `quality` target을 명시적으로 빌드합니다.
|
|
내부의 `sh tools/ci/check.sh`는 Rust 1.100.0으로 fmt·SSR 전체 테스트(아키텍처 포함)·
|
|
WASM check를 실행합니다. SSR 컴파일은 테스트가 담당하며 중복 check는 실행하지 않습니다.
|
|
MongoDB/Infisical에는 연결하지 않습니다. 상호작용·라우팅·폼·
|
|
hydration 변경 시 필요한 Playwright 검증은 앱 README의 별도 절차로 실행합니다.
|
|
이 초안은 DB 기반 브라우저 테스트를 자동화하지 않습니다.
|
|
|
|
빌드는 같은 SHA를 별도 디렉터리에 clone하고 앱 Dockerfile의 `runtime` target을 실행합니다.
|
|
공통 도구 → cargo-chef 의존성 → WASM → SSR 순서로 빌드하며 서버와 WASM 컴파일은 겹치지 않습니다.
|
|
`sha-<40자리 소스 SHA>-<PipelineRun UID>` 태그로 push한 뒤 실제 digest를 배포합니다.
|
|
이미지에는 SSR 바이너리·site·라이선스가 들어가며 Node와 dev-ui는 포함하지 않습니다.
|
|
DB/Entra ID Secret은 quality, Docker build, WASM 번들에서 사용하지 않습니다.
|
|
|
|
두 BuildKit 작업은 `registry.dahyeon.us/dahyeon/blog`의
|
|
`cache-quality-arm64-<staging|prod>` / `cache-release-arm64-<staging|prod>` 태그를
|
|
`mode=max`로 저장합니다. 같은 브랜치의 두 캐시를 읽어 도구 레이어도 재사용하되,
|
|
검사의 dev-ui/test 산출물과 배포의 release 산출물은 별도 의존성 단계로 관리합니다.
|
|
변경 없는 검사 입력은 성공한 quality 레이어를 재사용할 수 있습니다.
|
|
최초 실행은 캐시가 없어도 진행합니다. 캐시 태그는 덮어쓰기를 허용하고 Harbor 정리 정책에서
|
|
유지해야 합니다. 동시 실행이 같은 캐시 태그를 갱신하면 마지막 실행의 캐시가 남습니다.
|
|
캐시는 일반 빌드 레이어에 저장하며 임시 BuildKit의 cache mount나 실행별 PVC에 의존하지 않습니다.
|
|
|
|
GitOps push 직전에 소스 브랜치 최신 SHA를 다시 확인합니다. service-state가 병렬
|
|
실행으로 앞서간 경우 자동 rebase나 force push 없이 실패하므로 최신 소스로 재실행합니다.
|
|
어느 Task든 실패하면 후속 GitOps 변경은 실행하지 않습니다.
|
|
|
|
## 처음 연결할 때
|
|
|
|
1. 앱의 배포 브랜치에 `Dockerfile`, `.dockerignore`, `tools/ci/check.sh`와 컴파일에
|
|
필요한 생성 자산이 커밋되어 있어야 합니다. 로컬 미커밋 파일은 CI에 전달되지 않습니다.
|
|
2. Harbor `dahyeon/blog` 접근 권한을 준비합니다. CI에는 push robot을,
|
|
`blog-staging`/`blog-prod`의 `harbor-registry`에는 pull 권한을 준비합니다.
|
|
기존 서비스와 동일하게 pull Secret 생성은 이 매니페스트의 범위 밖입니다.
|
|
3. 플랫폼 Infisical 프로젝트 `8520b8c0-3796-4fd6-a03c-6f0508c8c42c`, 환경 `prod`,
|
|
경로 `/platform/tekton/blog`에 다음 값을 등록합니다.
|
|
|
|
| 키 | 용도 |
|
|
| --- | --- |
|
|
| `GITEA_USERNAME` | 소스 읽기·service-state 쓰기 bot |
|
|
| `GITEA_TOKEN` | 해당 bot의 토큰 |
|
|
| `HARBOR_DOCKER_CONFIG_JSON` | CI push용 Docker config JSON |
|
|
| `GITEA_WEBHOOK_SECRET` | push 서명 검증 |
|
|
|
|
4. [앱 런타임 Secret](../../apps/blog/README.md)의 staging/prod 6개 키와 공유
|
|
`infisical-auth` identity의 프로젝트·환경·경로 권한을 확인합니다.
|
|
5. platform-state의 네임스페이스·EventListener ClusterRole/Binding·`blog-ci`
|
|
Application·prod 자동 Sync 허용·`rabbitmaus.com` HTTP-01 solver를 반영합니다.
|
|
service-state의 `ci/blog`, 앱 overlays도 `main`에 반영합니다. 두 저장소 사이의
|
|
적용 순서는 sync-wave만으로 보장되지 않으므로 컨트롤러·네임스페이스·Secret이
|
|
준비된 뒤 첫 push를 보냅니다. 초안은 두 환경 모두 replica 0으로 시작합니다.
|
|
6. 앱 DNS가 Ingress로 연결되도록 설정합니다. `rabbitmaus.com`의 HTTP-01 challenge
|
|
경로는 외부에서 접근 가능해야 합니다. 모든 블로그 Ingress는 SSL redirect를 끕니다.
|
|
7. Gitea `dahyeon/blog`에 JSON push webhook
|
|
`https://tekton-hook.dahyeon.us/blog`를 등록하고 동일한 서명 secret을 사용합니다.
|
|
공유 webhook 호스트의 TLS Secret은 기존 lolympus Ingress가 발급합니다.
|
|
|
|
초안 작성만으로 webhook, Harbor 권한, Secret 값, DNS를 생성하거나 클러스터에 적용하지
|
|
않습니다. DB 마이그레이션·시드와 Entra ID 기능 구현도 실행하지 않습니다.
|
|
|
|
## 검증과 운영
|
|
|
|
```sh
|
|
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 상태까지 확인합니다.
|