Skip to content
SaaS ERP SaaS ERP Docs

Cloudflare Pages Project Migration

Cloudflare Pages projects cannot be renamed. To change the project name, create a new project and migrate traffic.

English

Use case

Migrate prego-devdoc to a brand-neutral name like platform-devdoc or internal-docs.

Status: Migration to platform-devdoc completed. See Cloudflare inventory for current project names.

Prerequisites

  • Cloudflare account access (Pages, DNS).
  • Git repository access (Pregoi/Prego).
  • Custom domain DNS control (if applicable).

Procedure

1. Create new Pages project

  1. Go to Cloudflare Dashboard → Workers & Pages → Create application → Pages.
  2. Connect to Git: select repository (Pregoi/Prego).
  3. Configure build settings:
    • Project name: platform-devdoc (or desired name)
    • Production branch: main
    • Build command: pnpm install --frozen-lockfile && pnpm run build:docs
    • Build output directory: docs/dist
    • Root directory: / (monorepo root)
  4. Add environment variables if needed (copy from old project).
  5. Save and deploy.

2. Verify new project

  1. Wait for initial deployment to complete.
  2. Visit https://platform-devdoc.pages.dev (new *.pages.dev URL).
  3. Verify all pages render correctly.

3. Migrate custom domain (if applicable)

If devdoc.pregoi.com points to the old project:

  1. In old project (prego-devdoc): Custom domains → Remove devdoc.pregoi.com.
  2. In new project (platform-devdoc): Custom domains → Add devdoc.pregoi.com.
  3. Cloudflare updates the CNAME automatically if using Cloudflare DNS.
  4. Wait for DNS propagation (usually instant with Cloudflare proxy).

4. Update CI/CD references

Search and replace in .github/workflows/:

Terminal window
rg 'prego-devdoc' .github/workflows --files-with-matches

Update any hardcoded project names in:

  • wrangler pages deploy --project-name=...
  • GitHub Actions that reference the project

5. Update documentation

6. Delete old project

After verifying:

  1. Confirm no traffic to old *.pages.dev URL.
  2. In old project settings: Delete project.

Rollback

If issues occur:

  1. Re-add custom domain to old project.
  2. Old *.pages.dev URL remains functional until project deletion.

한국어

Cloudflare Pages 프로젝트는 이름 변경이 불가능하다. 이름을 바꾸려면 새 프로젝트를 만들고 트래픽을 이전한다.

사용 사례

prego-devdoc 을 platform-devdoc 또는 internal-docs 같은 브랜드 중립 이름으로 이전.

상태: platform-devdoc으로 마이그레이션 완료. 현재 프로젝트 이름은 Cloudflare inventory 참고.

전제 조건

  • Cloudflare 계정 접근 (Pages, DNS).
  • Git 저장소 접근 (Pregoi/Prego).
  • 커스텀 도메인 DNS 제어 (해당 시).

절차

1. 새 Pages 프로젝트 생성

  1. Cloudflare Dashboard → Workers & Pages → Create application → Pages.
  2. Git 연결: 저장소 선택 (Pregoi/Prego).
  3. 빌드 설정:
    • Project name: platform-devdoc (또는 원하는 이름)
    • Production branch: main
    • Build command: pnpm install --frozen-lockfile && pnpm run build:docs
    • Build output directory: docs/dist
    • Root directory: / (모노레포 루트)
  4. 필요 시 환경 변수 추가 (기존 프로젝트에서 복사).
  5. 저장 후 배포.

2. 새 프로젝트 검증

  1. 초기 배포 완료 대기.
  2. https://platform-devdoc.pages.dev (새 *.pages.dev URL) 방문.
  3. 모든 페이지가 정상 렌더링되는지 확인.

3. 커스텀 도메인 이전 (해당 시)

devdoc.pregoi.com 이 기존 프로젝트를 가리키는 경우:

  1. 기존 프로젝트 (prego-devdoc): Custom domains → devdoc.pregoi.com 제거.
  2. 새 프로젝트 (platform-devdoc): Custom domains → devdoc.pregoi.com 추가.
  3. Cloudflare DNS 사용 시 CNAME 자동 업데이트.
  4. DNS 전파 대기 (Cloudflare 프록시 사용 시 보통 즉시).

4. CI/CD 참조 업데이트

.github/workflows/ 에서 검색 및 치환:

Terminal window
rg 'prego-devdoc' .github/workflows --files-with-matches

다음 항목의 하드코딩된 프로젝트명 업데이트:

  • wrangler pages deploy --project-name=...
  • 프로젝트를 참조하는 GitHub Actions

5. 문서 업데이트

6. 기존 프로젝트 삭제

검증 후:

  1. 기존 *.pages.dev URL로의 트래픽이 없음을 확인.
  2. 기존 프로젝트 설정: Delete project.

롤백

문제 발생 시:

  1. 기존 프로젝트에 커스텀 도메인 재추가.
  2. 기존 *.pages.dev URL은 프로젝트 삭제 전까지 유효.
Help