Branch Build Controls

Cloudflare Pages는 Git 연동 저장소에서 자동 배포를 관리할 수 있습니다. 기본적으로 프로덕션 또는 프리뷰 브랜치에 커밋하면 배포가 트리거되지만, 프로젝트별로 세부 설정이 가능합니다.

Production Branch 설정

Git 연동 프로젝트에서 프로덕션 브랜치 설정을 변경하려면:

Settings > Builds & deployments > Configure Production deployments

주요 기능

• 최초 푸시한 브랜치가 자동으로 프로덕션 브랜치로 지정됩니다
• 프로덕션 브랜치를 다른 브랜치로 변경할 수 있습니다
• Enable automatic production branch deployments 체크박스로 자동 배포를 활성화/비활성화할 수 있습니다

참고: Direct Upload 프로젝트는 프로덕션 브랜치 설정 UI가 없으며, API를 통해서만 변경 가능합니다.

Preview Branch 배포 옵션

세 가지 설정 중 선택할 수 있습니다:

Custom Branch 설정

특정 브랜치만 배포하거나 제외하려면 다음 방식을 사용합니다:

브랜치 지정 방식

처리 순서

브랜치 필터링은 다음 순서로 처리됩니다:

Excludes → Includes → Skip

1. Excludes: 먼저 제외할 브랜치를 필터링
2. Includes: 포함할 브랜치를 지정
3. Skip: [skip ci] 등으로 건너뛰기

와일드카드 패턴 예시

# 기능 브랜치만 배포
feat/*
feature/*

# 릴리스 브랜치만 배포
release/*
release-*

# 핫픽스 브랜치만 배포
hotfix/*
fix/*

# Dependabot 브랜치 제외 (Exclude에 설정)
dependabot/*

# 특정 prefix 브랜치 제외
test/*
experiment/*

설정 예시

개발 브랜치만 프리뷰 배포

Include branches:

develop
staging
feat/*

자동화 도구 브랜치 제외

Exclude branches:

dependabot/*
renovate/*
snyk-*

릴리스 브랜치만 프리뷰 배포

Include branches:

release/*
rc-*

배포 건너뛰기

특정 커밋에서 배포를 건너뛰려면 커밋 메시지에 다음 키워드를 포함합니다:

# 배포 건너뛰기
git commit -m "docs: update readme [skip ci]"
git commit -m "chore: update deps [ci skip]"

# 또는
git commit -m "fix: typo

[skip ci]"

지원되는 키워드:

• [skip ci]
• [ci skip]
• [no ci]
• [skip pages]

실전 활용 시나리오

시나리오 1: GitFlow 워크플로우

Production branch: main
Preview branches (Include):
  - develop
  - release/*
  - hotfix/*

Exclude branches:
  - feature/* (너무 많은 프리뷰 방지)

시나리오 2: Trunk-based Development

Production branch: main
Preview branches: All non-Production branches

Exclude branches:
  - dependabot/*
  - renovate/*

시나리오 3: 스테이징 환경만 프리뷰

Production branch: main
Preview branches (Include):
  - staging
  - qa

대시보드 설정 방법

1. Cloudflare 대시보드에서 Workers & Pages 선택
2. Pages 프로젝트 선택
3. Settings > Builds & deployments 이동
4. Configure preview deployments 클릭
5. 원하는 옵션 선택 및 브랜치 패턴 입력
6. Save 클릭

주의사항

• 와일드카드 *는 슬래시(/)를 포함한 모든 문자와 매칭됩니다
• Include와 Exclude를 동시에 설정할 경우, Exclude가 먼저 적용됩니다
• 프로덕션 브랜치는 Preview 설정과 별개로 관리됩니다
• Direct Upload 프로젝트는 브랜치 기반 배포를 사용할 수 없습니다

출처: Cloudflare Pages - Branch build controls