제목: 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)
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.
제목: 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/`.
운영 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 경고가 사라졌다.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
제목: feat(runtime): frontend를 비특권 nginx로 8080에서 non-root로 돌린다
브랜치: tech-log-frontend
feat/frontend-nonroot, headab3ad938(main3b4c13e2를 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이다. 생성 conflisten 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.고른 방법과 버린 대안
위험과 영향
7a4e201로는 켜면 안 된다. 그 이미지는 root로 80을 열어 probe가 모두 실패한다.chore/template-sync-v0.2.0, 다크 모드 글씨·2KB 본문 저장·제목 문구·템플릿 동기화)도 있어야 한다. 빠지면 그 4개가 운영에서 되돌아간다./etc/nginx/tls는 이미지에 없는 파일을 쓰는 예전 상태 그대로다.검증
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.json200,GET /200,CapEff 0,NoNewPrivs 1, Docker healthhealthy.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)3b4c13e2be0e9e9cab3ad938UNEXPECTED_DIAGNOSTIC, unitbuild-environment-bundle·second-api-feature-registries(#3이 들여온 시험). 이 PR이 새로 만든 실패는 없다.--user 101 --cap-drop ALL --security-opt no-new-privileges --sysctl net.ipv4.ip_unprivileged_port_start=1024로 띄우면/config.json200,/200, release-manifest commitShaab3ad938…, CapEff 0, NoNewPrivs 1, health healthy.kubectl apply --dry-run=serverrc=0, 경고 0./tmp/claude-gates/w1-infra/pr45/.