jiunbae Service Manager
Central service and container management.
Service Registry
Location: ~/.agents/SERVICES.md or static/SERVICES.md
| Service | Port | Container | Status |
|---------|------|-----------|--------|
| postgres | 5432 | db-postgres | running |
| redis | 6379 | cache-redis | running |
| api | 8080 | app-api | stopped |
Common Commands
List Running Services
docker ps --format "table {{.Names}}\t{{.Ports}}\t{{.Status}}"
Check Port Availability
lsof -i :8080 || echo "Port available"
Start Service
docker start <container>
# or
docker-compose up -d <service>
View Logs
docker logs -f <container> --tail 100
Workflows
Register New Service
- Check port availability
- Add to SERVICES.md
- Verify no conflicts
Find Port Conflicts
# List all used ports
docker ps --format "{{.Ports}}" | grep -oE '[0-9]+(?=->)'
lsof -i -P -n | grep LISTEN
Health Check
docker inspect --format='{{.State.Health.Status}}' <container>
Port Conventions
| Range | Usage |
|---|---|
| 3000-3999 | Web frontends |
| 5000-5999 | APIs |
| 5432 | PostgreSQL |
| 6379 | Redis |
| 8080-8099 | Backend services |
Best Practices
- Always check port before registering
- Use docker-compose for multi-container apps
- Keep SERVICES.md updated