docs: update documentation for Queue-based server provisioning
- Add Queue creation commands to CLAUDE.md - Document server-provision-queue and provision-dlq - Add Server System section with async flow diagram - Document security improvements (password hashing, retryable flag) - Update README.md with Queue setup in deployment guide Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
18
README.md
18
README.md
@@ -21,8 +21,8 @@
|
||||
* 🛠 **Function Calling**: 날씨, 검색, 계산, 시간 등 다양한 도구를 자연어로 호출
|
||||
* 💰 **예치금 시스템**: 은행 SMS 자동 파싱(AI 폴백 지원) 및 양방향 매칭을 통한 자동 충전
|
||||
* 🌐 **도메인 관리**: 도메인 검색, 추천(AI), 가격 조회, 등록, DNS 관리 통합
|
||||
* 🖥️ **서버 관리**: Linode/Vultr 인스턴스 검색, 비교, 주문, 소유권 관리
|
||||
* ⚡ **서버리스**: Cloudflare Workers 위에서 동작하여 별도의 서버 관리 불필요
|
||||
* 🖥️ **서버 관리 (Queue 기반)**: Linode/Vultr 인스턴스 검색, 비교, 주문, 비동기 프로비저닝
|
||||
* ⚡ **서버리스**: Cloudflare Workers + Queues로 긴 작업도 안정적 처리
|
||||
|
||||
### 🚀 성능 최적화
|
||||
|
||||
@@ -59,7 +59,14 @@ npx wrangler kv:namespace create RATE_LIMIT_KV
|
||||
# 출력된 id를 wrangler.toml의 [[kv_namespaces]] 섹션에 입력
|
||||
```
|
||||
|
||||
### 4. 환경변수 설정
|
||||
### 4. Queue 생성
|
||||
```bash
|
||||
# 서버 프로비저닝용 Queue 생성 (서버 기능 사용 시 필수)
|
||||
npx wrangler queues create server-provision-queue
|
||||
npx wrangler queues create provision-dlq
|
||||
```
|
||||
|
||||
### 5. 환경변수 설정
|
||||
|
||||
#### 필수 Secrets
|
||||
|
||||
@@ -111,7 +118,7 @@ NAMECHEAP_API_URL = "https://your-api.example.com"
|
||||
- `WTTR_IN_URL` - 날씨 API
|
||||
- `HOSTING_SITE_URL` - 공식 웹사이트
|
||||
|
||||
### 5. 배포
|
||||
### 6. 배포
|
||||
|
||||
#### 배포 전 체크리스트
|
||||
|
||||
@@ -148,7 +155,7 @@ curl "https://telegram-summary-bot.kappa-d8e.workers.dev/webhook-info?token=${BO
|
||||
npm run tail
|
||||
```
|
||||
|
||||
### 6. Webhook 연결
|
||||
### 7. Webhook 연결
|
||||
|
||||
```bash
|
||||
# 웹훅 설정 (token + secret 필요)
|
||||
@@ -159,6 +166,7 @@ curl "https://<YOUR_WORKER_URL>/setup-webhook?token=${BOT_TOKEN}&secret=${WEBHOO
|
||||
|
||||
- **WEBHOOK_SECRET 필수**: 미설정 시 모든 webhook 요청이 거부됩니다.
|
||||
- **KV Namespace 필수**: 미생성 시 Rate Limiting이 비활성화되어 DoS 공격에 취약합니다.
|
||||
- **Queue 필수 (서버 기능 사용 시)**: 미생성 시 서버 프로비저닝 기능이 동작하지 않습니다.
|
||||
- **환경변수 기본값**: 대부분의 외부 API URL은 기본값이 설정되어 있습니다. 프로덕션 환경에서는 기본값을 그대로 사용하거나, 필요시에만 override하세요.
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user