Cloudflare Workers Deploy

## 누구를 위한 도구인가

Cloudflare Workers 와 Pages 에 배포하는 개발자를 위한 도구입니다. 이 플러그인은 엣지 최적화 아키텍처 설계부터 wrangler 를 사용한 배포, 배포 추적, 프로덕션 모범 사례까지 전 생애주기를 다룹니다.

## 3 단계 퀵스타트

1. **엣지 배포 설계하기** — 다음과 같이 질문하세요: `"Use edge-computing-patterns to suggest the best Cloudflare Workers architecture for a globally distributed API"`. 이 스킬은 Worker 라우팅, KV 스토리지, D1 데이터베이스 패턴을 다룹니다.
2. **wrangler 로 배포하기** — 다음과 같이 질문하세요: `"Use wrangler to deploy my Worker in ./src/worker.ts to production"`. wrangler 와 dicklesworthstone-wrangler 스킬이 Wrangler CLI, KV 네임스페이스, R2 버킷, 시크릿을 처리합니다.
3. **추적 및 관리하기** — 다음과 같이 질문하세요: `"Use deployment-management to list all active Workers deployments and check their health status"`. 완전한 배포 전략을 위해서는 다음과 같이 질문하세요: `"Use the Deployment Engineer to create a deployment plan for rolling out v2 with zero downtime"`.

## 단계 → 스킬 → 입력 → 출력

| 단계 | 스킬 | 제공 항목 | 결과 |
|------|-------|------------------|--------------|
| 아키텍처 설계 | edge-computing-patterns | 앱 요구사항 | Workers 아키텍처 + 라우팅 추천 |
| 배포 | wrangler / dicklesworthstone-wrangler | Worker 소스 경로 + 환경 | 배포 URL + wrangler 출력 |
| 프로덕션 배포 플로우 | deploying-to-production | 저장소 URL + 대상 (Vercel/CF) | GitHub 저장소 + 실시간 배포 |
| 배포 추적 | deployment-management | 인프라 이름 / 범위 | 배포 상태 + 상태 보고서 |
| 배포 전략 | Deployment Engineer | 앱 유형 + 롤아웃 요구사항 | 단계별 배포 계획 |

## 일반적인 오류 및 해결 방법

- **wrangler 가 "not authenticated" 오류 발생** → 터미널에서 먼저 `wrangler login` 을 실행하거나, `CLOUDFLARE_API_TOKEN` 을 환경 변수로 설정하세요.
- **edge-computing-patterns 이 일반적인 답변을 제공** → 사용 사례를 구체적으로 명시하세요: `"globally distributed read-heavy API with 50ms SLA"` 라고 하면 훨씬 더 타겟팅된 패턴을 제공합니다.
- **deployment-management 에 배포가 표시되지 않음** → 인프라 범위 또는 프로젝트 이름이 Cloudflare 대시보드의 항목과 정확히 일치하는지 확인하세요.

## 성공 기준

다음과 같은 경우 성공한 것입니다:
- edge-computing-patterns 이 구체적인 아키텍처 다이어그램 또는 라우팅 구성을 반환
- wrangler 또는 dicklesworthstone-wrangler 가 `workers.dev` 또는 커스텀 도메인 URL 을 출력
- deployment-management 가 모든 Worker 인스턴스가 정상임을 확인