완성되는 결과

이 문서에서는 sample-user/sample-web-sitehttps://sample-web-site.pages.dev을 형식 설명용으로 보여줍니다. 실제 script를 실행하면 GitHub browser login에서 승인한 독자 본인 account 아래에 독자가 직접 정한 repository가 생성됩니다. sample-user account를 사용하거나 생성하는 과정은 없습니다.

내 PC에서 한 번 실행

  1. 전달받은 ZIP을 압축 해제합니다.
  2. 배포_한번만_실행.bat를 더블클릭합니다.
  3. GitHub browser login이 뜨면 본인 account를 승인합니다.
  4. script가 새 repository를 만들고 source를 push할 때까지 기다립니다.
  5. 자동으로 열린 Cloudflare 화면에서 아래 설정만 입력합니다.
script가 자동 처리하는 것

Git·GitHub CLI 확인, GitHub login, 새 repository 생성, file upload, commit, main push까지 자동으로 처리합니다.

Cloudflare에서 입력하는 값

항목입력값
Repository[본인 GitHub ID]/[repository 이름]
가상 형식 예시: sample-user/sample-web-site
Project name[Cloudflare project 이름]
가상 예시: sample-web-site
Production branchmain
Framework preset없음
Build commandexit 0
Build output directorypublic
Root directory비워두기

마지막으로 저장 및 배포를 누릅니다. 배포가 끝나면 production 주소가 만들어지고 이후 GitHub push가 자동 배포 trigger가 됩니다.

성공 확인

  • 홈 화면에 한방배포 logo와 전체 guide card 표시
  • /robots.txt/sitemap.xml 접속
  • 상단의 가상 완성 예시 button이 가상 프로그램 웹으로 이동
  • Cloudflare deployment의 commit SHA와 GitHub 최신 commit 일치

AdSense 신청 전

preview deployment는 검색 색인·광고 신청용 production으로 사용하지 않으므로 광고 신청용으로 쓰지 않습니다. 이 절차에서 만든 production project에 본인 custom domain을 연결하고, original article과 policy page를 운영한 뒤 AdSense 검토를 요청합니다.

광고 동의 안내

기본 cookie banner는 script 동작 예시입니다. EEA·UK·Switzerland에서 실제 Google 광고를 운영하려면 Google CMP 또는 Google이 인증한 CMP를 사용하세요.

ADVERTISEMENT

AdSense 승인 후 광고가 표시될 자리입니다.

이전 guide← 오류 없이 한 번에 배포하는 최종 checklist

새로운 독자가 선택하는 3가지 시작 방법

1

Browser 중심

GitHub에서 본인 repository를 만들고, file을 올린 뒤 본인 Cloudflare account에서 Git에 연결합니다. 가장 느리지만 화면만 보고 진행할 수 있습니다.

2

AI + Codex

ChatGPT GitHub app으로 구조를 읽고, Codex로 file 수정·test·push를 수행합니다. write 권한과 실제 deployment를 따로 검증합니다.

3

Windows 한 번 실행

배포_한번만_실행.bat가 Git과 GitHub CLI를 준비하고 본인 account에 새 repository를 만든 뒤 Cloudflare 연결 화면을 엽니다.

본인 상황에 맞는 설정표 만들기