diff --git a/README.md b/README.md index 0a18d2e..6722fb4 100644 --- a/README.md +++ b/README.md @@ -43,7 +43,8 @@ NetworkPolicy가 동작 중입니다. ObjectStore는 `Initialized/green`, PVC는 | --- | --- | --- | | CloudNativePG | Operator `1.30.0`, Chart `0.29.0` | Phase 1 적용, Ready/Available `1/1` | | PostgreSQL | `17.9-standard-trixie` | Phase 1 적용, healthy `1/1`, PVC Bound | -| Gitea | 애플리케이션 `1.27.0`, Chart `12.7.0` | OIDC·브랜딩 rollout 완료; OAuth source·정책·redirect·자산 자동 검증 통과 | +| Gitea | 애플리케이션 `1.27.0`, Chart `12.7.0` | OIDC·브랜딩 rollout 완료; OAuth source·정책·redirect·자산 자동 검증 통과; Actions·Package Registry 켬(2026-11-07) | +| Gitea Runner | `5.4.1-dind`, desktop 호스트 Docker | `donghyeon.kang` 범위 등록, online; [운영 문서](infrastructure/ci/gitea-runner/README.md) | | Keycloak | Operator·애플리케이션 `26.7.0` | Ready `1/1`; realm·client·OIDC Secret·Host Nginx 공개 전환 완료 | | Traefik | Chart `40.1.3+up40.1.0`, 이미지 `3.7.4` | NodePort `30080/30443`, `web` trust `10.42.0.1/32` 적용 | | AIStor Operator | Chart `5.10.0` | 적용, Operator·AdminJob·Webhook Ready `1/1` | diff --git a/services/gitea/README.md b/services/gitea/README.md index 21111a3..498de5f 100644 --- a/services/gitea/README.md +++ b/services/gitea/README.md @@ -18,6 +18,12 @@ rollout을 완료했다. 적용 manifest SHA-256은 `d25a757...a157`이며, 활 login/callback/logout, 비상 관리자 실제 로그인과 Pod 재시작 뒤 설정 지속성은 별도 수용 시험으로 남아 있다. +상태(2026-11-07): Actions와 Package Registry를 켠 values(커밋 `87dee1f`)를 같은 +진입점 `apply-gitea-oidc.sh --execute`로 적용했다. 적용 manifest SHA-256은 +`f082cba5ca22b97ed5a463414404b852a4cfd452a0dd40c6e3b4b5f3afd4abbc`이고 스크립트의 +rollout·OAuth2 source·로그인 흐름·브랜딩 검사를 모두 통과했다. 적용 전후 health, +웹, Git HTTPS, OIDC discovery, 사용자 repository 24개와 PR이 같았다. + ## 고정된 업스트림 릴리스 | 항목 | 값 | @@ -71,14 +77,76 @@ SHA 검증 캐시 하나를 각자의 `chartHome`으로 참조한다. values와 loopback에 의존하지 않도록 Pod의 `hostAliases`는 이 이름만 노드 `192.168.0.107`로 해석하고, 전용 NetworkPolicy가 해당 `/32`의 TCP 443만 허용한다. 연결은 Host Nginx TLS와 Traefik을 그대로 통과한다. -- 첫 배포에서는 Gitea SSH, Actions, Git LFS 및 Package Registry를 비활성화한다. - Chart `12.7.0`은 항상 SSH Service를 렌더링하므로 baseline 루트는 inline patch, - OIDC profile은 `patches/delete-ssh-service.yaml`로 Helm 렌더링 뒤 - `gitea-ssh`를 삭제한다. +- Gitea SSH와 Git LFS는 비활성화한다. Chart `12.7.0`은 항상 SSH Service를 + 렌더링하므로 baseline 루트는 inline patch, OIDC profile은 + `patches/delete-ssh-service.yaml`로 Helm 렌더링 뒤 `gitea-ssh`를 삭제한다. +- Actions와 Package Registry는 첫 배포에서 껐다가 2026-11-07 소유자 결정으로 + 서버에서 켰다(`[actions] ENABLED=true`, `[packages] ENABLED=true`, + `DISABLED_REPO_UNITS=""`). 꺼져 있을 때 만든 repository에는 두 unit이 없으므로 + 기존 repository는 모두 `has_actions=false`, `has_packages=false`로 남고, 소유자가 + repository 설정에서 켜야 workflow가 돌거나 repository에 패키지 탭이 생긴다. + 새로 만드는 repository는 Gitea 기본값(`DEFAULT_REPO_UNITS`)에 따라 두 unit이 + 켜진 채 만들어진다. 아래 「Actions와 Package Registry」를 따른다. - 공통 egress는 클러스터 DNS, 플랫폼 PostgreSQL Pod 및 공개 IPv4 HTTPS 대상으로 제한한다. OIDC profile만 Host Nginx 노드 `/32`의 TCP 443을 추가한다. 내부 HTTPS, SMTP, SSH remote 및 사설 네트워크 webhook을 사용하려면 향후 - NetworkPolicy를 명시적으로 변경해야 한다. + NetworkPolicy를 명시적으로 변경해야 한다. Actions runner와 Maven 클라이언트는 + 기존 Host Nginx → Traefik HTTPS 경로로 Gitea에 들어오기만 하므로 egress는 + 바꾸지 않는다. + +## Actions와 Package Registry + +### Actions + +runner는 Gitea Pod가 아니라 desktop 호스트의 Docker 컨테이너다. 이미지, 설정, +등록과 되돌리기는 [Gitea Actions runner](../../infrastructure/ci/gitea-runner/README.md)에 +있다. 서버 쪽 설정은 Gitea 기본값을 쓴다. job log와 artifact는 `/data` 아래 +(`actions_log`, `actions_artifacts`)에 저장되고 log는 365일, artifact는 90일 보관한다. + +### 저장 위치와 용량 + +| 항목 | 값 | +| --- | --- | +| 패키지 blob | `APP_DATA_PATH`(`/data`) 아래 `/data/packages` | +| chunked upload 임시 위치 | `/data/tmp/package-upload` | +| 호스트 경로 | `gitea-local-pv`의 `/srv/k3s/ssd/gitea` (root SSD) | +| PVC 요청 | `50Gi` | + +Local PV는 PVC 크기를 강제하지 않는다. 실제 상한은 root SSD의 남은 공간이고, 이 +공간을 desktop 호스트, Actions runner의 Docker 볼륨과 함께 쓴다(2026-11-07 기준 +228G 중 여유 33G, Gitea `/data` 사용량 약 267M). 소유자별 상한 +(`LIMIT_TOTAL_OWNER_SIZE`)과 형식별 상한(`LIMIT_SIZE_MAVEN`)은 Gitea 기본값인 +무제한(`-1`)이다. Host Nginx의 `git.learn.hyeonworks.com` 요청 본문 상한은 +`512m`이라 이보다 큰 파일은 올라가지 않는다. + +### 정리 + +- 같은 파일은 blob 하나로 저장된다. 패키지를 지우면 참조만 지워지고, 참조가 없는 + blob은 cron `cleanup_packages`(기본: 매일 자정, `OLDER_THAN=24h`)가 지운다. +- 오래된 버전은 패키지 소유자(사용자·조직)가 설정 → Packages → Cleanup rules에서 + 지운다. Maven SNAPSHOT은 형식 `maven`, 「Remove versions matching」에 + `.+-SNAPSHOT`, 「Keep the most recent」에 남길 개수를 두는 규칙을 권한다. 규칙을 + 켜기 전에 preview로 지워질 버전을 확인한다. 2026-11-07 현재 규칙은 없다. +- 같은 이름·버전의 Maven 패키지는 다시 올릴 수 없다. 먼저 그 버전을 지워야 한다. + +### Maven 배포와 조회 권한 + +- 저장소 URL: `https://git.learn.hyeonworks.com/api/packages/{owner}/maven` +- 조회: 사용자 소유 패키지는 그 사용자가 public이면 공개이고, 아니면 그 사용자만 + 읽는다. `donghyeon.kang`은 public이고 `REQUIRE_SIGNIN_VIEW`를 켜지 않았으므로 + 이 사용자의 패키지는 인증 없이 받을 수 있다. 조직 패키지는 조직이 public이면 + 공개, 아니면 조직 member만 읽는다. +- 배포: 사용자 패키지는 소유자만, 조직 패키지는 packages 쓰기 권한이 있는 team + member만 올린다. Maven·Gradle은 personal access token을 `Authorization: token + ` header로 보낸다. token 권한은 package `Read & Write`(`write:package`)가 + 필요하고, 비공개 패키지를 받기만 할 때는 `Read`(`read:package`)면 된다. +- Actions job 안에서 배포할 때는 token을 repository나 사용자 Actions secret으로 + 넘긴다. workflow 파일과 log에 token을 쓰지 않는다. + +출처: [Package Registry](https://docs.gitea.com/1.27/usage/packages/overview), +[Maven](https://docs.gitea.com/1.27/usage/packages/maven), +[Storage](https://docs.gitea.com/1.27/usage/packages/storage), +[Config cheat sheet](https://docs.gitea.com/1.27/administration/config-cheat-sheet). ## 선언형 브랜딩