dd/QUICKSTART.md

빠른 시작 가이드

로컬 개발

1. 의존성 설치

pnpm install

2. 개발 서버 실행

pnpm dev

브라우저에서 http://localhost:5173 접속

참고: 로컬 개발 환경에서는 실제 Durable Objects가 에뮬레이션되므로, WebSocket 연결이 완벽하게 작동하지 않을 수 있습니다.

3. Cloudflare Workers 환경에서 로컬 테스트

더 실제와 유사한 환경에서 테스트하려면:

pnpm build
pnpm cf:dev

이제 Wrangler가 로컬 Cloudflare Workers 환경을 시뮬레이션합니다.

Cloudflare에 배포

1. Wrangler 로그인

처음 배포하는 경우, Cloudflare 계정에 로그인합니다:

npx wrangler login

2. 프로젝트 빌드 및 배포

pnpm deploy

또는 수동으로:

pnpm build
npx wrangler deploy

3. 배포 확인

배포가 완료되면 Wrangler가 배포된 URL을 출력합니다:

Published dd (1.23 sec)
  https://dd.your-subdomain.workers.dev

브라우저에서 해당 URL을 열어 애플리케이션을 확인하세요!

Durable Objects 설정

첫 배포 시 Durable Objects를 활성화해야 할 수 있습니다:

1. Cloudflare Dashboard에 로그인: https://dash.cloudflare.com
2. Workers & Pages 섹션으로 이동
3. 배포된 Worker 선택
4. Settings > Durable Objects 탭
5. CounterDurableObject 바인딩 확인

로그 확인

실시간으로 Worker 로그를 확인하려면:

pnpm cf:tail

또는

npx wrangler tail

문제 해결

"Durable Object not configured" 오류

• wrangler.jsonc 파일이 올바르게 설정되었는지 확인
• Cloudflare Dashboard에서 Durable Objects 바인딩 확인
• 다시 배포: pnpm deploy

WebSocket 연결 실패

• 브라우저 콘솔에서 오류 메시지 확인
• wrangler tail로 서버 로그 확인
• HTTPS 환경인지 확인 (로컬에서는 HTTP도 가능)

빌드 오류

rm -rf .svelte-kit node_modules
pnpm install
pnpm build

다음 단계

• 여러 카운터 룸 추가
• 사용자 인증 구현
• 카운트 히스토리 저장
• 실시간 채팅 기능 추가

자세한 내용은 README.md를 참고하세요!