Траблшутинг обновления
Что проверять при сбоях обновления.
Раздел «Администратору платформы»: быстрый переход по подразделам
Стандартная процедура обновления описана на странице Как происходит обновление в открытом и закрытом контурах. Перед тем как искать сбой, убедитесь, что переход между версиями допустим: Карта версий обновлений. Политику выпуска и поддержку версий см. в релизной политике.
Новая версия не появляется в интерфейсе
- Проверьте доступность Registry (r.shturval.tech) с узлов кластера.
- Проверьте состояние модуля shturval-update и его зависимостей.
- Убедитесь, что зеркало содержит бандл новой версии; при необходимости следуйте Работа с зеркалом после инсталляции.
- Перезапустите ShturvalUpdateChannel (shturval-update) в кластере (шаг также описан в процессе обновления в закрытом контуре).
- Подождите 5–10 минут; при реконсиляции — до 6 часов.
Если версия указана как доступная для перехода на карте версий, но в интерфейсе её нет после ожидания — сохраните вывод 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