Обзор

Previous Next

Статус: Draft Дата: 2026-04-29 Роль: source of truth для ресурсов, topology, relationships, desired/observed state, health и provided capabilities.

1. Назначение

resource-catalog-service отвечает на вопрос "что у нас есть". Он хранит канонический каталог инфраструктурных и платформенных ресурсов, их связи, состояние и capabilities.

Сервис не исполняет долгие операции. Он не создает Kubernetes-кластер, не запускает Ansible, не делает Helm install и не принимает решения о retry/rollback. Для этого существует control-plane-service и execution-plane-service.

2. Граница ответственности

Владеет:

  • organizations / tenant context для platform resources;
  • topology: regions, datacenters, layers, segments;
  • compute nodes;
  • clusters;
  • internal/external services;
  • deployments;
  • managed resources: postgres, redis, tempo, minio, vault, kafka и другие;
  • resource relationships;
  • desired state и observed state ресурсов;
  • lifecycle status и health summary;
  • capability definitions;
  • provided capabilities;
  • read models для UI: resource graph, topology graph, capability graph.

Не владеет:

  • intents;
  • scenarios;
  • plans;
  • operations;
  • gates;
  • interventions;
  • PlanPatch;
  • execution attempts;
  • raw runner logs;
  • secrets.

3. Модули

1
2
3
4
5
resource-catalog-service/
  api
  worker
  observer
  projector

Подробно: Modules.

4. Основной data flow

flowchart TB UI[Web App] --> API[api] CP[control-plane-service] --> API OBS[observer] --> API KAFKA[(Kafka)] --> Worker[worker] Worker --> DB[(resource_catalog_db)] API --> DB OBS --> DB DB --> Projector[projector] Projector --> ReadModels[read models] API --> ReadModels

5. Инварианты

  1. Сервис является единственным владельцем resource metadata и provided capabilities.
  2. Сервис не владеет operation lifecycle.
  3. Сервис не исполняет side-effect jobs.
  4. Все изменения ресурсов должны быть versioned, чтобы команды от control-plane могли использовать optimistic concurrency.
  5. Observed state не должен перезаписывать desired state.
  6. Health summary должен ссылаться на evidence/operation references, если состояние пришло из control-plane.
  7. CapabilityDefinition является ресурсной онтологией и живет здесь.
  8. ProvidedCapability должен ссылаться на concrete resource.

6. Документы

Операции API