Alauda Build of Keycloak
  • Русский

    • Обновление

    NOTE

    В этом документе изложены принципы пути обновления и поддерживаемая совместимость версий для Alauda Build of Keycloak.

    Содержание

    Матрица совместимостиПредварительные требованияРекомендации по пути обновленияПоследовательное обновление (рекомендуется)Обновление патчейПроцедура обновленияСтратегия обновления

    Матрица совместимости

    В таблице ниже перечислены поддерживаемые версии Alauda Build of Keycloak и его ключевых компонентов. Для ознакомления с изменениями, новыми функциями и устареваниями по конкретным версиям смотрите Release Notes.

    Версия Alauda Build of KeycloakВерсия KeycloakВерсия Kubernetes
    v26.4.7-2026012111381126.4.71.25+

    Предварительные требования

    Перед началом обновления убедитесь в следующем:

    1. Совместимость версий: Ваша текущая версия входит в поддерживаемый путь обновления.
    2. Состояние экземпляров: Все экземпляры Keycloak находятся в состоянии Ready.
    3. Резервное копирование базы данных: Создайте резервную копию базы данных PostgreSQL перед продолжением.
    4. Доступность ресурсов: В кластере достаточно ресурсов для поддержки процесса обновления.

    Проверьте состояние всех экземпляров Keycloak:

    kubectl get keycloak -A -o custom-columns="NAME:.metadata.name,NAMESPACE:.metadata.namespace,READY:.status.conditions[?(@.type=='Ready')].status"

    Рекомендации по пути обновления

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

    Обновляйтесь пошагово через последовательные версии для обеспечения совместимости.

    Обновление патчей

    Обновления между патч-версиями в рамках одной минорной версии полностью совместимы и могут выполняться напрямую без дополнительных миграционных шагов.

    Откат после обновления невозможен

    После того как Operator выполнит обновление и применит миграции схемы базы данных, откат к предыдущей версии Keycloak не поддерживается. Схема базы данных обновляется в процессе обновления и не совместима с предыдущими версиями. Всегда создавайте резервную копию базы данных PostgreSQL перед обновлением.

    Процедура обновления

    Веб-консоль
    CLI
    1. Войдите в платформу и перейдите на страницу Platform Management.
    2. В левой навигационной панели выберите Marketplace > Cluster Plugins.
    3. Найдите Alauda Build of Keycloak и нажмите Upgrade.
    4. Выберите целевую версию и подтвердите обновление.
    5. Отслеживайте состояние Pod оператора до возвращения в состояние Running.
    6. Убедитесь, что все экземпляры Keycloak вернулись в состояние Ready.

    Стратегия обновления

    Alauda Build of Keycloak выполняет обновления на основе настроенной стратегии обновления в подписке оператора:

    • Automatic: Автообновления запускаются сразу после обнаружения новой версии оператора в канале. Не рекомендуется для продакшена — автоматические обновления обходят ручную проверку release notes и изменений миграции базы данных.
    • Manual: Требуется ручное подтверждение перед началом процесса обновления. Это рекомендуемая стратегия для производственных сред.