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

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

Закрытый контур:

• Убедитесь, что новая версия загружена в зеркало (образы и манифесты целевой версии доступны в закрытом репозитории);
• Проверьте доступность перехода с исходной версии на целевую: не все переходы поддерживаются напрямую, может потребоваться промежуточная версия. См. Переходы между версиями и Карта версий обновлений;
• Перезапустите ShturvalUpdateChannel (shturval-update) в кластере;
• Подождите 5–10 минут; при реконсиляции — до 6 часов.

Открытый контур:

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

Обновление зависает или откатывается #

• Проверьте логи модуля обновления и системных сервисов;
• Убедитесь, что достаточно ресурсов (CPU, RAM, диск) на узлах;
• Проверьте сетевое подключение к Registry;
• При необходимости откатитесь на предыдущую версию и обратитесь в поддержку.

Обновление остановилось (зависло в одном статусе более 1 часа) #

Если обновление не меняет статус больше часа:

1. Проверьте логи подов shturval-node-config — модуль применяет новую версию Kubernetes на узлах; ошибки при обновлении kubelet или конфигурации узлов часто видны в его логах. В GUI: Сервисы и репозитории → Установленные сервисы → Модуль управления конфигурациями узлов (shturval-node-config) → поды → логи. Через kubectl: kubectl logs -n <неймспейс> -l app.kubernetes.io/name=shturval-node-config -c <контейнер> --tail=200.
2. Проверьте состояние подов системных сервисов — убедитесь, что поды shturval-update, shturval-node-config, shturval-backend и других критичных сервисов в состоянии Running и Ready; при падении или перезапусках изучите события и логи подов.

Проверка статуса через kubectl #

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

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

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

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

Ошибки после обновления #

• Сверьтесь с release notes целевой версии на предмет известных проблем;
• Проверьте, что все системные сервисы в состоянии Ready;
• При проблемах с конкретным сервисом — переустановите или обновите его через раздел Сервисы и репозитории.

Поддержка #

При возникновении трудностей в процессе обновления можно обратиться к команде разработки платформы «Штурвал». С вкладки «О системе» графического интерфейса перейдите в сервис-деск и оставьте заявку на поддержку.

Подробнее о траблшутинге обновления платформы — Траблшутинг обновления в разделе администратора платформы.