전체 흐름 영상으로 보기
단계별 상세 안내
OpenNext 배포 파일 준비
배포가 CI에서 동작하도록 wrangler.jsonc, open-next.config.ts, next.config.ts(초기화 추가), public/_headers, package.json 스크립트를 저장소에 포함합니다.
⚠ 시크릿은 절대 커밋 금지. .dev.vars·.env*·.open-next·.wrangler는 .gitignore로 제외합니다.
GitHub에서 새 저장소 생성
github.com/new에서 이름 creator-link-hub, Private으로 빈 저장소를 만듭니다(README·.gitignore 추가 없이).
GitHub 계정·인증은 사용자가 직접 진행합니다.
GitHub에 코드 푸시
git init → git add . → git commit 후, gh repo create creator-link-hub --private --source=. --push 한 번으로 업로드합니다(권장).
또는 git remote add origin … 후 git push -u origin main. 인증창이 뜨면 직접 로그인합니다. (이 저장소엔 deploy_push.ps1 헬퍼 포함)
Cloudflare Workers & Pages → Create
Cloudflare 대시보드 → Compute(Workers) → Workers & Pages → Create를 클릭합니다.
GitHub 연결 후 저장소 선택
Connect to Git → GitHub 권한 부여(사용자 직접) → creator-link-hub 저장소를 Import합니다.
프로젝트(Worker) 이름은 wrangler.jsonc의 name과 같게 하는 것을 권장합니다.
빌드·배포 명령 설정
Build command: npx opennextjs-cloudflare build
Deploy command: npx opennextjs-cloudflare deploy · Production branch main 지정 후 Save and Deploy.
빌드 변수·시크릿 등록
Settings → Build → Variables and secrets에 빌드 변수를 등록합니다. SSG 페이지가 빌드 타임에 값을 쓰므로 CI 빌드 환경에도 제공해야 합니다.
NEXT_PUBLIC_*는 번들 주입용, 비공개 키는 Secret으로. 런타임 전용 시크릿은 wrangler secret put로 별도 관리.
첫 배포 성공 — 웹에서 확인
Builds 로그가 Success가 되면 https://creator-link-hub.<account>.workers.dev URL이 발급됩니다. 접속해 확인합니다.
실패 시 로그에서 누락된 빌드 변수·명령 오류를 점검하고 재시도합니다.
커스텀 도메인 + 자동배포
도메인이 Cloudflare에 Active면 Settings → Domains & Routes → Add로 커스텀 도메인을 연결합니다(같은 존이면 DNS 자동).
이후 운영은 git push 한 번이면 Cloudflare가 자동으로 빌드·배포합니다. 브랜치 푸시로 Preview, Builds 목록에서 롤백도 가능합니다.