Провайдер Yandex Cloud (shturval-capy)

О сервисе

Параметр Значение
Название в интерфейсе Провайдер Yandex Cloud
Системное название (идентификатор) shturval-capy
Назначение в кластере Интеграция с Yandex Cloud: развёртывание виртуальных машин для узлов кластеров через Cluster API. Устанавливается в кластер управления.
Критический Нет
Публичный репозиторий Cluster API Provider Yandex Cloud
Зависимости shturval-capy-crds, shturval-capi-crds
Неймспейс capy-system

Назначение

shturval-capy — провайдер Yandex Cloud для Cluster API. Обеспечивает создание и управление виртуальными машинами в Yandex Cloud для использования в качестве узлов кластеров Kubernetes.

Установка сервиса

shturval-capy — инфраструктурный провайдер Cluster API для Yandex Cloud. В платформе «Штурвал» подключение и жизненный цикл такого провайдера в управляющем кластере обеспечивает cluster-manager; объекты ShturvalServiceConfig (SSC) для чартов провайдера создаются и сопровождаются как часть платформенной конфигурации, а не как произвольная ручная установка сервисного чарта.

В рабочей среде провайдер представлен двумя SSC:

  • shturval-capy — основной чарт провайдера Yandex Cloud;
  • shturval-capy-crds — чарт CRD модуля провайдера Yandex Cloud.

Для корректной работы в кластере управления должны быть доступны CRD основного Cluster API (shturval-capi-crds и связанный с ним компонент shturval-capi).

Если при развёртывании платформы работа сервиса была отключена, SSC провайдера могли получить режим отсутствия (mode: absent). Чтобы провайдер был доступен для работы с облаком, переведите сначала режим shturval-capy-crds в auto, затем shturval-capy в auto. Изменить режим можно в интерфейсе: на вкладке Платформа в карточке Провайдеры инфраструктуры нажмите Управлять, затем в блоке Сервисы провайдеров переведите переключатель.

Скриншот: вкладка «Платформа» — переход в конфигурацию провайдеров

Вкладка Платформа: карточка Провайдеры инфраструктуры и ссылка Управлять

На скриншоте показан выбор режима Авто для сервиса провайдера (см. скриншот ниже).

Переключение режима сервиса провайдера

Параметры customvalues

Структура значений основного чарта описывается полем spec.customvalues у соответствующего ShturvalServiceConfig и совпадает с helm/main/values.yaml чарта shturval-capy.

Рекомендация: не правьте объект ShturvalServiceConfig вручную для смены лимитов, nodeSelector, параметров подключения к облаку и прочих настроек релиза — такой объект относится к платформенной конфигурации и может быть перезаписан при обновлениях. Все изменения поведения сервиса вносите через ShturvalServicePatch (SSP), накладывающий spec.customvalues поверх базового SSC.

Где настраивать

Сервисы и репозитории → Установленные сервисы → shturval-capy → Управлять. Сервис размещается в кластере управления.

Чтобы включить сервис и настроить экземпляр: вкладка Платформа → карточка Провайдеры инфраструктуры → Управлять. Подробнее — Yandex Cloud. Общий обзор — Как устроена работа с провайдерами в платформе.

Справочно: инфраструктурные CR Yandex Cloud см. в разделе Кастомные ресурсы жизненного цикла узлов — Yandex Cloud.