콘텐츠 제작과 배포를 하나의 흐름으로 보기
웹사이트에 콘텐츠를 늘려 가는 작업은 만들기, 검토하기, 기록하기, 공개하기의 네 단계가 반복됩니다. Claude는 첫 단계의 초안 작성과 코드 생성을 빠르게 도와주지만, 사실 확인과 최종 판단은 사람이 맡아야 합니다. 검토를 마친 결과물은 Git으로 변경 이력을 남기고 GitHub에 올려 두면, 문제가 생겼을 때 이전 상태로 돌아갈 수 있습니다. 마지막으로 Cloudflare Pages가 저장소의 변경을 받아 사이트를 다시 빌드해 공개합니다.
저장소 연결 배포와 직접 업로드 배포의 차이
Cloudflare Pages는 GitHub 저장소를 연결해 두면 푸시할 때마다 자동으로 빌드하고 배포합니다. 이 방식은 빌드에 필요한 환경 변수를 Cloudflare 프로젝트 설정에 직접 등록해야 합니다. 반대로 내 컴퓨터에서 빌드한 결과 폴더를 Wrangler 명령으로 직접 업로드하는 방식도 있으며, 이 경우에는 로컬 빌드에 쓰인 값이 그대로 결과물에 반영됩니다. 어느 쪽이든 API 키 같은 비밀 값은 저장소에 올리지 않도록 .env 파일을 .gitignore에 넣어 관리하세요.
GitHub 명령어 예시와 설명
터미널에서 프로젝트 폴더로 이동한 뒤 아래 순서로 실행합니다. 처음 한 번만 필요한 명령과 매번 반복하는 명령이 섞여 있습니다.
git init현재 폴더를 새 Git 저장소로 만듭니다. 이미 저장소라면 다시 실행할 필요가 없습니다.
git status어떤 파일이 바뀌었고 아직 커밋되지 않았는지 보여줍니다. 커밋 전에 .env 같은 파일이 포함되지 않았는지 확인할 때 씁니다.
git add .바뀐 파일 전체를 커밋 대상(스테이징)에 담습니다. 특정 파일만 담으려면 점(.) 대신 파일 경로를 적습니다.
git commit -m "새 가이드 페이지 추가"담아 둔 변경사항을 메시지와 함께 기록합니다. 무엇을 바꿨는지 한 줄로 적어 둡니다.
git branch -M main현재 브랜치 이름을 main으로 바꿉니다. 새 저장소를 처음 만들 때 한 번만 필요합니다.
git remote add origin https://github.com/내계정/저장소이름.git로컬 저장소를 GitHub 저장소(origin)에 연결합니다. 주소는 GitHub 저장소 화면에서 복사합니다.
git push -u origin main로컬 커밋을 GitHub에 올립니다. -u 옵션은 처음 한 번만 쓰며, 이후에는 git push만 실행해도 됩니다.
git log --oneline커밋 이력을 한 줄씩 보여줍니다. 이전 상태를 찾거나 푸시된 내용을 확인할 때 유용합니다.
Cloudflare 명령어 예시와 설명
저장소 연결 방식은 대시보드에서 설정하고, 아래 명령은 내 컴퓨터에서 빌드한 결과를 Wrangler로 직접 배포할 때 사용합니다. 프로젝트 이름은 본인이 정한 이름으로 바꿔서 입력하세요.
npm run build프로젝트를 빌드해 배포용 결과 폴더(Astro는 dist)를 만듭니다. 배포 전에 오류가 없는지 확인하는 단계이기도 합니다.
npm install -g wranglerCloudflare 배포 도구 Wrangler를 설치합니다. 전역 설치 없이 npx wrangler로 실행해도 됩니다.
wrangler login브라우저가 열리며 Cloudflare 계정에 로그인해 Wrangler 사용을 허용합니다. 처음 한 번만 필요합니다.
wrangler pages project create 프로젝트이름Cloudflare Pages 프로젝트를 새로 만듭니다. 대시보드에서 직접 만들었다면 생략합니다.
wrangler pages deploy dist --project-name=프로젝트이름 --branch=main빌드 결과 폴더를 Pages 프로젝트에 업로드해 배포합니다. --branch=main은 프로덕션(main) 브랜치로 배포되도록 지정하는 옵션입니다.
wrangler pages deployment list --project-name=프로젝트이름해당 프로젝트의 배포 이력을 보여줍니다. 어떤 배포가 현재 반영 중인지 확인할 때 씁니다.
함께 보면 좋은 가이드
커밋과 푸시가 처음이라면 깃허브(GitHub) 기초 사용법을, Claude를 처음 쓴다면 클로드(Claude) AI 기초 사용법을 먼저 확인해보세요. 사이트를 어디에 올릴지 고민 중이라면 웹 호스팅 종류 가이드도 도움이 됩니다.
자주 묻는 질문
Claude가 만든 콘텐츠를 검토 없이 바로 배포해도 되나요?
권장하지 않습니다. AI가 만든 글에는 부정확한 수치나 존재하지 않는 출처가 섞일 수 있으므로, 사실관계와 링크, 표현을 직접 확인한 뒤 커밋하고 배포해야 합니다.
Cloudflare Pages는 무료로 쓸 수 있나요?
무료 플랜으로도 정적 사이트를 배포할 수 있지만, 월 빌드 횟수와 파일 수 같은 한도가 있고 정책은 바뀔 수 있으므로 Cloudflare 공식 문서에서 현재 조건을 확인하세요.
배포한 내용을 잘못 올렸다면 어떻게 되돌리나요?
Cloudflare 배포 목록에서 이전 배포를 선택해 되돌리거나, Git에서 문제가 된 변경을 수정해 다시 커밋하고 푸시하면 새 배포가 만들어져 정상 상태로 복구됩니다.
.env 파일을 실수로 GitHub에 올렸다면 어떻게 해야 하나요?
해당 키를 즉시 폐기하고 새로 발급받는 것이 우선입니다. 저장소에서 파일을 지워도 커밋 이력에는 남아 있으므로, 노출된 키는 계속 사용하지 않는 것이 안전합니다.