Northstar Deploy Notes

Static first. Edge-ready later.

정적 프런트를 먼저 공개하고 API는 다음 단계로 분리합니다.

이 페이지는 저장소 루트의 site/ 폴더를 그대로 Cloudflare Pages에 업로드하는 시작 화면입니다. 지금은 빌드 없는 정적 배포에 집중하고, 이후 Cloudflare Workers와 외부 API 레이어를 별도 단계로 붙일 수 있게 흐름을 정리해 둔 상태입니다.

로드맵 보기 현재 구성 보기
Hosting Cloudflare Pages
Source Folder repo-root/site
Deploy Trigger push to main

01

루트 폴더 직배포

별도 빌드 없이 site/ 폴더만 업로드합니다. 초기 배포 흐름을 가장 단순하게 유지할 수 있습니다.

02

액션은 안전하게 스킵 가능

Cloudflare 자격 정보가 준비되지 않은 동안에는 업로드 단계를 건너뛰고 워크플로는 성공으로 끝납니다.

03

다음 단계 분리 용이

이후 Workers, Pages Functions, 외부 API 연동을 붙이더라도 정적 프런트 구조를 다시 흔들 필요가 없습니다.

Roadmap

릴리스 단계를 분리해서 복잡도를 관리합니다.

  1. Stage 1

    Cloudflare Pages로 정적 사이트 공개

    루트의 site/ 폴더를 GitHub Actions에서 Direct Upload 합니다. 도메인 연결 전에도 pages.dev URL로 바로 확인할 수 있습니다.

  2. Stage 2

    Workers 또는 Functions로 엣지 로직 추가

    문의 폼 처리, 간단한 프록시, 토큰 검증 같은 얇은 로직은 Cloudflare 쪽에 먼저 올릴 수 있습니다.

  3. Stage 3

    후속 API 연동

    무거운 비즈니스 로직과 저장 계층은 나중에 별도 서비스로 연결하고, 프런트 배포 파이프라인은 그대로 유지합니다.

Deploy Contract

현재 배포 단위는 오직 정적 자산입니다.

GitHub Actions는 site/를 Cloudflare Pages 프로젝트로 업로드합니다. Cloudflare 설정이 준비되기 전에는 CLOUDFLARE_PAGES_DEPLOY_ENABLED를 비워 두거나 false로 두면 됩니다.