Commit Graph
6 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
DongHyeonkaandClaude Opus 5 b3aa304975 feat: 프로젝트를 공개할 수 있게 하고, 홈이 무엇을 앞에 둘지 고를 수 있게 한다
공개 화면 다섯 곳이 조용히 비어 있었다. 원인은 하나씩 달랐지만 모두 "값을 채울
방법이 없었다"는 같은 모양이었다.

홈의 "지금 집중하는 것" — `home_focus_config` 는 마이그레이션이 빈 행 하나만
넣어 두었고, 계약에 선언된 `getHomeFocus`/`updateHomeFocus` 는 구현이 없었다.
세 슬롯이 모두 비면 홈은 그 영역을 아예 그리지 않으므로, 운영에서는 한 번도
나타난 적이 없다. Studio 대시보드에 고르는 화면을 둔다.

홈의 "최근 기록" — 화면이 공개된 프로젝트를 하나씩 돌며 타임라인을 조립했다.
그래서 게시한 문서라도 그 프로젝트가 공개되어 있지 않으면 목록에서 통째로
빠졌고, 실제로 릴리스 한 줄만 남았다. 무엇이 최근인지는 공개 투영이 이미 알고
있으므로 그것을 그대로 읽는다. 프로젝트마다 요청을 보내던 N+1 도 사라진다.

프로젝트 공개 — 프로젝트는 `RecordKind` 에 없어 문서 게시 파이프라인을 타지
못하는데, 공개 화면들(프로젝트 목록·프로필의 "현재 프로젝트"·홈 focus)은 전부
`public_resource_projection` 의 PROJECT 행을 가시성 관문으로 쓴다. 그 행을
세우는 경로가 없었으므로 프로젝트는 영원히 비공개였다. 계약에 이미 있던
`publishProject`/`unpublishProject` 를 구현하고 주제·프로젝트 화면에 버튼을 둔다.

문서 사이 관계 연결 — `JdbcCatalogQueryAdapter` 의 RELATION/EVIDENCE 가
`List.of()` 스텁이라 어떤 기록도 연결 대상 목록을 채울 수 없었다. RELATION 은
작성 중에 고르는 것이므로 작업본까지 포함하고, EVIDENCE 는 읽는 사람이 따라갈
수 있어야 하므로 공개된 것만 포함한다.

본문 너비 — 문서 한 편이 세 폭으로 갈라져 있었다. 머리말 920px, 유형·프로젝트
줄은 shell 전체 1180px, 본문은 672px 를 가운데 정렬. 셋을 같은 폭·같은 왼쪽
끝에 세우고 읽는 단을 56rem 으로 넓힌다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01XEHXspz4rv5pB5wiiSsVDu
2026-08-23 17:38:49 +09:00
DongHyeonka 83409bef7a feat: give the frontend a deployment artifact, and show its logo
The repository had no container image and no production-shaped serving
configuration. `dist/server.mjs` is a preview server that applies neither
the security headers nor the cache policy `config/hosting/` declares, so a
deployment had nothing correct to run.

`scripts/generate-nginx-config.ts` derives the server block from
`dist/tech-log-serving-contract.json` plus the two hosting policy files, so
the served headers and cache lifetimes cannot drift from what the contract
declares. It emits no TLS and no proxy blocks: the edge terminates TLS and
routes /api, and baking a backend address into the image would tie the
bundle to one deployment. Static surfaces use `alias` because a base-path
build serves /dev/assets/... out of dist/assets/..., which `root` plus URI
would look for one directory too deep.

The image copies that config next to the bundle and normalises permissions:
the build writes config.json 0600, which nginx cannot read, so the container
came up healthy and answered 403 for the one file the SPA needs to boot.

index.html never referenced public/favicon.svg. The file shipped and nginx
served it, but browsers asked for /favicon.ico, got a 404, and fell back to
the default icon. `%BASE_URL%` rather than an absolute path so a prefixed
deployment points at its own copy.

development.json moves to the HTTP Studio source; the mock source has no
backend to authenticate against, which is the whole point of that profile.
2026-08-20 16:14:09 +09:00