Spaces:
Running
Download docs/CONFIG_AND_ENV_GUIDE_PHASE4_LIVEKIT.md from taskpilot952476/taskpilot: direct link, hf CLI and curl.
- Browser
- Download file 9.57 kB
-
https://huggingface.co/spaces/taskpilot952476/taskpilot/resolve/main/docs/CONFIG_AND_ENV_GUIDE_PHASE4_LIVEKIT.md
- Command line
-
hf download hf://spaces/taskpilot952476/taskpilot/docs/CONFIG_AND_ENV_GUIDE_PHASE4_LIVEKIT.md
-
curl -L -o CONFIG_AND_ENV_GUIDE_PHASE4_LIVEKIT.md https://huggingface.co/spaces/taskpilot952476/taskpilot/resolve/main/docs/CONFIG_AND_ENV_GUIDE_PHASE4_LIVEKIT.md
HƯỚNG DẪN CẤU HÌNH BIẾN MÔI TRƯỜNG & CHUẨN BỊ GIAI ĐOẠN 4 (LIVEKIT VIDEO MEETING)
Dự án: TaskPilot - Hệ thống Quản lý Dự án Thông minh tích hợp AI Agent
Tài liệu tham chiếu: Đề cương Đồ án 2 & Hướng dẫn Vận hành Hệ thống
Ngày cập nhật: 08/10/2026
1. GIẢI THÍCH SỰ CỐ REDIS NXDOMAIN VÀ CƠ CHẾ SỬA LỖI
1.1. Triệu chứng sự cố (Log trên Hugging Face Spaces)
WARN 1 --- [taskpilot-app] [oundedElastic-1] b.d.r.h.DataRedisReactiveHealthIndicator : Redis health check failed
org.springframework.data.redis.RedisConnectionFailureException: Unable to connect to Redis
Caused by: io.lettuce.core.RedisConnectionException: Unable to connect to easy-vervet-91102.upstash.io/<unresolved>:6379
Caused by: io.netty.resolver.dns.DnsResolveContext$SearchDomainUnknownHostException: Failed to resolve 'easy-vervet-91102.upstash.io' [A(1)]
Caused by: io.netty.resolver.dns.DnsErrorCauseException: Query failed with NXDOMAIN
1.2. Nguyên nhân cốt lõi (Root Cause)
- Lỗi DNS NXDOMAIN (Non-Existent Domain): Tên miền
easy-vervet-91102.upstash.iotrên nhà cung cấp Upstash Redis đã bị xóa, hết hạn hoặc thay đổi định danh cơ sở dữ liệu. Do đó, hệ thống DNS toàn cầu phản hồi mãNXDOMAIN(tên miền không tồn tại). - Cơ chế Health Check của Spring Boot Actuator: Mặc dù dự án đã cấu hình
JWT_BLOCKLIST_PROVIDER=memory(sử dụng ConcurrentHashMap trong RAM để lưu trữ token thu hồi, không phụ thuộc Redis), nhưng do dependencyspring-boot-starter-data-rediscó mặt trong classpath, Spring Boot Actuator tự động kích hoạtDataRedisReactiveHealthIndicatorđể kiểm tra kết nối Redis định kỳ. Khi kết nối thất bại, Actuator sẽ ghi nhận cảnh báo và có thể đánh dấu container làUNHEALTHY(DOWN).
1.3. Giải pháp đã thực hiện (Miễn nhiễm sự cố)
Trong cả application.yml và application-prod.yml, hệ thống đã cấu hình tắt kiểm tra sức khỏe Redis của Actuator:
management:
health:
mail:
enabled: false
redis:
enabled: false
Nhờ đó, Spring Boot khởi động mượt mà, Tomcat chạy ổn định trên cổng 7860 mà không bị gián đoạn hay crash container ngay cả khi Redis không khả dụng.
2. HƯỚNG DẪN CẤU HÌNH CHO GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING
Giai đoạn 4 theo đề cương (21/10/2026 – 03/11/2026) bao gồm:
- Khởi tạo phòng họp video/audio trực tuyến thời gian thực giữa các thành viên dự án.
- Chia sẻ màn hình (Screen sharing), điều khiển mic/camera.
- Ghi hình cuộc họp (Recording qua LiveKit Egress) và tự động lưu trữ vào kho tệp dự án (Project File Storage).
2.1. Đăng ký tài khoản LiveKit Cloud (Miễn phí)
- Truy cập cloud.livekit.io và đăng nhập bằng tài khoản Google hoặc GitHub.
- Tạo một Project mới (ví dụ đặt tên:
taskpilot-collab). - Sau khi tạo project, điều hướng vào mục Project Settings > Keys:
- WebSocket URL: Dạng
wss://taskpilot-collab-xxxxxx.livekit.cloud - API Key: Dạng
APIxxxxxxxxxxxx - API Secret: Dạng
secretxxxxxxxxxxxxxxxxxxxx
- WebSocket URL: Dạng
- Sao chép 3 giá trị trên để chuẩn bị thêm vào
.env.
2.2. Các biến môi trường cần bổ sung cho Giai đoạn 4
Trong file .env (cả local và cấu hình Secrets trên Hugging Face Spaces / Production), bổ sung nhóm biến:
# ==============================================================================
# GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING & RECORDING
# ==============================================================================
LIVEKIT_URL=wss://taskpilot-collab-xxxxxx.livekit.cloud
LIVEKIT_API_KEY=APIxxxxxxxxxxxxxxxxxxxx
LIVEKIT_API_SECRET=secretxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
LIVEKIT_EMPTY_TIMEOUT_SECONDS=300
LIVEKIT_MAX_PARTICIPANTS=15
2.3. Tích hợp Egress Recording lưu vào S3 (Tùy chọn)
Nếu nhóm triển khai tính năng tự động ghi hình cuộc họp, LiveKit Cloud hỗ trợ xuất video trực tiếp vào S3 Storage. Bạn có thể sử dụng trực tiếp Supabase S3 bucket documents đã có sẵn:
- Storage Type: S3 Compatible
- Endpoint: Giá trị của
SUPABASE_S3_ENDPOINT - Access Key: Giá trị của
SUPABASE_S3_ACCESS_KEY - Secret Key: Giá trị của
SUPABASE_S3_SECRET_KEY - Bucket:
documents - Region:
ap-southeast-1
3. FILE MẪU .env TOÀN DIỆN CHO DỰ ÁN TASKPILOT (FULL TEMPLATE)
Dưới đây là mẫu file .env hoàn chỉnh chứa 100% các biến môi trường của tất cả các phân hệ:
# ==============================================================================
# 1. CƠ SỞ DỮ LIỆU POSTGRESQL (SUPABASE PGVECTOR)
# ==============================================================================
# Lưu ý: Cổng 6543 là Transaction Pooler của Supabase, cần prepareThreshold=0
DB_URL=jdbc:postgresql://aws-1-ap-southeast-1.pooler.supabase.com:6543/postgres?sslmode=require&prepareThreshold=0
DB_USERNAME=postgres.vbuvggybjjnotyxtbtnw
DB_PASSWORD=YOUR_SUPABASE_DB_PASSWORD
# ==============================================================================
# 2. XÁC THỰC BẢO MẬT (JWT & AUTH)
# ==============================================================================
JWT_SECRET=d6f0f991aa2c94368d21776821a88fa305402cbf2cbcecbca0b5dee2f68094e4
JWT_EXPIRATION=86400000
JWT_BLOCKLIST_PROVIDER=memory
PASSWORD_RESET_EXPIRATION=900000
# ==============================================================================
# 3. DỊCH VỤ EMAIL (BREVO SMTP RELAY)
# ==============================================================================
MAIL_HOST=smtp-relay.brevo.com
MAIL_PORT=2525
MAIL_USERNAME=YOUR_BREVO_SMTP_USERNAME
MAIL_PASSWORD=YOUR_BREVO_SMTP_KEY
MAIL_FROM="TaskPilot Support<support.taskpilot@gmail.com>"
# ==============================================================================
# 4. BỘ NHỚ ĐỆM & RATE LIMIT (UPSTASH REDIS)
# ==============================================================================
# Nếu sử dụng Upstash Redis, tạo database mới tại https://console.upstash.com/redis
REDIS_HOST=YOUR_UPSTASH_REDIS_ENDPOINT.upstash.io
REDIS_PASSWORD=YOUR_UPSTASH_REDIS_PASSWORD
REDIS_PORT=6379
REDIS_SSL=true
# ==============================================================================
# 5. KHO LƯU TRỮ TỆP TIN & AVATAR (SUPABASE S3 COMPATIBLE STORAGE)
# ==============================================================================
SUPABASE_S3_ENDPOINT=https://vbuvggybjjnotyxtbtnw.storage.supabase.co/storage/v1/s3
SUPABASE_S3_ACCESS_KEY=YOUR_SUPABASE_S3_ACCESS_KEY
SUPABASE_S3_SECRET_KEY=YOUR_SUPABASE_S3_SECRET_KEY
SUPABASE_S3_REGION=ap-southeast-1
SUPABASE_S3_BUCKET=avatars
SUPABASE_S3_DOCUMENT_BUCKET=documents
SUPABASE_S3_PUBLIC_URL=https://vbuvggybjjnotyxtbtnw.supabase.co/storage/v1/object/public/avatars
# ==============================================================================
# 6. THÔNG BÁO THỜI GIAN THỰC (ONESIGNAL PUSH NOTIFICATIONS)
# ==============================================================================
ONESIGNAL_APP_ID=YOUR_ONESIGNAL_APP_ID
ONESIGNAL_REST_API_KEY=YOUR_ONESIGNAL_REST_API_KEY
# ==============================================================================
# 7. AI LLM GATEWAY (MULTI-KEY ROTATION & FAILOVER)
# ==============================================================================
# Google Gemini (Dùng cho Chat AI, Embedding 768-dim RAG)
GEMINI_API_KEY=YOUR_PRIMARY_GEMINI_API_KEY
GEMINI_API_KEYS=KEY_1,KEY_2
# Groq Fast Inference (Llama 3.3, Llama 4 Scout)
GROQ_API_KEY=YOUR_PRIMARY_GROQ_KEY
GROQ_API_KEYS=KEY_1,KEY_2,KEY_3,KEY_4,KEY_5
AI_GROQ_ENABLED=true
AI_GROQ_GATEKEEPER_MODEL=llama-3.1-8b-instant
# OpenRouter Fallback Models (Free models)
OPENROUTER_API_KEY=YOUR_PRIMARY_OPENROUTER_KEY
OPENROUTER_API_KEYS=KEY_1,KEY_2,KEY_3,KEY_4
AI_OPENROUTER_ENABLED=true
# GitHub Models Token
GITHUB_TOKEN=YOUR_GITHUB_PAT_TOKEN
# ==============================================================================
# 8. MÔI TRƯỜNG WEB & CORS
# ==============================================================================
FE_ORIGIN="https://taskpilot-platform.netlify.app, http://localhost:5173, http://127.0.0.1:5173"
# ==============================================================================
# 9. GIAI ĐOẠN 4: LIVEKIT VIDEO MEETING (CHUẨN BỊ CHO KỲ 21/10)
# ==============================================================================
LIVEKIT_URL=wss://YOUR_PROJECT.livekit.cloud
LIVEKIT_API_KEY=YOUR_LIVEKIT_API_KEY
LIVEKIT_API_SECRET=YOUR_LIVEKIT_API_SECRET
4. BIẾN MÔI TRƯỜNG CHO FRONTEND (taskpilot-frontend/.env.local)
Đối với giao diện Frontend:
# Backend API Base URL
VITE_API_BASE_URL=http://localhost:8080/api
# Vite proxy target cho local development
VITE_API_PROXY_TARGET=http://localhost:8080
# Push Notification
VITE_ONESIGNAL_APP_ID=YOUR_ONESIGNAL_APP_ID
# Tùy chọn: URL WebSocket riêng nếu không dùng tự động phân giải
# VITE_WS_URL=ws://localhost:8080/ws/chat
# Chuẩn bị cho Giai đoạn 4: LiveKit Server URL cho frontend WebRTC
# VITE_LIVEKIT_URL=wss://YOUR_PROJECT.livekit.cloud