Как начать разработку

Previous Next

Руководство для новых разработчиков по запуску проекта AIOps локально.

Шаг 1: Клонировать репозиторий

1
2
git clone https://gitlab.com/ai-operations/ai-ops.git
cd ai-ops

Шаг 2: Установить зависимости

Python (сервисы)

Мы используем uv для управления Python зависимостями:

1
2
3
4
5
6
# Установить uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Установить зависимости для сервиса
cd services/auth/identity-service
uv sync

Go (API Gateway)

1
2
cd services/api-gateway
go mod download

Инфраструктура

Для локальной разработки нужны: - Docker и Docker Compose - Kubernetes (minikube или kind) - kubectl, helm

Шаг 3: Настроить окружение

Подробная инструкция: Local Setup

Базовые сервисы через Docker Compose

1
2
3
# Запустить PostgreSQL, Redis, Kafka локально
cd infra/local
docker-compose up -d

База данных

1
2
3
# Применить миграции для Identity service
cd services/auth/identity-service
uv run alembic upgrade head

Шаг 4: Запустить сервис

Identity service (пример)

1
2
3
4
5
6
7
cd services/auth/identity-service

# Запустить API
uv run python -m identity_service.api

# В другом терминале запустить Worker (outbox)
uv run python -m identity_service.worker

Шаг 5: Проверить

1
2
3
4
5
# Health check
grpcurl -plaintext localhost:50051 grpc.health.v1.Health/Check

# Reflection (список методов)
grpcurl -plaintext localhost:50051 list

Структура репозитория

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
ai-ops/
├── services/           # Микросервисы
│   ├── auth-platform/  # Auth services
│   │   ├── identity-service/
│   │   ├── credential-service/
│   │   └── ...
│   └── api-gateway/    # API Gateway (Go)
├── libs/               # Shared libraries
│   └── python/
│       ├── common/           # contracts, context, observability, utils
│       ├── communication/    # grpc, kafka, asgi, integration clients
│       ├── storage/          # postgres, redis, uow, outbox
│       └── runtime/          # api runtimes, dishka, warmup, workers
├── proto/              # Protocol Buffers
│   └── aiops/
│       ├── identity/v1/
│       └── credential/v1/
├── infra/              # Infrastructure
│   ├── k8s/            # Kubernetes manifests
│   └── local/          # Docker Compose для локалки
└── docs/               # Документация

Полезные команды

Тестирование

1
2
3
4
5
# Unit tests
uv run pytest tests/unit

# Integration tests (требует testcontainers)
uv run pytest tests/integration

Линтеры

1
2
3
4
5
6
# Ruff (linting + formatting)
uv run ruff check .
uv run ruff format .

# MyPy (type checking)
uv run mypy src/

Proto generation

1
2
# Перегенерировать Python protobuf stubs (из корня репозитория)
make -C scripts/tools proto-python-compile

Следующие шаги

Частые проблемы

PostgreSQL connection refused

Проверьте, что PostgreSQL запущен: 

1
docker ps | grep postgres

Kafka not available

Подождите ~30 секунд после docker-compose up — Kafka долго стартует.

Import errors в Python

Убедитесь, что используете правильную виртуальную среду uv: 

1
uv run python -c "import identity_service; print('OK')"

Связанные страницы

Быстрые ссылки Как найти нужный сервис