feat(deploy): 운영 backend를 prod profile로 돌릴 수 있게 한다(opt-in) #4

Merged
donghyeon.kang merged 2 commits from feat/backend-prod-profile into main 2026-11-12 01:58:41 +00:00
Owner

제목: feat(deploy): backend를 prod profile로 바꾸는 component를 둔다
브랜치: tech-log-frontend feat/backend-prod-profile, head be0e9e9c(main 3b4c13e2를 merge로 받음)

무엇을, 왜

운영 backend는 SPRING_PROFILES_ACTIVE=local로 돈다. application-local.yml은 외부 인프라 없이 혼자 뜨도록 값을 스스로 정하는 완결형 설정이다. 그래서 env로 덮지 않은 값이 개발용으로 남는다(이미지 46b1cc7 기준).

  • 가명화 salt가 개발용 고정값 __LOCAL_DEV_…다. 보안·감사 로그의 사용자 가명을 예측할 수 있다.
  • dev.caskeleton 로그가 DEBUG로 고정이다. env APP_LOG_LEVEL_APP가 먹지 않는다.
  • server.forward-headers-strategy가 none으로 고정이다. env가 먹지 않는다.
  • JWT issuer가 http://localhost:8081/realms/ca-skeleton다.
  • prod 시작 검사가 꺼져 있다: 스키마·Flyway 안전값, 오류 상세·본문 로깅 금지, DB TLS verify-full, H2 금지.

deploy/production/prod-profile/에 component를 둔다. 기본 경로에는 넣지 않는다. 켜면 다음이 들어간다.

  • SPRING_PROFILES_ACTIVE=prod
  • application.yml의 기본값 없는 placeholder 67개 중 빠진 값(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이 직접 정한 값은 env로 덮이지 않는다.
  • 버린 대안: 기본 경로에서 바로 바꾸기. 새 Secret 키나 CA ConfigMap이 없을 때 적용되면 backend가 뜨지 못한다.
  • object storage(ca-skeleton.objectstorage, env가 s3를 줌), Redis 세션, OIDC client, CORS는 그대로다.

위험과 영향

  • 켜기 전 전제가 셋이다: Secret 키 APP_PRIVACY_PSEUDONYMIZATION_SALT(소유자), ConfigMap hyeonworks-prod/platform-postgres-ca(CNPG CA 공개 인증서), 레지스트리 이미지. README 「backend prod profile」에 명령이 있다.
  • CNPG는 CA를 스스로 갱신한다(지금 만료 2027-01-11). 복사한 ConfigMap을 그때 다시 만들지 않으면 DB 연결이 끊긴다. 오래 가는 CA나 자동 복사는 플랫폼 쪽 남은 일이다.
  • salt가 바뀌면 이전 로그의 가명과 이어지지 않는다.
  • 아직 적용하지 않았다.

검증

  • component를 켠 렌더가 kubectl apply --dry-run=server를 통과한다.
  • desktop Docker에서 운영 이미지 46b1cc7을 이 env로 띄웠다. 조건은 uid 1000, cap-drop ALL, no-new-privileges, 비밀 값은 가짜다.
    • The following 1 profile is active: "prod"가 나온다.
    • property 결합과 prod 시작 검사를 모두 지난다.
    • 운영 DB에 TLS verify-full로 붙어 CA·호스트 이름 검증을 통과한 뒤, Flyway 단계에서 password authentication failed for user "techlog"로 멈췄다. 가짜 비밀번호라 예상한 결과다.
  • Redis·S3·OIDC 경로는 실제 비밀 값 없이 시험할 수 없어 하지 않았다.

리뷰어가 볼 곳

  • deploy/production/prod-profile/backend-prod-env.yaml의 값
  • README 「backend prod profile」의 전제와 되돌리기

새 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(deploy): backend를 prod profile로 바꾸는 component를 둔다 브랜치: tech-log-frontend `feat/backend-prod-profile`, head `be0e9e9c`(main `3b4c13e2`를 merge로 받음) ## 무엇을, 왜 운영 backend는 `SPRING_PROFILES_ACTIVE=local`로 돈다. `application-local.yml`은 외부 인프라 없이 혼자 뜨도록 값을 스스로 정하는 완결형 설정이다. 그래서 env로 덮지 않은 값이 개발용으로 남는다(이미지 `46b1cc7` 기준). - 가명화 salt가 개발용 고정값 `__LOCAL_DEV_…`다. 보안·감사 로그의 사용자 가명을 예측할 수 있다. - `dev.caskeleton` 로그가 DEBUG로 고정이다. env `APP_LOG_LEVEL_APP`가 먹지 않는다. - `server.forward-headers-strategy`가 none으로 고정이다. env가 먹지 않는다. - JWT issuer가 `http://localhost:8081/realms/ca-skeleton`다. - prod 시작 검사가 꺼져 있다: 스키마·Flyway 안전값, 오류 상세·본문 로깅 금지, DB TLS `verify-full`, H2 금지. `deploy/production/prod-profile/`에 component를 둔다. 기본 경로에는 넣지 않는다. 켜면 다음이 들어간다. - `SPRING_PROFILES_ACTIVE=prod` - `application.yml`의 기본값 없는 placeholder 67개 중 빠진 값(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이 직접 정한 값은 env로 덮이지 않는다. - 버린 대안: 기본 경로에서 바로 바꾸기. 새 Secret 키나 CA ConfigMap이 없을 때 적용되면 backend가 뜨지 못한다. - object storage(`ca-skeleton.objectstorage`, env가 s3를 줌), Redis 세션, OIDC client, CORS는 그대로다. ## 위험과 영향 - 켜기 전 전제가 셋이다: Secret 키 `APP_PRIVACY_PSEUDONYMIZATION_SALT`(소유자), ConfigMap `hyeonworks-prod/platform-postgres-ca`(CNPG CA 공개 인증서), 레지스트리 이미지. README 「backend prod profile」에 명령이 있다. - CNPG는 CA를 스스로 갱신한다(지금 만료 2027-01-11). 복사한 ConfigMap을 그때 다시 만들지 않으면 DB 연결이 끊긴다. 오래 가는 CA나 자동 복사는 플랫폼 쪽 남은 일이다. - salt가 바뀌면 이전 로그의 가명과 이어지지 않는다. - 아직 적용하지 않았다. ## 검증 - component를 켠 렌더가 `kubectl apply --dry-run=server`를 통과한다. - desktop Docker에서 운영 이미지 `46b1cc7`을 이 env로 띄웠다. 조건은 uid 1000, cap-drop ALL, no-new-privileges, 비밀 값은 가짜다. - `The following 1 profile is active: "prod"`가 나온다. - property 결합과 prod 시작 검사를 모두 지난다. - 운영 DB에 TLS `verify-full`로 붙어 CA·호스트 이름 검증을 통과한 뒤, Flyway 단계에서 `password authentication failed for user "techlog"`로 멈췄다. 가짜 비밀번호라 예상한 결과다. - Redis·S3·OIDC 경로는 실제 비밀 값 없이 시험할 수 없어 하지 않았다. ## 리뷰어가 볼 곳 - `deploy/production/prod-profile/backend-prod-env.yaml`의 값 - README 「backend prod profile」의 전제와 되돌리기 ## 새 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 1 commit 2026-11-11 23:29:32 +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 경로는 실제 비밀 값
없이는 시험할 수 없어 하지 않았다.
donghyeon.kang added 1 commit 2026-11-12 01:14:44 +00:00
donghyeon.kang merged commit 0cff7213d3 into main 2026-11-12 01:58:41 +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#4