Траблшутинг обновления

Что проверять при сбоях обновления.

Стандартная процедура обновления описана на странице Как происходит обновление в открытом и закрытом контурах. Перед тем как искать сбой, убедитесь, что переход между версиями допустим: Карта версий обновлений. Политику выпуска и поддержку версий см. в релизной политике.

Новая версия не появляется в интерфейсе

  • Проверьте доступность Registry (r.shturval.tech) с узлов кластера.
  • Проверьте состояние модуля shturval-update и его зависимостей.

Если версия указана как доступная для перехода на карте версий, но в интерфейсе её нет после ожидания — сохраните вывод kubectl (см. ниже) и обратитесь в поддержку.

Обновление зависает

  • Определите на дашборде этап, который остаётся в состоянии выполнения (жёлтый): shturval-update, удаление устаревших сервисов, shturval-node-config, обновление Kubernetes или обновление системных сервисов платформы.
  • Если этап серый, он ещё не инициализирован или может быть пропущен; проверьте предыдущий жёлтый этап и логи соответствующего компонента.
  • Если этап долго остаётся жёлтым, нажмите на иконку этапа для получения более подробной информации о conditions сервиса или узлов. Если этой информации недостаточно, проверьте логи компонента этого этапа и связанных системных сервисов.
  • Проверьте сетевое подключение к Registry.

Проверка статуса обновления (kubectl)

При обновлении через GUI или автоматически статус можно проверить через kubectl:

# Список каналов обновления
kubectl get shturvalupdatechannel -A

# Детали канала
kubectl describe shturvalupdatechannel <имя> -n <неймспейс>

При зависании обновления зеркала перезапуск канала может помочь подхватить новую версию:

kubectl -n <неймспейс> rollout restart deployment shturval-update-channel