local-environment
Local development environment management for Polar using Docker
安装与使用
请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。
查看来源 ↗使用指南技能说明
Local Environment Skill
This skill enables Claude to help manage the Polar local development environment using Docker. Use this when the user needs to start, stop, debug, or understand the local development stack.
Conductor Integration
CRITICAL: When running in Conductor, always check CONDUCTOR_PORT first to determine the instance number:
echo $CONDUCTOR_PORT
- If
CONDUCTOR_PORTis not set → Not running in Conductor, use instance 0 - If
CONDUCTOR_PORTis set → Calculate instance:INSTANCE=$((CONDUCTOR_PORT - 55090))
| CONDUCTOR_PORT | Instance |
|---|---|
| 55090 | 0 |
| 55091 | 1 |
| 55092 | 2 |
| 55093 | 3 |
Always use -i $INSTANCE flag with all docker-dev commands when running in Conductor.
When to Use
- User asks to start/stop the local environment
- User needs to view logs or debug issues
- User wants to run multiple isolated instances
- User needs to understand the service architecture
- User encounters container or service errors
Quick Reference
| Task | Command |
|---|---|
| Start full stack | ./dev/docker-dev -i $INSTANCE -d |
| Stop services | ./dev/docker-dev -i $INSTANCE down |
| View all logs | ./dev/docker-dev -i $INSTANCE logs |
| View service logs | ./dev/docker-dev -i $INSTANCE logs {service} |
| Follow logs | ./dev/docker-dev -i $INSTANCE logs -f |
| Check status | ./dev/docker-dev -i $INSTANCE ps |
| Restart service | ./dev/docker-dev -i $INSTANCE restart {service} |
| Shell access | ./dev/docker-dev -i $INSTANCE shell {service} |
| Fresh start | ./dev/docker-dev -i $INSTANCE cleanup && ./dev/docker-dev -i $INSTANCE -d |
| With monitoring | ./dev/docker-dev -i $INSTANCE --monitoring -d |
| Force rebuild | ./dev/docker-dev -i $INSTANCE -b -d |
Services
| Service | Default Port | Description |
|---|---|---|
| api | 8000 | FastAPI backend |
| worker | - | Background job processor |
| web | 3000 | Next.js frontend |
| db | 5432 | PostgreSQL database |
| redis | 6379 | Redis cache |
| minio | 9000/9001 | S3-compatible storage |
| prometheus | 9090 | Metrics (optional) |
| grafana | 3001 | Dashboards (optional) |
Instance Port Mapping
Port = Base Port + (Instance × 100)
| Instance | API | Web | DB | Redis | MinIO |
|---|---|---|---|---|---|
| 0 | 8000 | 3000 | 5432 | 6379 | 9000 |
| 1 | 8100 | 3100 | 5532 | 6479 | 9100 |
| 2 | 8200 | 3200 | 5632 | 6579 | 9200 |
Rules Index
| Rule | Category | Description |
|---|---|---|
| service-architecture | Reference | Service details |
使用示例
查看来源仓库中的使用示例与配置说明。
查看来源 ↗来源历史
- 收录时间
- 2026-01-20
- 索引更新时间
- 2026-02-04
- Branch
- main
收录与同步日期属于本站记录。源码修改历史请查看来源仓库。
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!