cc1c-devops

name	cc1c-devops
description	Execute DevOps tasks for CommandCenter1C: start/stop services locally (host machine), check health endpoints, view logs, run migrations. Use when user needs to start development environment, check service status, debug deployment issues, or mentions local development, health checks, logs, restart.
allowed-tools	["Bash","Read"]

cc1c-devops

Purpose

Управлять DevOps операциями для локальной разработки проекта CommandCenter1C.

Hybrid Development Mode: Infrastructure сервисы (PostgreSQL, Redis) запускаются в Docker, Application сервисы (Django, Go, React) запускаются на хост-машине.

When to Use

Используй этот skill когда:

• Запуск/остановка локального окружения разработки
• Проверка статуса сервисов (PID, HTTP endpoints, порты)
• Просмотр логов локальных процессов
• Перезапуск конкретных сервисов после изменений кода
• Отладка проблем с запуском
• Пользователь упоминает: start, stop, restart, logs, health, status, local development

Quick Commands

Essential Commands

# Запустить все сервисы
./scripts/dev/start-all.sh

# Проверить статус
./scripts/dev/health-check.sh

# Просмотр логов
./scripts/dev/logs.sh <service-name>
./scripts/dev/logs.sh all

# Перезапустить сервис
./scripts/dev/restart.sh <service-name>

# Остановить все
./scripts/dev/stop-all.sh

Available Services

Application (Host):

• orchestrator - Django Orchestrator (port 8000)
• celery-worker - Celery Worker (async tasks)
• celery-beat - Celery Beat (scheduler)
• api-gateway - Go API Gateway (port 8080)
• worker - Go Worker (parallel processing)
• cluster-service - Go Cluster Service (port 8088)
• batch-service - Go Batch Service (port 8087)
• frontend - React Frontend (port 5173)

Infrastructure (Docker):

• postgres - PostgreSQL (port 5432)
• redis - Redis (port 6379)

External:

• ras-grpc-gw - RAS gRPC Gateway (port 9999) - в ../ras-grpc-gw

Critical Service Dependencies

⚠️ ВАЖНО: Некоторые сервисы имеют зависимости и должны запускаться в порядке:

Правильный порядок запуска:

1. Infrastructure (PostgreSQL, Redis) - Docker контейнеры
2. ras-grpc-gw - КРИТИЧНО запускать ПЕРВЫМ перед cluster-service
3. cluster-service - зависит от ras-grpc-gw (порт 9999)
4. batch-service - независим
5. Остальные сервисы - Orchestrator, Celery, API Gateway, Workers, Frontend

Граф зависимостей:

Infrastructure (PostgreSQL, Redis)
  ↓
ras-grpc-gw (external, port 9999)
  ↓
cluster-service ───┐
                   │
batch-service ─────┼──→ Orchestrator ──→ API Gateway ──→ Frontend
                   │         ↓
                   └────→ Celery Workers

Проверка зависимостей перед запуском cluster-service:

# Check ras-grpc-gw is running
curl http://localhost:8081/health
# Expected: {"service":"ras-grpc-gw","status":"healthy",...}

# Check gRPC port is listening
netstat -ano | findstr :9999  # Windows
lsof -i :9999  # Linux/Mac

Key Concepts

1. Hybrid Development Mode

• Infrastructure (PostgreSQL, Redis) → Docker контейнеры
• Application (Django, Go, React) → локальные процессы на хосте
• Преимущества: Hot reload, debugging, IDE integration
• Требования: .env.local с DB_HOST=localhost (НЕ postgres)

2. PID Management

• Все сервисы управляются через PID файлы: pids/<service>.pid
• ./scripts/dev/start-all.sh создает PID файлы
• ./scripts/dev/stop-all.sh использует PID для graceful shutdown
• ./scripts/dev/restart.sh читает PID, останавливает, запускает заново

3. Health Check Strategy

• Process check: проверка PID файлов
• HTTP check: curl health endpoints (8080, 8000, 8088, 5173)
• Database check: pg_isready, redis-cli ping
• Port check: netstat/lsof для проверки listening ports

4. Log Management

• Логи в logs/<service>.log
• ./scripts/dev/logs.sh <service> - tail -f для конкретного сервиса
• ./scripts/dev/logs.sh all - последние 10 строк всех сервисов
• Docker logs: docker-compose -f docker-compose.local.yml logs <service>

