From 52fe0b5030c43f575f2a066c657c03ee67125b56 Mon Sep 17 00:00:00 2001 From: Yun Chan Date: Thu, 20 Aug 2026 20:43:35 +0900 Subject: [PATCH] =?UTF-8?q?=EC=BB=A4=EC=8A=A4=ED=85=80=20=EB=8F=84?= =?UTF-8?q?=EB=A9=94=EC=9D=B8=EC=9D=B4=20=ED=99=9C=EC=84=B1=ED=99=94?= =?UTF-8?q?=EB=90=90=EB=8B=A4=20=E2=80=94=20designpaca.chanpaca.net?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Pages 커스텀 도메인은 CNAME 을 Cloudflare 가 알아서 만든다. 그 레코드는 DNS 목록에도 DNS API 에도 나오지 않아서(Pages 관리형) 없는 줄 알고 손으로 추가하려다 'already exists' 오류를 받았다. 그 오류가 곧 성공 신호였다. 확인은 DNS API 가 아니라 Pages 도메인 API 로 한다. 실측: 등록 직후 pending -> 몇 분 뒤 active(검증 http, 인증서 google). https://designpaca.chanpaca.net/ 200 https://designpaca.chanpaca.net/en/ 200 https://designpaca.pages.dev/ 200 DEPLOYMENT_PLAN 에 이 함정을 기록했다. --- docs/DEPLOYMENT_PLAN.md | 22 +++++++++++++++++++++- 1 file changed, 21 insertions(+), 1 deletion(-) diff --git a/docs/DEPLOYMENT_PLAN.md b/docs/DEPLOYMENT_PLAN.md index 547ee27..da6c942 100644 --- a/docs/DEPLOYMENT_PLAN.md +++ b/docs/DEPLOYMENT_PLAN.md @@ -169,7 +169,27 @@ SSH 키는 이미 Forgejo 에 등록돼 있어(`encep-win`) 토큰도 비밀번 - `/user/tokens/verify` 는 **User 토큰 전용**이다. 계정 소유 토큰(`cfat…`)은 여기서 거부당한다. 그걸 보고 "토큰이 잘못됐다"고 판단하면 틀린다 — `wrangler whoami` 로 교차 확인해라 +### Pages 커스텀 도메인은 DNS 레코드를 직접 만들 필요가 없다 + +`designpaca.chanpaca.net` 을 Pages 프로젝트에 등록하면 **Cloudflare 가 CNAME 을 알아서 만든다.** +그런데 그 레코드는 **DNS 레코드 목록에도, DNS API 조회에도 나오지 않는다.** Pages 가 관리하기 때문이다. + +그래서 "레코드가 없네" 하고 손으로 추가하려 하면 이 오류를 만난다. + +``` +An A, AAAA, or CNAME record with that host already exists. +``` + +**이 오류가 곧 성공 신호다.** 레코드는 이미 있고, 상태만 `pending` → `active` 로 넘어가길 기다리면 된다. +확인은 DNS API 가 아니라 **Pages 도메인 API** 로 한다. + +``` +GET /accounts/{acc}/pages/projects/{proj}/domains + → status: pending | active +``` + +실측: 등록 직후 `pending`, 몇 분 뒤 `active`(검증 http, 인증서 google). 그때부터 200 이 뜬다. + ### 아직 남은 것 - `NPM_TOKEN` — 이름 선점이라 사람 승인 후에만 태그를 민다 -- `designpaca.chanpaca.net` CNAME — 토큰에 `Zone · DNS · Edit` 가 없어 수동으로 넣어야 한다