119 lines
2.2 KiB
Markdown
119 lines
2.2 KiB
Markdown
# 빠른 시작 가이드
|
|
|
|
## 로컬 개발
|
|
|
|
### 1. 의존성 설치
|
|
```bash
|
|
pnpm install
|
|
```
|
|
|
|
### 2. 개발 서버 실행
|
|
```bash
|
|
pnpm dev
|
|
```
|
|
|
|
브라우저에서 http://localhost:5173 접속
|
|
|
|
**참고**: 로컬 개발 환경에서는 실제 Durable Objects가 에뮬레이션되므로, WebSocket 연결이 완벽하게 작동하지 않을 수 있습니다.
|
|
|
|
### 3. Cloudflare Workers 환경에서 로컬 테스트
|
|
|
|
더 실제와 유사한 환경에서 테스트하려면:
|
|
|
|
```bash
|
|
pnpm build
|
|
pnpm cf:dev
|
|
```
|
|
|
|
이제 Wrangler가 로컬 Cloudflare Workers 환경을 시뮬레이션합니다.
|
|
|
|
## Cloudflare에 배포
|
|
|
|
### 1. Wrangler 로그인
|
|
|
|
처음 배포하는 경우, Cloudflare 계정에 로그인합니다:
|
|
|
|
```bash
|
|
npx wrangler login
|
|
```
|
|
|
|
### 2. 프로젝트 빌드 및 배포
|
|
|
|
```bash
|
|
pnpm deploy
|
|
```
|
|
|
|
또는 수동으로:
|
|
|
|
```bash
|
|
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 로그를 확인하려면:
|
|
|
|
```bash
|
|
pnpm cf:tail
|
|
```
|
|
|
|
또는
|
|
|
|
```bash
|
|
npx wrangler tail
|
|
```
|
|
|
|
## 문제 해결
|
|
|
|
### "Durable Object not configured" 오류
|
|
|
|
- `wrangler.jsonc` 파일이 올바르게 설정되었는지 확인
|
|
- Cloudflare Dashboard에서 Durable Objects 바인딩 확인
|
|
- 다시 배포: `pnpm deploy`
|
|
|
|
### WebSocket 연결 실패
|
|
|
|
- 브라우저 콘솔에서 오류 메시지 확인
|
|
- `wrangler tail`로 서버 로그 확인
|
|
- HTTPS 환경인지 확인 (로컬에서는 HTTP도 가능)
|
|
|
|
### 빌드 오류
|
|
|
|
```bash
|
|
rm -rf .svelte-kit node_modules
|
|
pnpm install
|
|
pnpm build
|
|
```
|
|
|
|
## 다음 단계
|
|
|
|
- 여러 카운터 룸 추가
|
|
- 사용자 인증 구현
|
|
- 카운트 히스토리 저장
|
|
- 실시간 채팅 기능 추가
|
|
|
|
자세한 내용은 `README.md`를 참고하세요!
|
|
|