5. Critical Services (batch-service, cluster-service, ras-grpc-gw)

batch-service:

• Установка расширений (.cfe) в базы 1С через subprocess
• Требует EXE_1CV8_PATH в переменных окружения
• Port 8087

cluster-service:

• Мониторинг кластеров 1С через gRPC
• ЗАВИСИМОСТЬ: ras-grpc-gw ДОЛЖЕН быть запущен первым
• Port 8088

ras-grpc-gw:

• gRPC gateway для RAS протокола 1С
• Внешний репозиторий: ../ras-grpc-gw
• Ports: 9999 (gRPC), 8081 (HTTP health)
• ⚠️ Запускать ПЕРВЫМ!

Детали см. {baseDir}/reference/services.md

Common Operations

Start Dev Session (утро)

cd /c/1CProject/command-center-1c
./scripts/dev/start-all.sh
./scripts/dev/health-check.sh

After Code Changes

# Изменил код Django
./scripts/dev/restart.sh orchestrator

# Изменил код Go API Gateway
./scripts/dev/restart.sh api-gateway

# Изменил код React
./scripts/dev/restart.sh frontend

Debugging Service

# Проверить логи
./scripts/dev/logs.sh orchestrator

# Проверить health endpoint
curl http://localhost:8000/health

# Запустить вручную (foreground, full output)
cd orchestrator
source venv/Scripts/activate
python manage.py runserver 0.0.0.0:8000

End of Day

./scripts/dev/stop-all.sh

Critical Constraints

1. Service Dependencies: ras-grpc-gw → cluster-service (порядок запуска критичен!)
2. Environment Files: .env.local с DB_HOST=localhost (НЕ postgres)
3. PID Management: НЕ удаляй pids/ вручную, используй ./scripts/dev/stop-all.sh
4. Port Conflicts: Перед запуском проверь что порты свободны (8080, 8000, 8088, 5173, 5432, 6379)
5. Infrastructure First: Docker containers (PostgreSQL, Redis) ДОЛЖНЫ быть запущены первыми

Common Problems

Services Won't Start

Symptom: Error: address already in use Quick Fix:

./scripts/dev/stop-all.sh
./scripts/dev/start-all.sh

Database Connection Error

Symptom: could not connect to server Quick Fix:

# Check .env.local
cat .env.local | grep DB_HOST
# Should be: DB_HOST=localhost

docker-compose -f docker-compose.local.yml restart postgres
./scripts/dev/restart.sh orchestrator

cluster-service Connection Refused (port 9999)

Symptom: connection refused on port 9999 Quick Fix:

# Start ras-grpc-gw FIRST
cd ../ras-grpc-gw
go run cmd/main.go localhost:1545

# Wait 3-5 seconds, then start cluster-service
cd /c/1CProject/command-center-1c
./scripts/dev/restart.sh cluster-service

batch-service "1cv8.exe not found"

Symptom: executable file not found Quick Fix:

# Set path in .env.local
echo 'EXE_1CV8_PATH=C:\Program Files\1cv8\8.3.27.1786\bin\1cv8.exe' >> .env.local
./scripts/dev/restart.sh batch-service

Полный troubleshooting: см. {baseDir}/reference/troubleshooting.md

References

Detailed Documentation

• {baseDir}/reference/services.md - детали всех сервисов, API endpoints, env vars
• {baseDir}/reference/troubleshooting.md - решения 13 типичных проблем
• {baseDir}/reference/advanced-ops.md - debug, scaling, profiling, testing

Related Skills

• cc1c-navigator - понимание архитектуры и зависимостей
• cc1c-test-runner - запуск тестов после изменений
• cc1c-sprint-guide - текущая фаза разработки

Slash Commands

• /dev-start - запустить все сервисы
• /check-health - проверить статус
• /restart-service <name> - перезапустить сервис
• /run-migrations - применить миграции Django

Project Documentation

• CLAUDE.md - главный контекст проекта
• LOCAL_DEVELOPMENT_GUIDE.md - полное руководство
• 1C_ADMINISTRATION_GUIDE.md - RAS/gRPC setup

---

Version: 3.0 (Optimized) Last Updated: 2025-11-06 Changelog:

• 3.0 (2025-11-06): Refactored to 220 lines, moved details to reference/ files
• 2.1 (2025-11-05): Add batch-service, ras-grpc-gw details, service dependencies
• 2.0 (2025-11-03): Complete rewrite for local development (host machine)