지니제스트 테크 블로그 배너
지니제스트Tech Archive
Category

Cloudflare

Cloudflare Workers, D1, R2, Zero Trust 설정 가이드 (총 5개)

Cloudflare Pages 배포 실패, 빌드 로그로 원인 찾기
Cloudflare6분 소요

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

Cloudflare Pages 배포 실패, 빌드 로그로 원인 찾기
Cloudflare Workers 환경 변수가 undefined일 때 확인할 것
Cloudflare8분 소요

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

Cloudflare Workers 환경 변수가 undefined일 때 확인할 것
Cloudflare Workers에서 정적 파일이 갱신되지 않을 때 캐시 정리
Cloudflare8분 소요

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

Cloudflare Workers에서 정적 파일이 갱신되지 않을 때 캐시 정리
Cloudflare Workers 배포 후 HTTP 522 오류 원인 찾기
Cloudflare8분 소요

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

Cloudflare Workers 배포 후 HTTP 522 오류 원인 찾기
Astro와 Cloudflare D1 연동, 바뀐 바인딩 접근법까지
Cloudflare7분 소요

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

Astro와 Cloudflare D1 연동, 바뀐 바인딩 접근법까지