Модуль обновления кластера (shturval-update)

О сервисе #

Содержание #

1. Обзор
2. Архитектура
3. Установка / развёртывание
4. Диагностика
5. Жизненный цикл
6. Параметры оператора
7. Справочник CRD/API

1. Обзор #

Назначение: оператор shturval-update выполняет обновление платформы Shturval до версии, указанной в ShturvalUpdate.spec.version, проверяет доступность версий через канал обновлений и может запускать обновление по cron-расписанию.

Функции #

Сценарии инициации #

Ограничения и следствия #

Место в цепочке управления #

Цепочка управления обновлением #

В эксплуатационной цепочке администратор или автоматизация задаёт целевую версию через ShturvalUpdate. ShturvalUpdateChannel предварительно наполняет список доступных версий из registry. Если используется расписание, ShturvalUpdateSchedule выбирает подходящую версию из статуса channel-ресурса и патчит дефолтный update-ресурс. После этого ShturvalUpdate выполняет фазы обновления и отражает ход процесса в status.ready и status.conditions.

Ключевые характеристики #

Контроллеры #

2. Архитектура #

Компоненты рабочей нагрузки #

Архитектура развёртывания #

Диаграмма показывает, что поставка через Helm/Kustomize создаёт Deployment контроллера, RBAC, webhook, cert-manager и prometheus resources. Внутри manager регистрируются три reconciler-а и webhook для ShturvalUpdate; reconciler-ы работают с Kubernetes API и обращаются к внешнему update registry для получения матрицы обновлений.

Взаимодействие с внешними системами #

Связи ресурсов обновления #

Доступ к дочерним кластерам #

Если фаза обновления обращается к дочернему кластеру, оператор ожидает Secret с kubeconfig:

apiVersion: v1
kind: Secret
metadata:
  name: <clusterId>-kubeconfig
  namespace: <clusterId>
type: Opaque
stringData:
  value: |
    apiVersion: v1
    kind: Config
    clusters:
    - name: <cluster>
      cluster:
        server: https://<api-server>
        certificate-authority-data: <base64-ca>
    contexts:
    - name: <cluster>
      context:
        cluster: <cluster>
        user: <user>
    current-context: <cluster>
    users:
    - name: <user>
      user:
        token: <token>    

SSH-ключи и passphrase-protected SSH keys этим контуром не читаются: для доступа используется kubeconfig из ключа value.

3. Установка / развёртывание #

Поставка включает два Helm-чарта: shturval-update-crds для CRD и shturval-update для контроллера. Установка должна сначала доставить CRD, затем основной chart с Deployment, RBAC, webhook и сопутствующими объектами.

Обратите внимание! любые изменения параметров установки должны выполняться согласованно с платформой через ShturvalServicePatch (SSP) или другой утверждённый механизм управления сервисами, без ручных правок в обход платформенного lifecycle.

Минимальный порядок установки #

4. Диагностика #

Диагностика строится по status-полям CR и conditions. В исходном техническом руководстве нет готового набора эксплуатационных kubectl get/logs команд, поэтому команды проверки здесь не дублируются.

Общие симптомы #

Conditions ShturvalUpdate #

Conditions ShturvalUpdateChannel #

У ShturvalUpdateChannel отдельные conditions не определены. Для диагностики используются поля status.ready, status.currentversion, status.lastchecked и status.availableupdates.

Conditions ShturvalUpdateSchedule #

5. Жизненный цикл #

Сквозной жизненный цикл обновления #

Обновление через ShturvalUpdate #

Finalizer: update.shturval.tech/finalizer. При удалении оператор снимает finalizer и завершает reconcile.

Reconcile ShturvalUpdate #

Проверка канала обновлений #

Finalizer: update.shturval.tech/finalizer. При удалении channel-ресурса оператор снимает finalizer.

Reconcile ShturvalUpdateChannel #

Плановое обновление #

При удалении ShturvalUpdateSchedule оператор запрещает удаление, если дефолтный ShturvalUpdate.spec.followSchedule указывает на удаляемое расписание; иначе снимает finalizer.

Reconcile ShturvalUpdateSchedule #

Протокол согласования ресурсов #

6. Параметры оператора #

Флаги процесса #

Переменные окружения #

7. Справочник CRD/API #

API group/version для всех ресурсов: update.shturval.tech/v1beta1.

ShturvalUpdate (su, shup, shupdate) — Namespaced #

Conditions ShturvalUpdate перечислены в разделе Диагностика.

ShturvalUpdateChannel (suc, shupch, shupdatechannel) — Namespaced #

Conditions у ShturvalUpdateChannel не определены.

ShturvalUpdateSchedule — Namespaced #

ShortName marker для ShturvalUpdateSchedule отсутствует. #ВОПРОС: нужен ли короткий alias для kubectl.

Conditions ShturvalUpdateSchedule перечислены в разделе Диагностика.

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

Сервисы и репозитории → Установленные сервисы → shturval-update → Управлять. Подробнее — Обновление Kubernetes.