feat(deploy): 운영 매니페스트를 repo에 두고 이미지를 레지스트리에서 받는다 #1

Merged
donghyeon.kang merged 2 commits from feat/production-manifests into main 2026-11-11 22:44:18 +00:00
Owner

무엇을, 왜

hyeonworks-prod의 앱 객체는 kubectl apply로만 들어가 있었고, 어느 repo에도 정본이 없었다. backend·frontend는 imagePullPolicy: Never로 노드에 직접 넣은 이미지를 썼다. 2026-11-09 디스크 사고 때 kubelet 이미지 GC가 그 이미지를 지웠고, 다시 받을 곳이 없어 운영이 내려갔다.

소유자 결정(2026-11-11: 앱 쪽 정본은 tech-log repo deploy/)대로 deploy/production/에 두 단계로 넣는다.

  1. 23e230e3: live 객체 16개를 그대로 기록한다. live와 차이 0줄.
  2. 9782c831: 이미지를 Gitea 레지스트리와 IfNotPresent로 바꾼다. redis는 digest로 고정한다. 세 파드에 platform-critical과 seccomp RuntimeDefault를 넣는다. backend(uid 1000)와 redis(uid 999)는 non-root에 권한을 모두 버린다(drop ALL). frontend는 allowPrivilegeEscalation: false만 둔다.

고른 방법과 버린 대안

  • 위치: 이 repo의 deploy/에는 이미 tech-log 시스템 전체의 배포물(keycloak realm)이 있다. backend 객체도 여기에 둔다.
  • frontend에 drop ALL과 non-root를 두는 안은 버렸다. nginx 공식 이미지는 root로 80번을 열고 사용자를 바꾸기 때문에 뜨지 못한다. 비특권 nginx 이미지로 바꾼 뒤에 한다.
  • Namespace와 platform 쪽 객체는 넣지 않는다. platform-core services/tenants/techlog가 맡는다.

위험과 영향

  • 두 이미지가 레지스트리에 올라가기 전에 적용하면 ErrImagePull이 난다. 레지스트리 push는 소유자 단계다(공유 노트 w1-infra-hardening.md C).
  • backend는 Recreate라 1분 안팎 멈춘다. redis가 재시작되면 로그인 세션이 풀린다.
  • 아직 적용하지 않았다.
  • 이미지 source commit(7a4e201, 46b1cc7)은 Gitea에 없다.
  • 운영 backend가 SPRING_PROFILES_ACTIVE=local로 돈다. 이번에는 바꾸지 않았다.

검증

  • kubectl diff(desktop live): 1단계는 16개 객체 모두 차이 0줄. 2단계는 이미지·pull·priorityClassName·securityContext만 바뀐다.
  • kubectl apply --dry-run=server 통과. frontend에 PSA restricted 경고(non-root, drop ALL)만 나온다.
  • desktop Docker에서 같은 조건으로 띄워 봤다.
    • redis: uid 999, cap-drop ALL, no-new-privileges에서 PONG.
    • backend: uid 1000, cap-drop ALL에서 Tomcat과 DB 연결 시도까지 권한 오류가 없다.
    • frontend: no-new-privileges에서 /config.json 200.
  • 이 repo의 pnpm 게이트는 돌리지 않았다(YAML과 README만 바뀜).

리뷰어가 볼 곳

  • deploy/production/README.md(적용 전제와 순서)
  • 세 Deployment의 securityContext

관련

  • k3s 성숙도 점검 보고서(platform-core docs/reviews/2026-11-11-k3s-maturity-review.md) 7.2·7.5절
## 무엇을, 왜 `hyeonworks-prod`의 앱 객체는 `kubectl apply`로만 들어가 있었고, 어느 repo에도 정본이 없었다. backend·frontend는 `imagePullPolicy: Never`로 노드에 직접 넣은 이미지를 썼다. 2026-11-09 디스크 사고 때 kubelet 이미지 GC가 그 이미지를 지웠고, 다시 받을 곳이 없어 운영이 내려갔다. 소유자 결정(2026-11-11: 앱 쪽 정본은 tech-log repo `deploy/`)대로 `deploy/production/`에 두 단계로 넣는다. 1. `23e230e3`: live 객체 16개를 그대로 기록한다. live와 차이 0줄. 2. `9782c831`: 이미지를 Gitea 레지스트리와 `IfNotPresent`로 바꾼다. redis는 digest로 고정한다. 세 파드에 `platform-critical`과 seccomp `RuntimeDefault`를 넣는다. backend(uid 1000)와 redis(uid 999)는 non-root에 권한을 모두 버린다(drop ALL). frontend는 `allowPrivilegeEscalation: false`만 둔다. ## 고른 방법과 버린 대안 - 위치: 이 repo의 `deploy/`에는 이미 tech-log 시스템 전체의 배포물(keycloak realm)이 있다. backend 객체도 여기에 둔다. - frontend에 drop ALL과 non-root를 두는 안은 버렸다. nginx 공식 이미지는 root로 80번을 열고 사용자를 바꾸기 때문에 뜨지 못한다. 비특권 nginx 이미지로 바꾼 뒤에 한다. - Namespace와 platform 쪽 객체는 넣지 않는다. platform-core `services/tenants/techlog`가 맡는다. ## 위험과 영향 - **두 이미지가 레지스트리에 올라가기 전에 적용하면 ErrImagePull이 난다.** 레지스트리 push는 소유자 단계다(공유 노트 `w1-infra-hardening.md` C). - backend는 `Recreate`라 1분 안팎 멈춘다. redis가 재시작되면 로그인 세션이 풀린다. - 아직 적용하지 않았다. - 이미지 source commit(`7a4e201`, `46b1cc7`)은 Gitea에 없다. - 운영 backend가 `SPRING_PROFILES_ACTIVE=local`로 돈다. 이번에는 바꾸지 않았다. ## 검증 - `kubectl diff`(desktop live): 1단계는 16개 객체 모두 차이 0줄. 2단계는 이미지·pull·priorityClassName·securityContext만 바뀐다. - `kubectl apply --dry-run=server` 통과. frontend에 PSA `restricted` 경고(non-root, drop ALL)만 나온다. - desktop Docker에서 같은 조건으로 띄워 봤다. - redis: uid 999, cap-drop ALL, no-new-privileges에서 `PONG`. - backend: uid 1000, cap-drop ALL에서 Tomcat과 DB 연결 시도까지 권한 오류가 없다. - frontend: no-new-privileges에서 `/config.json` 200. - 이 repo의 pnpm 게이트는 돌리지 않았다(YAML과 README만 바뀜). ## 리뷰어가 볼 곳 - `deploy/production/README.md`(적용 전제와 순서) - 세 Deployment의 `securityContext` ## 관련 - k3s 성숙도 점검 보고서(platform-core `docs/reviews/2026-11-11-k3s-maturity-review.md`) 7.2·7.5절
donghyeon.kang added 2 commits 2026-11-11 22:43:34 +00:00
hyeonworks-prod의 앱 객체는 kubectl apply로만 들어가 있고 어느 repo에도
정본이 없다. 그래서 무엇이 운영에 떠 있는지 Git으로 볼 수 없고, 이미지나
설정을 바꿀 때 기준이 되는 파일도 없다.

