feat(deploy): 운영 frontend를 비특권 nginx로 돌릴 수 있게 한다(opt-in) #5

Merged
donghyeon.kang merged 4 commits from feat/frontend-nonroot into main 2026-11-12 02:02:05 +00:00
Owner

제목: feat(runtime): frontend를 비특권 nginx로 8080에서 non-root로 돌린다
브랜치: tech-log-frontend feat/frontend-nonroot, head ab3ad938(main 3b4c13e2를 merge로 받음). feat/backend-prod-profile 위에 쌓았다(README 충돌을 피하려고). prod-profile PR을 먼저 병합하거나, 이 PR 하나로 둘 다 병합한다.

무엇을, 왜

frontend 이미지는 nginx 공식 이미지라 root로 80번을 연다. Kubernetes에서 runAsNonRoot와 drop ALL을 둘 수 없고 PSA restricted 경고가 난다(k3s 성숙도 점검 7.5절).

  • dd10e273: runtime base를 nginxinc/nginx-unprivileged:1.27.5-alpine(digest 고정)으로 바꾼다. 예전 base와 같은 NGINX 1.27.5·Alpine이다. 생성 conf listen 8080, USER 101, EXPOSE·HEALTHCHECK 8080, dev-stack 포트 매핑 8080.
  • 8c93cb05: deploy/production/frontend-nonroot/ component(기본 경로에 없음). pod 포트·probe 8080, runAsNonRoot·uid/gid 101, drop ALL, Service targetPort 8080(port 80 유지), Traefik→frontend NetworkPolicy 8080.

고른 방법과 버린 대안

  • 버린 대안: Debian판 nginx-unprivileged. wget이 없어 HEALTHCHECK가 늘 실패한다.
  • 버린 대안: 80번에 NET_BIND_SERVICE만 남기기. drop ALL과 PSA restricted를 못 지킨다.
  • Service port를 80으로 두어 Ingress와 내부 호출은 바뀌지 않는다.

위험과 영향

  • 지금 운영 이미지 7a4e201로는 켜면 안 된다. 그 이미지는 root로 80을 열어 probe가 모두 실패한다.
  • 새 이미지는 이 Dockerfile이 들어간 commit에서 만든다. 그 commit에는 운영에만 있는 로컬 4커밋(chore/template-sync-v0.2.0, 다크 모드 글씨·2KB 본문 저장·제목 문구·템플릿 동기화)도 있어야 한다. 빠지면 그 4개가 운영에서 되돌아간다.
  • 이미지 태그를 바꾸는 같은 커밋에서 component를 켠다(README 순서).
  • dev-stack compose의 443·/etc/nginx/tls는 이미지에 없는 파일을 쓰는 예전 상태 그대로다.

검증

  • desktop에서 이 Dockerfile의 runtime 단계를 그대로 쓰고, 빌드 단계만 운영 이미지 7a4e201의 dist와 conf(listen 8080으로 바꿈)로 대신해 이미지를 만들었다.
    • --user 101 --cap-drop ALL --security-opt no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024로 띄웠다.
    • 결과: GET /config.json 200, GET / 200, CapEff 0, NoNewPrivs 1, Docker health healthy.
  • component를 켠 렌더(prod-profile과 함께 켜도): 포트·probe·securityContext가 위와 같고, kubectl apply --dry-run=server에 경고·오류가 0건이다. frontend PSA restricted 경고가 사라졌다.
  • 돌리지 않은 것: 전체 docker build(pnpm 빌드 포함). heavy lock 대기가 길어 취소했다. 이 repo의 pnpm 게이트도 돌리지 않았다.

새 main(3b4c13e2) 위 재검증 (2026-11-12, desktop 호스트 node 24.14.0, heavy lock)

