8. 실제로 배포하기
로컬에서 잘 동작하는 것을 확인했다면, 이제 실제 Cloudflare 엣지 네트워크에 배포해봅시다.
8.1 로그인 확인
아직 로그인하지 않았다면 먼저 로그인합니다. (2장 참고)
bash
npx wrangler login npx wrangler whoami
8.2 배포하기
프로젝트 디렉터리에서 아래 명령 한 줄이면 끝입니다.
bash
npx wrangler deploy
성공하면 아래와 같은 출력이 나옵니다.
text
⛅️ wrangler 4.x.x ──────────────────── Total Upload: 1.23 KiB / gzip: 0.65 KiB Uploaded cloudflare-workers-course-sample (2.1 sec) Published cloudflare-workers-course-sample (0.5 sec) https://cloudflare-workers-course-sample.<your-subdomain>.workers.dev Current Deployment ID: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
출력된 URL(*.workers.dev)로 접속하면 방금 배포한 Worker가 전 세계 어디서든 접근 가능한 상태가 됩니다.
8.3 KV를 사용하는 경우 주의사항
7장에서 만든 KV 네임스페이스를 사용하는 프로젝트라면, wrangler.jsonc의 kv_namespaces[].id가 placeholder가 아닌 실제로 발급받은 id여야 배포 후에도 정상 동작합니다.
bash
npx wrangler kv namespace create VISITS_KV # 출력된 id를 wrangler.jsonc에 반영한 뒤 npx wrangler deploy
8.4 배포 확인하기
bash
curl https://cloudflare-workers-course-sample.<your-subdomain>.workers.dev/api/hello
Cloudflare 대시보드(dash.cloudflare.com → Workers & Pages)에서도 배포 상태, 요청 로그, 실시간 트래픽을 확인할 수 있습니다.
8.5 실시간 로그 보기
배포한 Worker의 실행 로그를 실시간으로 스트리밍할 수 있습니다.
bash
npx wrangler tail
8.6 롤백하기
배포에 문제가 있다면 이전 배포로 즉시 되돌릴 수 있습니다.
bash
npx wrangler rollback