live 객체 16개를 deploy/production에 그대로 옮긴다. backend·frontend·redis
Deployment, Service 넷, ServiceMonitor, logging ConfigMap, Ingress,
NetworkPolicy 여섯이다. 각 객체의 last-applied 설정을 쓰고, 서버가 채우는
칸(uid, resourceVersion, status, clusterIP 등)은 뺐다. 정본 위치는 소유자
결정(2026-11-11, 「앱 쪽은 tech-log repo deploy/」)을 따른다.
Namespace, techlog DB Role·Database, 다른 namespace의 NetworkPolicy·Probe·
규칙은 platform-core services/tenants/techlog가 맡는다.
hyeonworks-secrets Secret은 Git에 두지 않는다.

위험·한계: 동작은 바뀌지 않는다. 운영 source commit(frontend 7a4e201,
backend 46b1cc7)은 아직 Gitea에 없어서, 이 파일들이 가리키는 이미지를 이
repo의 main에서 다시 만들 수는 없다.

검증: kubectl kustomize deploy/production을 live 클러스터에 대고
kubectl diff를 돌렸다. 16개 객체 모두 차이가 0줄이다. 값을 하나씩 보고
비밀 값은 secretKeyRef 참조뿐인 것을 확인했다.
운영 backend·frontend는 imagePullPolicy: Never로 노드에 직접 넣은 이미지를
쓴다. 2026-11-09 디스크 사고 때 kubelet 이미지 GC가 그 이미지를 지웠고,
다시 받을 곳이 없어 hyeonworks.com이 내려갔다. redis는 움직이는 태그
redis:7-alpine이다. 세 파드 모두 우선순위가 0이고 securityContext가
비어 있다(k3s 성숙도 점검 2026-11-11, 7.2·7.5절).

- backend·frontend 이미지를 git.learn.hyeonworks.com/donghyeon.kang/
  tech-log-{backend:46b1cc7,frontend:7a4e201}로, pull을 IfNotPresent로
  바꾼다. 태그는 지금 운영과 같다.
- redis를 지금 운영이 쓰는 이미지의 digest로 고정한다.
- 세 파드에 priorityClassName platform-critical과 seccomp
  RuntimeDefault를 둔다.
- backend는 uid 1000, redis는 uid 999로 runAsNonRoot이고 권한을 모두
  버리며 allowPrivilegeEscalation: false다.
- frontend는 allowPrivilegeEscalation: false만 둔다. nginx 공식 이미지는
  root로 80번을 열고 worker를 내리므로, non-root와 drop ALL은 이미지를
  비특권 nginx로 바꾼 뒤에 한다(README에 남은 일로 적음).

버린 대안: frontend에도 drop ALL을 두는 것. nginx가 80번을 열고 사용자를
바꾸는 데 필요한 권한까지 빠져 뜨지 못한다.

위험·한계: 두 이미지가 레지스트리에 올라가기 전에 적용하면 파드가
ErrImagePull로 멈춘다. README가 적용 전 확인을 요구한다. backend는
Recreate라 1분 안팎 멈추고, redis 재시작으로 로그인 세션이 풀린다.
아직 적용하지 않았다.

검증: kubectl diff는 위 칸들만 바뀐다고 보여 준다. kubectl apply
--dry-run=server는 통과하고, frontend에 PSA restricted 경고(non-root,
drop ALL)만 낸다. desktop Docker에서 같은 조건으로 띄워 봤다. redis는
uid 999·cap-drop ALL·no-new-privileges로 PONG을 돌려준다. backend는
uid 1000으로 Tomcat과 DB 연결 시도까지 권한 오류 없이 뜬다. frontend는
no-new-privileges와 기본 seccomp에서 /config.json 200이다. 이 repo의
pnpm 게이트는 돌리지 않았다(YAML과 README만 바뀜).
donghyeon.kang merged commit f124361646 into main 2026-11-11 22:44:18 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/tech-log-frontend#1