ref 001 lockfile 002 lint 003 typecheck 005 unit 011 build
main 3b4c13e2 0 0 1 1 0
#4 be0e9e9c 0 0 1 1 0
#5 ab3ad938 0 0 1 1 0
  • 003·005 실패는 세 ref 모두 같다: route-runtime 음성 fixture UNEXPECTED_DIAGNOSTIC, unit build-environment-bundle·second-api-feature-registries(#3이 들여온 시험). 이 PR이 새로 만든 실패는 없다.
  • #5 docker build(pnpm 빌드 포함) rc=0 56s. 이미지 user 101, expose 8080. --user 101 --cap-drop ALL --security-opt no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024로 띄우면 /config.json 200, / 200, release-manifest commitSha ab3ad938…, CapEff 0, NoNewPrivs 1, health healthy.
  • 두 component를 켠 렌더 rc=0, kubectl apply --dry-run=server rc=0, 경고 0.
  • 로그: desktop /tmp/claude-gates/w1-infra/pr45/.
제목: feat(runtime): frontend를 비특권 nginx로 8080에서 non-root로 돌린다 브랜치: tech-log-frontend `feat/frontend-nonroot`, head `ab3ad938`(main `3b4c13e2`를 merge로 받음). `feat/backend-prod-profile` 위에 쌓았다(README 충돌을 피하려고). prod-profile PR을 먼저 병합하거나, 이 PR 하나로 둘 다 병합한다. ## 무엇을, 왜 frontend 이미지는 nginx 공식 이미지라 root로 80번을 연다. Kubernetes에서 runAsNonRoot와 drop ALL을 둘 수 없고 PSA restricted 경고가 난다(k3s 성숙도 점검 7.5절). - `dd10e273`: runtime base를 `nginxinc/nginx-unprivileged:1.27.5-alpine`(digest 고정)으로 바꾼다. 예전 base와 같은 NGINX 1.27.5·Alpine이다. 생성 conf `listen 8080`, `USER 101`, EXPOSE·HEALTHCHECK 8080, dev-stack 포트 매핑 8080. - `8c93cb05`: `deploy/production/frontend-nonroot/` component(기본 경로에 없음). pod 포트·probe 8080, runAsNonRoot·uid/gid 101, drop ALL, Service targetPort 8080(port 80 유지), Traefik→frontend NetworkPolicy 8080. ## 고른 방법과 버린 대안 - 버린 대안: Debian판 nginx-unprivileged. wget이 없어 HEALTHCHECK가 늘 실패한다. - 버린 대안: 80번에 NET_BIND_SERVICE만 남기기. drop ALL과 PSA restricted를 못 지킨다. - Service port를 80으로 두어 Ingress와 내부 호출은 바뀌지 않는다. ## 위험과 영향 - **지금 운영 이미지 `7a4e201`로는 켜면 안 된다.** 그 이미지는 root로 80을 열어 probe가 모두 실패한다. - 새 이미지는 이 Dockerfile이 들어간 commit에서 만든다. 그 commit에는 운영에만 있는 로컬 4커밋(`chore/template-sync-v0.2.0`, 다크 모드 글씨·2KB 본문 저장·제목 문구·템플릿 동기화)도 있어야 한다. 빠지면 그 4개가 운영에서 되돌아간다. - 이미지 태그를 바꾸는 같은 커밋에서 component를 켠다(README 순서). - dev-stack compose의 443·`/etc/nginx/tls`는 이미지에 없는 파일을 쓰는 예전 상태 그대로다. ## 검증 - desktop에서 이 Dockerfile의 runtime 단계를 그대로 쓰고, 빌드 단계만 운영 이미지 `7a4e201`의 dist와 conf(listen 8080으로 바꿈)로 대신해 이미지를 만들었다. - `--user 101 --cap-drop ALL --security-opt no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024`로 띄웠다. - 결과: `GET /config.json` 200, `GET /` 200, `CapEff 0`, `NoNewPrivs 1`, Docker health `healthy`. - component를 켠 렌더(prod-profile과 함께 켜도): 포트·probe·securityContext가 위와 같고, `kubectl apply --dry-run=server`에 경고·오류가 0건이다. frontend PSA restricted 경고가 사라졌다. - **돌리지 않은 것:** 전체 `docker build`(pnpm 빌드 포함). heavy lock 대기가 길어 취소했다. 이 repo의 pnpm 게이트도 돌리지 않았다. ## 새 main(3b4c13e2) 위 재검증 (2026-11-12, desktop 호스트 node 24.14.0, heavy lock) | ref | 001 lockfile | 002 lint | 003 typecheck | 005 unit | 011 build | | --- | --- | --- | --- | --- | --- | | main `3b4c13e2` | 0 | 0 | 1 | 1 | 0 | | #4 `be0e9e9c` | 0 | 0 | 1 | 1 | 0 | | #5 `ab3ad938` | 0 | 0 | 1 | 1 | 0 | - 003·005 실패는 세 ref 모두 같다: route-runtime 음성 fixture `UNEXPECTED_DIAGNOSTIC`, unit `build-environment-bundle`·`second-api-feature-registries`(#3이 들여온 시험). 이 PR이 새로 만든 실패는 없다. - #5 docker build(pnpm 빌드 포함) rc=0 56s. 이미지 user 101, expose 8080. `--user 101 --cap-drop ALL --security-opt no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024`로 띄우면 `/config.json` 200, `/` 200, release-manifest commitSha `ab3ad938…`, CapEff 0, NoNewPrivs 1, health healthy. - 두 component를 켠 렌더 rc=0, `kubectl apply --dry-run=server` rc=0, 경고 0. - 로그: desktop `/tmp/claude-gates/w1-infra/pr45/`.
donghyeon.kang added 3 commits 2026-11-11 23:29:33 +00:00
운영 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 경로는 실제 비밀 값
없이는 시험할 수 없어 하지 않았다.
frontend 이미지는 nginx 공식 이미지라 root로 시작해 80번을 열고 worker를
nginx 사용자로 내린다. 그래서 Kubernetes에서 runAsNonRoot와 drop ALL을 둘
수 없다(k3s 성숙도 점검 2026-11-11, 7.5절). 운영 매니페스트는
allowPrivilegeEscalation: false만 두고 PSA restricted 경고를 낸다.

runtime base를 nginxinc/nginx-unprivileged:1.27.5-alpine(digest 고정)으로
바꾼다. 예전 base와 같은 NGINX 1.27.5·Alpine이고 wget도 있어 HEALTHCHECK가
그대로 돈다. 파일을 고치는 동안만 root로 있다가 USER 101로 돌아간다.
생성되는 server 블록은 listen 8080이고, EXPOSE·HEALTHCHECK·dev-stack 포트
매핑도 8080으로 맞춘다.

버린 대안: Debian판 nginx-unprivileged. wget이 없어 HEALTHCHECK가 늘
실패한다. 80번을 그대로 두고 NET_BIND_SERVICE만 남기는 안도 버렸다.
drop ALL을 못 하고 PSA restricted도 통과하지 못한다.

위험·한계: 이 이미지는 8080을 열므로 운영 매니페스트의 포트를 같이
바꿔야 한다. deploy/production/frontend-nonroot가 그 일을 하고, 기본
경로에는 넣지 않는다. dev-stack의 443·/etc/nginx/tls 부분은 이미지에 없는
파일을 쓰는 예전 상태 그대로다. 이 repo의 pnpm 게이트와 전체 docker
build는 돌리지 않았다(heavy lock 대기가 길어 취소).

검증: desktop에서 이 Dockerfile의 runtime 단계를 그대로 쓰고, 빌드
단계만 운영 이미지 7a4e201의 dist와 conf(listen 8080으로 바꿈)로 대신해
이미지를 만들었다. --user 101 --cap-drop ALL --security-opt
no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024로
띄우면 GET /config.json 200, GET / 200, CapEff 0, NoNewPrivs 1이고,
Docker health는 healthy다.
비특권 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 경고가 사라졌다.
donghyeon.kang added 1 commit 2026-11-12 01:14:44 +00:00
donghyeon.kang added 1 commit 2026-11-12 02:01:51 +00:00
donghyeon.kang merged commit 27e342dd40 into main 2026-11-12 02:02:05 +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#5