운영 profile(config/runtime/production.json)이 telemetry를 켠 채 자리표시자 주소 https://telemetry.example.com/v1/events로 보낸다. 이 주소는 DNS가 없고 받는 곳도 없다. 운영 빌드 인자 목록에 RUNTIME_TELEMETRY_ENDPOINT가 없어서 hyeonworks.com의 운영 이미지도 이 값을 쓴다. docs/release/2026-08-19-release-gate-verification.md P1-3에 이미 적힌 문제다.
소유자 결정(design-docs template-program/README.md 5절 c): 클러스터 안 수신처가 있으면 같은 origin 경로로 보내고, 없으면 끈다. 자리표시자로 보내지 않는다.
고른 방법과 버린 대안
수신처를 찾아본 결과 없다.
이 앱의 telemetry는 {events: [...]} JSON을 POST한다(src/adapters/telemetry/telemetry-collector.ts). OTLP 형식이 아니다.
클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다 ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다.
그래서 TELEMETRY_ENABLED: false로 두고 TELEMETRY_ENDPOINT 줄을 지운다. 꺼진 telemetry는 endpoint가 없어도 schema·배포 허용 검사를 통과한다(둘 다 켜졌을 때만 endpoint를 요구한다).
버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸기. 받는 곳이 없으니 요청만 는다.
위험과 영향
운영에서 화면 오류·기능 이벤트를 모으지 않는다. 지금도 주소가 DNS에 없어 실제로 모인 것은 없다.
지금 운영 이미지(7a4e201)에는 이 변경이 없다. 새 이미지로 배포할 때부터 적용된다. 7a4e201은 노트북 clone의 로컬 브랜치에만 있고 Gitea에 없다. 무엇을 배포할지는 소유자 판단이다.
staging profile의 telemetry.staging.example.com은 그대로 둔다. 배포된 staging이 없다.
검증
config/runtime/production.json이 JSON으로 읽힌다.
코드 확인: scripts/generate-runtime-config.ts가 덮어쓸 수 있는 값은 API_BASE_URL·TELEMETRY_ENDPOINT뿐이고, TELEMETRY_ENDPOINT는 선택 항목이다. release-artifacts.ts와 deployment-admission.ts는 TELEMETRY_ENABLED가 참일 때만 endpoint를 요구한다.
운영 빌드(desktop, Dockerfile과 같은 node@sha256:3638d9… 컨테이너, CI=true APP_PROFILE=production RUNTIME_API_BASE_URL=https://hyeonworks.com/ corepack pnpm build)가 통과했다. dist/config.json은 TELEMETRY_ENABLED: false이고 TELEMETRY_ENDPOINT가 없다. dist에 telemetry.example.com이 없다.
RELEASE_TARGET=production corepack pnpm check:release-admission: release admission: production ADMITTED.
커밋 본문의 검증 줄은 이 결과가 나오기 전에 push해서 「아직 돌리지 못했다」로 남아 있다. force push를 하지 않으려고 고치지 않았다. 이 PR 본문이 최종 결과다.
## 무엇을, 왜
운영 profile(`config/runtime/production.json`)이 telemetry를 켠 채 자리표시자 주소 `https://telemetry.example.com/v1/events`로 보낸다. 이 주소는 DNS가 없고 받는 곳도 없다. 운영 빌드 인자 목록에 `RUNTIME_TELEMETRY_ENDPOINT`가 없어서 hyeonworks.com의 운영 이미지도 이 값을 쓴다. `docs/release/2026-08-19-release-gate-verification.md` P1-3에 이미 적힌 문제다.
소유자 결정(design-docs `template-program/README.md` 5절 c): 클러스터 안 수신처가 있으면 같은 origin 경로로 보내고, 없으면 끈다. 자리표시자로 보내지 않는다.
## 고른 방법과 버린 대안
수신처를 찾아본 결과 없다.
- 이 앱의 telemetry는 `{events: [...]}` JSON을 POST한다(`src/adapters/telemetry/telemetry-collector.ts`). OTLP 형식이 아니다.
- 클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다 ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다.
그래서 `TELEMETRY_ENABLED: false`로 두고 `TELEMETRY_ENDPOINT` 줄을 지운다. 꺼진 telemetry는 endpoint가 없어도 schema·배포 허용 검사를 통과한다(둘 다 켜졌을 때만 endpoint를 요구한다).
버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸기. 받는 곳이 없으니 요청만 는다.
## 위험과 영향
- 운영에서 화면 오류·기능 이벤트를 모으지 않는다. 지금도 주소가 DNS에 없어 실제로 모인 것은 없다.
- 지금 운영 이미지(`7a4e201`)에는 이 변경이 없다. 새 이미지로 배포할 때부터 적용된다. `7a4e201`은 노트북 clone의 로컬 브랜치에만 있고 Gitea에 없다. 무엇을 배포할지는 소유자 판단이다.
- staging profile의 `telemetry.staging.example.com`은 그대로 둔다. 배포된 staging이 없다.
## 검증
- `config/runtime/production.json`이 JSON으로 읽힌다.
- 코드 확인: `scripts/generate-runtime-config.ts`가 덮어쓸 수 있는 값은 `API_BASE_URL`·`TELEMETRY_ENDPOINT`뿐이고, `TELEMETRY_ENDPOINT`는 선택 항목이다. `release-artifacts.ts`와 `deployment-admission.ts`는 `TELEMETRY_ENABLED`가 참일 때만 endpoint를 요구한다.
- 운영 빌드(desktop, Dockerfile과 같은 `node@sha256:3638d9…` 컨테이너, `CI=true APP_PROFILE=production RUNTIME_API_BASE_URL=https://hyeonworks.com/ corepack pnpm build`)가 통과했다. `dist/config.json`은 `TELEMETRY_ENABLED: false`이고 `TELEMETRY_ENDPOINT`가 없다. `dist`에 `telemetry.example.com`이 없다.
- `RELEASE_TARGET=production corepack pnpm check:release-admission`: `release admission: production ADMITTED`.
- 커밋 본문의 검증 줄은 이 결과가 나오기 전에 push해서 「아직 돌리지 못했다」로 남아 있다. force push를 하지 않으려고 고치지 않았다. 이 PR 본문이 최종 결과다.
## 리뷰어가 볼 곳
- `config/runtime/production.json` 한 파일.
## 관련
- design-docs `template-program/README.md` 5절 c
- `docs/release/2026-08-19-release-gate-verification.md` P1-3
운영 profile이 telemetry를 켠 채 `https://telemetry.example.com/v1/events`
로 보낸다. 이 주소는 자리표시자라 DNS가 없고, 받는 곳도 없다. 운영
빌드 인자 목록에 `RUNTIME_TELEMETRY_ENDPOINT`가 없어 hyeonworks.com의
운영 이미지도 이 값으로 나간다(release-gate 검증 문서 P1-3에 이미 적힌
문제다).
같은 origin으로 받을 수신처가 클러스터에 있으면 그리로 보내고, 없으면
끈다(소유자 결정, 2026-11-11). 수신처를 찾아봤다.
- 이 앱의 telemetry는 `{events: [...]}` JSON을 POST한다. OTLP 형식이
아니다.
- 클러스터의 OTLP 수신처는 alloy와 tempo의 gRPC 4317뿐이다. 둘 다
ClusterIP이고 traces만 받는다. 브라우저가 보낼 HTTP 경로는 없다.
그래서 `TELEMETRY_ENABLED`를 false로 두고 `TELEMETRY_ENDPOINT` 줄을
지운다. 꺼진 telemetry에는 endpoint가 필요 없다(release-artifacts와
deployment-admission 모두 켜졌을 때만 endpoint를 요구한다). 배포가
`RUNTIME_TELEMETRY_ENDPOINT`로 endpoint만 덮어써도 꺼진 채로 남는다.
버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸는 것. 받는 곳이
없으니 요청만 늘고, 켤 이유가 없다.
위험·한계: 운영 화면 오류·이벤트 수집이 다시 필요해지면 수신처를 먼저
만들고 profile을 켠다. 지금 운영 중인 이미지(7a4e201)는 이 커밋을 담지
않는다. 새 이미지로 배포할 때부터 적용된다.
검증: profile이 JSON으로 읽히고, generate-runtime-config가 덮어쓸 수
있는 값은 API_BASE_URL과 TELEMETRY_ENDPOINT뿐이며 둘 다 선택 항목임을
코드로 확인했다. 운영 빌드(`APP_PROFILE=production corepack pnpm build`)와
`check:release-admission`은 desktop heavy lock을 기다리는 중이라 아직
돌리지 못했다.
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.
무엇을, 왜
운영 profile(
config/runtime/production.json)이 telemetry를 켠 채 자리표시자 주소https://telemetry.example.com/v1/events로 보낸다. 이 주소는 DNS가 없고 받는 곳도 없다. 운영 빌드 인자 목록에RUNTIME_TELEMETRY_ENDPOINT가 없어서 hyeonworks.com의 운영 이미지도 이 값을 쓴다.docs/release/2026-08-19-release-gate-verification.mdP1-3에 이미 적힌 문제다.소유자 결정(design-docs
template-program/README.md5절 c): 클러스터 안 수신처가 있으면 같은 origin 경로로 보내고, 없으면 끈다. 자리표시자로 보내지 않는다.고른 방법과 버린 대안
수신처를 찾아본 결과 없다.
{events: [...]}JSON을 POST한다(src/adapters/telemetry/telemetry-collector.ts). OTLP 형식이 아니다.그래서
TELEMETRY_ENABLED: false로 두고TELEMETRY_ENDPOINT줄을 지운다. 꺼진 telemetry는 endpoint가 없어도 schema·배포 허용 검사를 통과한다(둘 다 켜졌을 때만 endpoint를 요구한다).버린 대안: endpoint를 hyeonworks.com의 빈 경로로 바꾸기. 받는 곳이 없으니 요청만 는다.
위험과 영향
7a4e201)에는 이 변경이 없다. 새 이미지로 배포할 때부터 적용된다.7a4e201은 노트북 clone의 로컬 브랜치에만 있고 Gitea에 없다. 무엇을 배포할지는 소유자 판단이다.telemetry.staging.example.com은 그대로 둔다. 배포된 staging이 없다.검증
config/runtime/production.json이 JSON으로 읽힌다.scripts/generate-runtime-config.ts가 덮어쓸 수 있는 값은API_BASE_URL·TELEMETRY_ENDPOINT뿐이고,TELEMETRY_ENDPOINT는 선택 항목이다.release-artifacts.ts와deployment-admission.ts는TELEMETRY_ENABLED가 참일 때만 endpoint를 요구한다.node@sha256:3638d9…컨테이너,CI=true APP_PROFILE=production RUNTIME_API_BASE_URL=https://hyeonworks.com/ corepack pnpm build)가 통과했다.dist/config.json은TELEMETRY_ENABLED: false이고TELEMETRY_ENDPOINT가 없다.dist에telemetry.example.com이 없다.RELEASE_TARGET=production corepack pnpm check:release-admission:release admission: production ADMITTED.리뷰어가 볼 곳
config/runtime/production.json한 파일.관련
template-program/README.md5절 cdocs/release/2026-08-19-release-gate-verification.mdP1-3