Cloudflare
Cloudflare Workers, D1, R2, Zero Trust 설정 가이드 (총 5개)
Cloudflare Pages 배포가 Failed로 끝날 때 빌드 로그의 4단계(환경 초기화, 저장소 클론, 빌드, 배포) 중 어디서 멈췄는지 보는 법과 npm ci 락 파일 불일치, 대소문자, Node 버전, 20분 타임아웃, 월 500회 빌드 한도를 정리했습니다.

로컬 wrangler dev에서는 되는데 배포 후 env 값이 undefined인 이유를 .dev.vars와 .env 규칙, wrangler secret put, 환경별 vars 비상속, process.env 조건, 변수 개수 제한으로 나눠 확인하는 방법을 정리했습니다.

Workers로 R2 파일을 서빙했더니 파일을 바꿔도 옛 버전이 계속 보일 때, 브라우저 캐시·Cache API·CDN 캐시가 각각 어디서 응답하는지 구분하는 법과 해시 파일명, Cache API 사용 시 주의점, 퍼지 방법을 정리했습니다.

Workers를 붙인 뒤 522 Connection timed out이 날 때, 522는 Worker 코드가 아니라 오리진 TCP 연결 실패라는 점에서 출발해 Worker의 fetch 대상, 자기 자신을 부르는 요청, 방화벽의 Cloudflare IP 차단을 차례로 확인하는 방법과 1101·1102 오류와의 구분법을 정리했습니다.

Astro SSR 사이트를 Cloudflare Workers와 D1에 올릴 때 필요한 어댑터 설정, wrangler.jsonc 바인딩, cloudflare:workers로 env를 읽는 방법, 로컬과 원격 D1이 따로 노는 문제, 마이그레이션 순서를 정리했습니다. Astro 6부터 Astro.locals.runtime.env가 제거된 점도 다룹니다.

