개요
로컬 환경에 존재하는 Jamstack 정적 사이트(HTML, CSS, JS 파일 묶음)를 Git 연동 없이 Wrangler CLI만으로 Cloudflare Pages에 배포하고, 이후 수정 사항을 반복적으로 재배포하는 전체 절차를 다룬다. 전제는 Git 자동 배포가 필요 없는 수동 배포 워크플로우이며, 단순성과 통제 가능성을 우선하는 사용자를 대상으로 한다. 이 방식은 배포 구조가 명확하고 의존성이 적어, 운영 복잡도를 최소화한다.
적용 범위는 자주 변경되지 않는 개인 포트폴리오 사이트와 소규모 회사 소개 사이트로 한정한다. 이 유형의 사이트는 기본적인 SEO 설정(title, meta, og 태그, sitemap), 빠른 로딩 속도, 커스텀 도메인 연결, 최소 유지비, 서버 기능의 부재라는 요구 조건을 가진다. 이러한 조건에서는 Cloudflare Pages와 Cloudflare DNS의 조합이 구조적으로 적합하다. 정적 파일은 글로벌 CDN을 통해 즉시 배포되며, 무료 플랜에서도 상업적 수준의 응답 속도를 확보할 수 있다. 커스텀 도메인 연결 시에도 별도의 호스팅 비용은 발생하지 않는다. SEO 또한 정적 HTML에서 메타 태그를 직접 제어하므로 설정이 투명하고 예측 가능하다.
LLM은 HTML 구조 설계, 카피라이팅, 메타 태그 구성, sitemap 및 robots.txt 생성까지 자동화함으로써 제작 비용을 실질적으로 0에 가깝게 낮춘다. 결과적으로 “정적 파일 + CDN + 수동 배포”라는 단순 구조가 비용, 성능, 자율성 측면에서 균형 잡힌 해법이 된다.
반면 Wix나 WordPress의 호스팅형 무료 플랜은 광고 노출, 커스텀 도메인 제한, 플랫폼 브랜딩 유지 등의 제약이 존재하며, 이를 제거하려면 지속적인 비용이 발생한다. 기술 친화적 사용자라는 전제를 둘 경우, Wrangler 기반 정적 배포 구조는 보다 경제적이고 통제 가능한 대안이 될 수 있다.
사전 준비: Wrangler 설치 및 계정 연결
먼저 로컬 환경과 Cloudflare 계정을 연결한다.
- Node.js 설치: Wrangler는 Node.js 기반 CLI이므로 Node.js가 설치되어 있어야 한다.
- Wrangler 전역 설치: 터미널에서 다음 명령을 실행한다.
npm install -g wrangler- Cloudflare 로그인: 명령 실행 시 브라우저가 열리며, Cloudflare 계정으로 로그인 후 권한을 승인하면 로컬 CLI와 계정이 연결된다.
wrangler login- 프로젝트 생성: Pages 프로젝트 초기화 (최초 1회). 배포 대상 파일이 위치한 폴더로 이동한 뒤 Pages 프로젝트를 생성한다. 프로젝트 이름은 최종 배포 주소인 https://<프로젝트-이름>.pages.dev 의 기반이 된다. Production branch는 일반적으로 main으로 설정한다. 실제 Git을 사용하지 않더라도 Pages 설정값으로 필요하다. 이 단계는 한 번만 수행한다.
cd 경로/to/your/project
wrangler pages project create <프로젝트-이름>배포
- 첫 배포: 로컬 정적 파일 업로드. 프로젝트 폴더 내 정적 파일을 Cloudflare Pages로 업로드한다.
wrangler pages deploy .여기서 “.”은 현재 디렉터리 전체를 의미한다. 배포가 완료되면 https://<프로젝트-이름>.pages.dev 형태의 고유 주소가 발급되며 즉시 접속 가능하다. 이 명령은 Git push와 유사한 역할을 수행하지만, Git 저장소 없이 로컬 파일을 직접 업로드한다는 점이 다르다.
- 수정 후 재배포: 반복 워크플로우. 파일 수정 후에는 동일 명령을 다시 실행하면 된다.
wrangler pages deploy .- 배포 명령 단축: npm script 활용. 반복 입력을 줄이기 위해 package.json에 스크립트를 정의할 수 있다.
{
"scripts": {
"deploy": "wrangler pages deploy ."
}
}이후에는 다음 명령만 입력하면 된다.
npm run deploy