머니큐브 개발일지 3편: Netlify 크레딧 소진 뒤 Cloudflare Pages 이전과 cones.info 도메인 연결

요약

  • 계기: Netlify 무료 계정 크레딧이 44 남아 배포마다 부담이 생김
  • 이전: 정적 자산은 dist, 서버 함수는 functions 폴더로 나눠 Cloudflare Pages에 배포
  • 유지: 기존 .html 주소가 308로 바뀌지 않도록 미들웨어에서 직접 응답
  • 도메인: Spaceship 네임서버를 Cloudflare로 바꾸고, 남아 있던 옛 DNSSEC DS 레코드를 새 키로 교체

옮기게 된 이유

사이트는 Netlify에 올려 두고 관리자 페이지에서 발행한 커밋으로 배포하고 있었습니다. 문제는 무료 계정 크레딧이었습니다. 배포를 한 번 할 때마다 크레딧이 줄어서, 마지막에는 44가 남았다는 안내를 확인했습니다. 남은 양으로는 앞으로의 수정 배포를 감당하기 어렵다고 판단해 이전을 결정했습니다.

Cloudflare Pages를 고른 이유는 무료 한도가 정적 사이트 운영에 맞았기 때문입니다. 정적 자산 대역폭은 사실상 제한이 없고, 서버 함수도 하루 10만 회까지 무료 범위입니다. 이 사이트의 함수는 호출량이 적어 충분했습니다.

구조를 그대로 옮기기

이전의 가장 큰 조건은 주소가 바뀌지 않는 것이었습니다. canonical, og:url, 사이트맵, 내부 링크가 모두 .html 주소를 쓰고 있었으므로, 이전하면서 주소가 바뀌면 검색엔진에 중복 페이지를 알리는 셈이 됩니다.

Cloudflare Pages는 /news.html 요청을 /news로 308 리디렉션합니다. 그래서 functions 폴더의 미들웨어에서 .html과 /admin 요청을 가로채 정적 자산을 직접 읽어 원래 주소 그대로 200으로 돌려주게 했습니다. 리디렉션을 따라가게 두는 대신 응답을 직접 만든 선택입니다.

서버 함수는 Netlify 형식에서 Cloudflare Pages Functions 형식으로 옮겼습니다. 뉴스 수집, 글 발행, 뉴스레터 접수 세 개가 먼저였고, 요청 본문 파싱과 응답 헤더는 두 플랫폼이 달라 손봐야 했습니다. 캐시 금지 헤더와 noindex 헤더는 _headers 파일로 분리해 관리자와 API 경로에 적용했습니다.

배포는 wrangler로 합니다. 빌드 스크립트가 dist를 만들고, 그 폴더만 올리면 함수는 프로젝트 루트의 functions에서 자동으로 묶입니다. 배포용 API 토큰은 계정 범위와 Pages 편집 권한만 가진 단기 토큰을 그때그때 발급해 쓰고, 배포 직후 대시보드에서 삭제한 뒤 토큰 검증 API가 401을 돌려주는지 확인합니다. 토큰이 남으면 같은 사고가 반복되므로 이 확인을 절차로 굳혔습니다.

도메인 네임서버 전환

도메인은 Spaceship에서 등록했습니다. 네임서버를 Cloudflare가 준 두 주소로 바꾸고, Cloudflare 존이 활성 상태가 된 것을 확인한 뒤 Pages 프로젝트에 cones.info와 www.cones.info를 연결했습니다. 두 주소 모두 기존 CNAME 레코드를 그대로 쓰고 프록시를 켜 두었고, 인증서는 Google Trust Services에서 발급되어 2027년 2월까지 유효합니다.

주소를 바꾼 뒤에는 소스 52개 파일의 도메인 문자열을 일괄 치환하고, 사이트맵과 robots.txt, 각 페이지의 canonical과 구조화 데이터까지 같은 값인지 확인한 다음 배포했습니다.

DNSSEC에서 막힌 지점

네임서버를 바꾼 직후 도메인이 열리지 않는 문제가 생겼습니다. 원인은 DNSSEC였습니다. 등록 업체가 DNSSEC를 기본으로 켜 두어 옛 키 태그 48071의 DS 레코드가 레지스트리에 남아 있었고, 새 네임서버가 그 키를 모르니 검증 리졸버가 SERVFAIL을 돌려줬습니다. 브라우저에서는 도메인이 없는 것처럼 보였습니다.

등록 업체의 DNSSEC 화면은 레코드가 0건이라 삭제할 항목이 없었습니다. 그래서 반대 방향으로 풀었습니다. Cloudflare 존에서 DNSSEC를 켜 새 DS 값(키 태그 2371, 알고리즘 13, 다이제스트 유형 2)을 받아 등록 업체의 DS 레코드로 추가했습니다. 레지스트리의 DS가 새 값으로 교체되면서 옛 키 태그는 사라졌고, 구글 DNS에서 신뢰 사슬이 정상(AD=true)으로 응답했습니다.

한 가지 남은 현상이 있었습니다. 1.1.1.1은 옛 DS를 캐시하고 있어 한동안 검증 표시가 꺼진 채 응답했습니다. 조회 자체는 정상이었고, DS TTL인 1시간이 지나면서 일치했습니다. DNS는 고친 순간 모든 리졸버에서 동시에 바뀌지 않는다는 것을 다시 확인했습니다.

이전 후 손본 것들

배포 뒤에도 브라우저가 옛 app.js를 쓰는 일이 있었습니다. Cloudflare Pages가 css와 js를 4시간 캐시하기 때문입니다. 빌드 스크립트가 배포 시각을 쿼리 문자열로 붙이도록 바꿔, 새 배포가 있으면 주소가 달라지게 했습니다.

프리뷰 배포에서는 KV 바인딩이 적용되지 않아 뉴스레터 저장이 꺼진 것처럼 보였습니다. wrangler 설정에 프리뷰 환경 바인딩을 따로 선언하고 프리뷰 배포를 한 번 만들어 해결했습니다. 운영과 프리뷰의 환경 변수는 같은 값을 따로 넣어야 한다는 점도 이때 정리했습니다.

이전 직후 로컬 테스트 1,076개를 다시 돌려 모두 통과했고, 운영 주소의 주요 페이지와 함수, 사이트맵이 200으로 응답하는 것도 확인했습니다. 4편에서는 이 환경 위에 유지비 0원 뉴스란과 뉴스레터를 얹은 과정을 다룹니다.

머니큐브 개발일지 시리즈

이 블로그의 인기 게시물

네이버·티스토리 글을 구글 Blogger로 이전하는 방법: 무료 도구 소개

네이버 블로그 글을 구글 Blogger로 이전하는 방법: 무료 이전 도구

GitHub 대안 5곳: 코드 저장소와 웹사이트 배포 방법