docs(gitea): record the Actions and package registry rollout

The Gitea README still said Actions and the package registry are
disabled on first deployment, and had no guidance for either.

Replace that decision with the 2026-11-07 state, add where packages
are stored and how much space they really have (a local PV does not
enforce the 50Gi request), the cleanup rules to use for Maven
SNAPSHOTs, and who may publish and read Maven packages. Record the
applied manifest SHA-256 and link the runner guide from the root
README.

Verification: statements checked against the Gitea 1.27 docs and
source (routers/api/packages/maven, modules/web/router.go), the live
app.ini, and API responses after the rollout.
This commit is contained in:
DongHyeonka
2026-11-07 18:36:55 +09:00
parent 69c3a732d5
commit a92e6b854b
2 changed files with 75 additions and 6 deletions
+2 -1
View File
@@ -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` |
+73 -5
View File
@@ -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
<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).
## 선언형 브랜딩