Cloudflare-GitHub 자동 배포(CI/CD) 연동 가이드

1. 전제 조건 (Prerequisites)

로컬 코드가 GitHub 원격 저장소(main 브랜치)에 최종 푸시된 상태여야 함.

Cloudflare 계정에 대상 Workers 프로젝트가 생성되어 있어야 함.

2. Cloudflare 대시보드 설정

1) 프로젝트 진입: Cloudflare 대시보드 -> [Workers & Pages] -> 해당 Worker 선택.

2) 배포 설정 이동: 상단 탭의 [설정] 클릭

3) 저장소 연결: 빌드 섹션에서 [연결] 버튼 클릭.

4) 권한 승인: GitHub 계정 인증 후, 배포할 저장소를 목록에서 선택.

빌드 구성 확인:

Production branch: main (기본값)

Build command: (공백) 또는 npm run deploy (필요시 자동 인식됨)

Root directory: / (기본값)

저장: **[Save and Deploy]**를 눌러 최종 연결을 확정함.

3. 자동 배포 메커니즘 (작동 원리)

1) Push = Deploy: 개발자가 로컬에서 git push를 실행하는 즉시 Cloudflare가 이를 감지함.

2) Build Pipeline: Cloudflare 내부 서버가 코드를 가져와 빌드 후 실서버에 즉시 반영.

3) 중앙 집중 관리: Cloudflare 대시보드 에디터를 거치지 않고 오직 GitHub 코드가 '단일 진실 공급원(SSOT)'이 됨.

4. 장애 대응 및 주의사항

1) 배포 실패 시: 대시보드 [Deployments] 탭에서 상세 로그를 확인하여 빌드 에러 원인 분석.

2) 코드 불일치 주의: 대시보드 웹 에디터에서 직접 수정 금지. 반드시 로컬 VS Code에서 수정 후 push 할 것.

5. 일상 개발 워크플로우 (3단계)

1) 코드 수정: VS Code에서 기능 개발.

2) 로컬 검증: npx wrangler dev로 사전 테스트.

자동 배포: git add . -> git commit -m "내용" -> git push (배포 완료).