더 나은 인프라 선택을 위한 독립 가이드 THE INFRASTRUCTURE EDIT
HOSTING / NODEPICK GUIDE

Cloudflare Pages, 빌드와 배포가 붙어 있는 호스팅

저장소 연결부터 사용자 도메인 연결까지 Pages 배포 흐름을 정리합니다.

노드픽 에디토리얼작성·업데이트 2026-10-19
Cloudflare Pages, 빌드와 배포가 붙어 있는 호스팅의 주제를 표현한 AI 콘셉트 이미지
AI 제작 콘셉트 이미지입니다. 특정 시설·제품의 실사진이 아닙니다.
먼저 기억할 핵심
  • 빌드 명령과 출력 폴더를 지정하고 첫 배포 결과를 열어 확인했다
  • 미리보기 환경에 시험 데이터만 연결했다
  • 미리보기 주소의 색인 거부를 설정했다

저장소를 연결하면 배포가 절차가 됩니다

빌드와 배포가 붙어 있는 호스팅의 핵심 이점은 손으로 올리는 단계가 사라지는 것입니다. 저장소를 연결하면 변경을 밀어 넣는 것만으로 빌드가 돌고 결과가 배포됩니다. 설정 순서는 1단계 저장소 연결, 2단계 빌드 명령과 출력 폴더 지정, 3단계 환경 변수 등록, 4단계 사용자 도메인 연결입니다. 가장 많이 막히는 지점은 2단계입니다. 출력 폴더 이름이 프로젝트 설정과 다르면 빌드는 성공하는데 빈 사이트가 배포됩니다. 그래서 첫 배포 뒤에는 반드시 실제 주소를 열어 내용이 나오는지 확인하고, 그 결과를 기록합니다.

저장소 연결 → 빌드 설정 확인 → 도메인 연결
가운데 칸에서 출력 폴더를 틀리면 빌드는 성공하고 사이트는 비어 있습니다.

미리보기 배포를 검토 절차에 넣습니다

이런 플랫폼은 보통 작업 분기마다 별도 주소를 만들어 줍니다. 이 기능을 쓰면 검토가 쉬워집니다. 변경 사항을 설명하는 대신 미리보기 주소를 보내면 됩니다. 운영에 적용할 때의 규칙은 두 가지입니다. 첫째, 미리보기 환경에 운영 데이터를 연결하지 않습니다. 환경 변수를 분리해 시험 데이터만 쓰게 합니다. 둘째, 미리보기 주소가 검색에 노출되지 않게 막습니다. 색인 거부 설정을 미리보기에만 적용하면 같은 내용이 두 주소로 검색되는 문제를 피할 수 있습니다. 이 두 규칙을 배포 설정에 넣어 두면 검토 과정에서 사고가 생기지 않습니다.

손 배포와 자동 배포의 시간을 비교합니다

학습용 가정으로 계산합니다. 가정값은 월 배포가 60회이고, 자동 배포는 사람이 기다릴 필요 없이 빌드만 3분 걸리며, 손 배포는 파일 생성과 업로드와 확인에 10분이 걸린다고 두겠습니다. 자동 배포의 빌드 시간 합계는 180분이지만 사람이 붙어 있지 않습니다. 손 배포는 600분이 사람 시간입니다. 차이는 420분이고, 내부 시간 비용을 시간당 30,000원으로 가정하면 월 210,000원입니다. 이것이 중간 계산값입니다. 최종 효과에는 실수로 인한 재배포가 줄어드는 몫이 더해지므로, 재배포 횟수를 함께 기록해 비교합니다.

자동 배포: 사람이 기다리는 시간이 사라지는가; 미리보기: 시험 데이터 분리와 색인 거부를 설정했는가; 빌드 제약: 시간 제한과 도구 버전을 확인했는가
위 두 줄은 이점이고 아래 줄은 도입 전 확인 사항입니다. 금액은 가정값 계산입니다.

빌드 환경의 제약이 걸림돌이 됩니다

결론을 뒤집는 조건이 있습니다. 첫째, 빌드 시간 제한과 동시 빌드 수 제한이 있습니다. 빌드가 오래 걸리는 프로젝트는 제한에 걸려 실패할 수 있으므로, 빌드 시간을 먼저 측정하고 제한과 비교합니다. 둘째, 빌드 환경에서 쓸 수 있는 도구 버전이 정해져 있습니다. 특정 버전이 필요하면 설정으로 지정할 수 있는지 확인해야 하고, 불가능하면 미리 빌드한 결과만 올리는 방식으로 바꿉니다. 셋째, 서버 측 처리가 필요한 기능은 별도 함수로 옮겨야 합니다. 그래서 도입 전에 빌드 시간, 도구 버전, 서버 측 기능 세 항목을 점검표로 확인합니다.

웹호스팅 실행 전 점검표

  • 빌드 명령과 출력 폴더를 지정하고 첫 배포 결과를 열어 확인했다
  • 미리보기 환경에 시험 데이터만 연결했다
  • 미리보기 주소의 색인 거부를 설정했다
  • 빌드 시간·도구 버전·서버 측 기능을 점검했다
조건을 넣어 직접 계산하기 →

이 가이드의 근거 문서

출처 확인일: 2026-10-19. 공식 문서에 기반한 편집 가이드이며 직접 수행한 벤치마크가 아닙니다. 비용 사례는 명시된 가정에 한합니다.

  1. Cloudflare Pages 문서 ↗
  2. Cloudflare 전체 설정 방식 ↗
  3. Cloudflare Workers 문서 ↗
오류 제보 방법

함께 읽으면 좋은 가이드