VK Dev Platform logo
Помощь
Обновлена 30 июля 2024 г. в 07:24

Интеграция с Private Cloud

Направление интеграции: VK Dev Platform — Private Cloud

VK Dev Platform развёртывается в облачном проекте в единственном экземпляре.

В таблице 1 приведён список интеграций VK Dev Platform с Private Cloud.

В столбце «Проект облака» отражены два вида интеграций:

  • Dev Platform — доступы к сервисам в проекте развёртывания.
  • Пользователь — интеграции для обеспечения работы пользователей VK Dev Platform.
Таблица 1 — Интеграция VK Dev Platform с Private Cloud

Компонент/Сервис

Компонент VK Dev Platform

Проект Облака

Учётная запись

Функциональность

Примечание

Keycloak

Shepherd

Dev Platform

shepherd

Аутентификация:

  • POST /realms/dev-platform/protocol/openid-connect/token.

Создание клиентов для SSO компонент Dev Platform:

  • GET, POST, PUT /admin/realms/dev-platform/clients.

Создание admin пользователей для Nexus, Grafana:

  • GET, POST, PUT /admin/realms/dev-platform/users.
  • GET, POST, PUT /admin/realms/dev-platform/roles

Создается отдельный Realm. Учётная запись используется для доступа к нему. Необходимы следующие realm роли:

  • view-clients.
  • manage-clients.
  • create-client.
  • query-clients.
  • view-users.
  • manage-users

sundog (3.1) или auth-service (4.0)

Dev Platform

Настраивается как Identity Provider в dev-platform realm в Keycloak ЧО

Keystone

Front/App

Пользователь

Учётная запись пользователя

Аутентификация и получение списка проектов:

  • GET /v3/OS-FEDERATION/identity_providers/idp_mcs/protocols/oidc/auth.
  • POST /v3/auth/tokens.
  • GET /v3/auth/projects.

Используются cookie, установленные для домена облака. Поэтому VK Dev Platform должна быть развёрнута в поддомене облака

Samsara

Пользователь

Аутентификация под сервисной учётной записью:

  • POST /v3/auth/tokens.

Получение информации о проекте:

  • GET /v3/auth/projects.
  • GET /v3/auth/domains

Shepherd

Dev Platform

Аутентификация под сервисной учётной записью:

  • POST /v3/auth/tokens

Авторизация для настройки notifications channels и triggers в Private Cloud Logging

telegraf

Dev Platform

Аутентификация под сервисной учётной записью:

  • POST /v3/auth/tokens

Авторизация для отправки метрик по metrics-server-grpc-api

erebor-grafana-proxy

Dev Platform

Аутентификация под сервисной учётной записью:

  • POST /v3/auth/tokens

Авторизация для получения метрик по erebor api

Nova

Samsara

Пользователь

Получение статуса ВМ:

  • GET /servers.
  • GET /servers/details

Magnum

Front/App

Пользователь

Учётная запись пользователя

Получение списка кластеров Kubernetes:

  • GET /v1/clusters/detail

Используются cookie, установленные для домена облака. Поэтому VK Dev Platform должна быть развёрнута в поддомене облака

Samsara

Пользователь

Получение информации о кластере Kubernetes (проверка наличия и получения статуса кластера):

  • GET /v1/clusters/{cluster_id}.
  • GET /v1/clusters/{cluster_id}/details

HOE (Image based deployment)

Samsara

Пользователь

Загрузка, получение и удаление terraform скрипта:

  • POST, GET, DELETE /v1/hoe/config.

Создание terraform плана:

  • POST /v1/hoe/object-dryrun.

Запуск terraform скрипта:

  • POST /v1/hoe/object.

Получение terraform state:

  • GET /v1/hoe/object/state

Используется для создания, обновления и удаления ресурсов в выбранном пользователем проекте

Cloud Logging

Dev Platform

Cloud Monitoring

telegraf

Dev Platform

Отправка метрик по metrics-server-grpc-api:

  • /monitoring/v1

shepherd

Dev Platform

Настройка каналов оповещения:

  • GET, POST, PATCH /alerting/v1/{project_id}/notification_channels.

Настройка триггеров:

  • GET, POST, PATCH /alerting/v1/{project_id}/triggers

erebor-grafana-proxy

Dev Platform

Получение метрик по erebor api

Cloud Audit

Dev Platform

Направление интеграции: Private Cloud — VK Dev Platform

Таблица 2 — Интеграция Private Cloud с VK Dev Platform

Компонент/Сервис

Компонент VK Dev Platform

Учётная запись

Функциональность

Примечание

Личный кабинет

Front/App

Перенаправление пользователя со страницы личного кабинета облака в VK Dev Platform

IAM

S2S API

Активация сервиса VK Dev Platform в облачном проекте