4 Commits
Author SHA1 Message Date
DongHyeonka 8c93cb05bc feat(deploy): frontend를 non-root로 돌리는 component를 둔다
비특권 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 경고가 사라졌다.
2026-11-12 08:22:14 +09:00
DongHyeonka 64d5eb9e8c feat(deploy): backend를 prod profile로 바꾸는 component를 둔다
운영 backend는 SPRING_PROFILES_ACTIVE=local로 돈다. application-local.yml은
외부 인프라 없이 혼자 뜨도록 값을 스스로 정하는 완결형 설정이라, env로
덮지 않은 값이 개발용으로 남는다. 가명화 salt가 개발용 고정값이고,
dev.caskeleton 로그가 DEBUG로 고정이고, forward-headers가 none이고,
JWT issuer가 localhost다. prod 시작 검사(스키마·Flyway 안전값, 오류
상세 금지, DB TLS verify-full, H2 금지)도 꺼져 있다.

deploy/production/prod-profile에 Kustomize component를 둔다. 기본 경로에는
넣지 않는다. 켜면 SPRING_PROFILES_ACTIVE=prod, application.yml의 기본값
없는 placeholder 중 빠진 값(ConfigMap techlog-backend-prod-env), DB URL
sslmode=verify-full과 CNPG CA 마운트, Secret에서 오는 비밀번호·salt가
들어간다. PRESENTATION_API_BASE_PATH=/api를 꼭 준다. application.yml의
기본값이 /v1이라, 빠지면 모든 /api 경로가 사라진다.

버린 대안: local에 env를 더 얹어 증상만 고치기. prod 검사가 계속 꺼져
있고, local.yml이 직접 정한 값(로그 수준, forward-headers)은 env로 덮이지
않는다. 기본 경로에서 바로 prod로 바꾸기도 버렸다. 새 Secret 키와 CA
ConfigMap이 없을 때 적용되면 backend가 뜨지 못한다.

위험·한계: CNPG는 CA를 스스로 갱신한다(지금 만료 2027-01-11). 복사한
CA ConfigMap을 갱신 때 다시 만들지 않으면 DB 연결이 끊긴다. salt를 바꾸면
이전 로그의 가명과 이어지지 않는다. 아직 적용하지 않았다.

검증: component를 켠 렌더가 kubectl apply --dry-run=server를 통과한다.
desktop Docker에서 운영 이미지 46b1cc7을 이 env로 띄웠다(uid 1000,
cap-drop ALL, 비밀 값은 가짜). profile prod로 property 결합과 prod 시작
검사를 모두 지났다. 운영 DB에 TLS verify-full로 붙어 CA와 호스트 이름
검증을 통과한 뒤, Flyway 단계에서 "password authentication failed"로
멈췄다(가짜 비밀번호라 예상한 결과). Redis·S3·OIDC 경로는 실제 비밀 값
없이는 시험할 수 없어 하지 않았다.
2026-11-12 07:51:49 +09:00
DongHyeonka 9782c831fb feat(deploy): 운영 이미지를 Gitea 레지스트리에서 받고 권한을 줄인다
운영 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만 바뀜).
2026-11-12 07:35:44 +09:00
DongHyeonka 23e230e368 chore(deploy): 운영 hyeonworks.com 매니페스트를 지금 상태 그대로 기록한다
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 참조뿐인 것을 확인했다.
2026-11-12 07:33:12 +09:00