비특권 nginx 이미지는 uid 101로 8080을 연다. 지금 운영 매니페스트는 pod 포트 80, probe 80, root를 전제로 한다. deploy/production/frontend-nonroot에 Kustomize component를 둔다. 켜면 frontend Deployment가 containerPort·probe 8080, runAsNonRoot·uid/gid 101, capabilities drop ALL이 되고, Service targetPort가 8080, Traefik → frontend NetworkPolicy 포트가 8080이 된다. Service port는 80 그대로라 Ingress는 바뀌지 않는다. ports 목록은 containerPort로 합쳐져 80이 남으므로 $patch: replace로 바꾼다. 기본 경로에는 넣지 않는다. 지금 운영 이미지 7a4e201은 root로 80을 열어, 켜면 probe가 모두 실패한다. README는 이미지를 비특권 Dockerfile이 들어간 commit에서 다시 만들고, 운영에만 있는 로컬 4커밋도 그 commit에 들어가 있어야 한다고 적는다. 그 이미지로 태그를 바꾸는 같은 커밋에서 켠다. 위험·한계: 운영 frontend의 source(7a4e201)가 Gitea에 없어서, 지금 main에서 이미지를 만들면 운영에만 있는 4커밋이 빠진다. 아직 적용하지 않았다. 검증: component를 켠 렌더에서 pod 포트·probe가 8080, Service targetPort 8080, NetworkPolicy 8080, securityContext가 위와 같다. kubectl apply --dry-run=server는 통과하고, frontend의 PSA restricted 경고가 사라졌다.
8.9 KiB
hyeonworks.com 운영 매니페스트
hyeonworks-prod namespace의 앱 쪽 객체 정본이다(소유자 결정 2026-11-11: 앱 쪽은 tech-log repo
deploy/). 플랫폼 쪽(Namespace, techlog DB Role·Database, 다른 namespace의 NetworkPolicy·Probe·
경보·대시보드)은 platform-core services/tenants/techlog가 맡는다. hyeonworks-secrets Secret은
Git 밖에서 만든다.
| 파일 | 객체 |
|---|---|
backend-*.yaml |
techlog-backend Deployment, Service techlog-backend·techlog-management, ServiceMonitor, ConfigMap techlog-logging |
redis-*.yaml |
세션 저장소 redis Deployment·Service(저장 안 함, 재시작하면 로그인이 풀린다) |
frontend-*.yaml |
techlog-frontend Deployment·Service |
ingress.yaml |
hyeonworks.com 경로: /api·/oauth2·/login·/logout → backend, 나머지 → frontend |
network-policies.yaml |
namespace 안 기본 거부와 허용 여섯 |
이미지와 실행 사용자
| 컨테이너 | 이미지 | pull | 사용자 |
|---|---|---|---|
| backend | git.learn.hyeonworks.com/donghyeon.kang/tech-log-backend:46b1cc7 |
IfNotPresent |
uid 1000(이미지의 app), 권한 전부 버림 |
| frontend | git.learn.hyeonworks.com/donghyeon.kang/tech-log-frontend:7a4e201 |
IfNotPresent |
root(nginx). allowPrivilegeEscalation: false만 |
| redis | redis@sha256:c5d34a98…(지금 운영이 쓰는 redis:7-alpine의 digest) |
IfNotPresent |
uid 999(이미지의 redis), 권한 전부 버림 |
- 예전에는
imagePullPolicy: Never로 노드에 직접 넣은 이미지를 썼다. 2026-11-09 디스크 사고 때 kubelet 이미지 GC가 그 이미지를 지웠고, 다시 받을 곳이 없어 운영이 내려갔다. 이제 Gitea 컨테이너 레지스트리에서 다시 받는다. - 세 파드 모두
priorityClassName: platform-critical(platform-coreservices/priority-classes)이고 seccomp는RuntimeDefault다. - frontend non-root는
frontend-nonroot/component로 둔다(아래). 지금 운영 이미지7a4e201은 root로 80번을 열기 때문에 아직 켜지 않는다.
적용
전제(하나라도 없으면 적용하지 않는다):
- 두 이미지가 Gitea 레지스트리에 있다. 익명 pull이 되는지 노드에서 확인한다.
sudo k3s crictl pull git.learn.hyeonworks.com/donghyeon.kang/tech-log-backend:46b1cc7(frontend도 같다). 미리 받아 두면 backend(Recreate)가 멈추는 시간이 짧아진다. - PriorityClass
platform-critical이 있다:kubectl get priorityclass platform-critical. - Secret
hyeonworks-prod/hyeonworks-secrets가 있다.
curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/
kubectl diff -k deploy/production
kubectl apply -k deploy/production
kubectl -n hyeonworks-prod rollout status deploy/techlog-backend deploy/techlog-frontend deploy/redis
curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/
curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/api/v1/public/home
- backend는
Recreate라 새 파드가 준비될 때까지 API가 멈춘다(1분 안팎). - redis가 다시 시작되면 로그인 세션이 모두 풀린다.
되돌리기: kubectl -n hyeonworks-prod rollout undo deploy/<이름>. 그 뒤 이 폴더를 되돌리는 커밋을 만든다.
backend prod profile (prod-profile/, 아직 켜지 않음)
운영 backend는 SPRING_PROFILES_ACTIVE=local로 돈다. application-local.yml은 외부 인프라 없이 혼자
뜨는 완결형 설정이라, env로 덮지 않은 값이 개발용으로 남는다. prod-profile/은 이것을 prod로 바꾸는
Kustomize component다. 기본 경로(kubectl apply -k deploy/production)에는 들어 있지 않다.
바꾸면 달라지는 것 (이미지 46b1cc7 기준)
| 항목 | 지금(local) |
prod |
|---|---|---|
| 시작 검사 | 꺼짐 | 켜짐: ddl-auto none/validate, Flyway 안전값, 오류 상세·본문 로깅 금지, H2 금지, DB TLS verify-full |
| DB 연결 | TLS 검증 없음(pgJDBC 기본 prefer) |
sslmode=verify-full, CNPG CA로 인증서와 호스트 이름을 검증 |
| 가명화 salt | 개발용 고정값 __LOCAL_DEV_…(보안·감사 로그의 사용자 가명이 예측 가능) |
Secret의 무작위 값. 이전 로그의 가명과 이어지지 않는다 |
| 앱 로그 수준 | dev.caskeleton DEBUG 고정(env APP_LOG_LEVEL_APP가 먹지 않음) |
env APP_LOG_LEVEL_APP(INFO) |
X-Forwarded-* |
none 고정(env가 먹지 않음) |
env APP_SERVER_FORWARD_HEADERS_STRATEGY(framework) |
| JWT issuer | http://localhost:8081/realms/ca-skeleton |
https://id.learn.hyeonworks.com/realms/prod |
| 시작 배너 | 출력 | 끔 |
API 경로(/api), 공개 경로, CORS, Redis 세션, object storage(s3), OIDC client는 그대로다.
application.yml의 API 기본 경로가 /v1이라 PRESENTATION_API_BASE_PATH=/api를 꼭 준다.
backend-prod-env.yaml은 application.yml의 기본값 없는 placeholder 67개 중 Deployment가 아직 주지
않는 값을 담는다. 비밀 값은 담지 않는다.
전제 (모두 있어야 켠다)
-
Secret 키 둘
hyeonworks-prod/hyeonworks-secrets(소유자가 만든다):-
APP_DB_PASSWORD: 이미 있다. -
APP_PRIVACY_PSEUDONYMIZATION_SALT: 새로 만든다. 값은 화면에 남기지 않는다.salt="$(openssl rand -hex 32)" kubectl -n hyeonworks-prod patch secret hyeonworks-secrets --type merge \ -p "{\"stringData\":{\"APP_PRIVACY_PSEUDONYMIZATION_SALT\":\"${salt}\"}}" unset salt
-
-
ConfigMap
hyeonworks-prod/platform-postgres-ca: CNPG CA의 공개 인증서다.kubectl -n platform-data get secret platform-postgres-ca -o jsonpath='{.data.ca\.crt}' | base64 -d \ | kubectl -n hyeonworks-prod create configmap platform-postgres-ca --from-file=ca.crt=/dev/stdinCNPG는 이 CA를 스스로 갱신한다(2026-11-11 기준 만료 2027-01-11). 갱신되면 이 ConfigMap을 같은 명령으로 다시 만들고 backend를 재시작해야 한다. 안 하면 DB 연결이 끊긴다. 오래 가는 CA를 CNPG에 주거나 자동으로 복사하는 방법은 플랫폼 쪽(platform-core) 남은 일이다.
-
위 「적용」의 전제(레지스트리 이미지, PriorityClass)가 갖춰져 있다.
켜기
../kustomization.yaml에 아래를 더하는 커밋을 만들고 적용한다.
components:
- prod-profile
kubectl diff -k deploy/production
kubectl apply -k deploy/production
kubectl -n hyeonworks-prod rollout status deploy/techlog-backend
kubectl -n hyeonworks-prod logs deploy/techlog-backend | grep -m1 'profile is active'
curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/api/v1/public/home
로그에 "prod"가 보이고 마지막 줄이 200이어야 한다. 그 뒤 Studio 로그인을 한 번 해 본다.
되돌리기: kubectl -n hyeonworks-prod rollout undo deploy/techlog-backend. 그다음 components를 빼는
커밋을 만든다. ConfigMap techlog-backend-prod-env는 남아 있어도 해가 없다.
frontend non-root (frontend-nonroot/, 아직 켜지 않음)
이 repo의 Dockerfile은 runtime을 nginxinc/nginx-unprivileged:1.27.5-alpine(예전 base와 같은 NGINX 판·Alpine)으로
만든다. master가 uid 101로 돌고 8080을 연다(scripts/generate-nginx-config.ts). frontend-nonroot/
component는 그 이미지에 맞춰 다음을 바꾼다.
| 객체 | 바뀌는 것 |
|---|---|
Deployment techlog-frontend |
containerPort 8080, liveness·readiness probe 8080, runAsNonRoot·uid/gid 101, drop: [ALL] |
Service techlog-frontend |
targetPort 80 → 8080(port는 80 그대로라 Ingress는 안 바뀐다) |
NetworkPolicy techlog-frontend-ingress |
Traefik → pod 포트 80 → 8080 |
켜는 순서
-
이 Dockerfile이 들어간 commit에서 frontend 이미지를 만든다. 운영
7a4e201에만 있는 커밋(로컬 브랜치chore/template-sync-v0.2.0, main보다 4개 앞)이 그 commit에 들어 있어야 한다. 빠지면 그 4개(다크 모드 글씨, 2KB 넘는 본문 저장, 제목 문구, 템플릿 동기화)가 운영에서 되돌아간다. -
그 이미지를 레지스트리에 push한다(위 「적용」의 전제 1과 같은 방법).
-
한 커밋에서
frontend-deployment.yaml의 이미지 태그를 새 태그로 바꾸고,kustomization.yaml에components: [frontend-nonroot]를 더한다(prod-profile이 켜져 있으면 목록에 같이 둔다). -
적용과 확인:
kubectl diff -k deploy/production kubectl apply -k deploy/production kubectl -n hyeonworks-prod rollout status deploy/techlog-frontend curl -s -o /dev/null -w '%{http_code}\n' https://hyeonworks.com/config.json
되돌리기: kubectl -n hyeonworks-prod rollout undo deploy/techlog-frontend. 그다음 3의 커밋을 되돌리는
커밋을 만들고 다시 적용한다(Service와 NetworkPolicy 포트도 80으로 돌아가야 한다).