#Обновление

Alauda Cache Service for Redis OSS разработан так, чтобы обеспечивать непрерывность обслуживания и безопасность данных во всех поддерживаемых версиях. В этом руководстве описывается совместимость версий и рекомендуемые пути обновления, чтобы упростить беспроблемный переход вашей среды.

#Принципы совместимости версий

Alauda Cache Service for Redis OSS следует принципам семантического версионирования и предоставляет следующие гарантии совместимости:

• Patch-версии (x.y.z) полностью обратно- и прямосовместимы в пределах одной minor-ветки.
• Minor-версии (x.y.z) сохраняют совместимость API и функций в пределах одной major-версии.
• Major-версии (x.y.z) могут вносить breaking changes, для которых требуются специальные процедуры обновления.

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

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

1. Совместимость версий: текущая версия должна находиться на поддерживаемом пути обновления.
2. Состояние компонентов: все экземпляры Redis должны иметь статус Ready.
3. Доступность ресурсов: в кластере должно быть достаточно ресурсов CPU, memory и storage для выполнения обновления.
4. Резервная копия: должны быть доступны недавние backup-копии всех критически важных данных и конфигураций.

#Поддерживаемые пути обновления

Следующая матрица описывает протестированные комбинации версий и соответствующие зависимости:

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

#Обновление minor-версии

• Подход: поддерживается прямое обновление с любой minor-версии до более новой версии в пределах той же major-версии (например, 4.0.x → 4.1.0).
• Преимущества: этот подход минимизирует операционные риски и упрощает беспроблемный переход между версиями.

#Обновление patch-версии

• Совместимость: patch-версии полностью совместимы в пределах одной minor-ветки.
• Пример: обновление в пределах одной minor-ветки (например, x.y.0 → x.y.1) позволяет применить последние исправления ошибок и security-патчи.

#Обновление major-версии

• Требование: при обновлении между major-версиями (например, 4.1.0 → 5.0.0) выполняйте прямое обновление до последней доступной версии целевой major-ветки.
• Процедура: выполните описанные ниже шаги по обновлению operator, а затем обновите отдельные экземпляры согласно Руководству по обновлению экземпляра.
• Особенности: major-обновления могут потребовать изменения конфигурации и полного анализа совместимости функций.

#Шаги обновления

1. Загрузите целевую версию plugin Alauda Cache Service for Redis OSS из AlaudaCloud на узел, который имеет доступ к вашему кластеру ACP.
2. Используйте средство управления пакетами violet, чтобы загрузить plugin в целевой кластер. Подробные инструкции см. в документации Upload Packages.
3. Обновления выполняются в соответствии со стратегией, настроенной в Subscription:

   • Automatic Upgrade: plugin обновляется автоматически после загрузки.

   • Manual Upgrade:

     CLI

     Web Console

     # Check for available upgrades
     $ kubectl -n redis-system get subscriptions.operators.coreos.com redis-operator -o go-template='{{ printf "Installed: %s\n  Current: %s" .status.installedCSV .status.currentCSV }}'
     
     # If an upgrade is available, find the corresponding InstallPlan for the Subscription
     $ kubectl -n redis-system get subscriptions.operators.coreos.com redis-operator -o jsonpath='{.status.installplan.name}'
     
     # Approve the InstallPlan to proceed with the upgrade
     $ kubectl -n redis-system patch --type='json' -p='[{"op":"replace","path":"/spec/approved","value":true}]'

     • Войдите в web console и переключитесь в Administrator view.
     • Перейдите в Marketplace > OperatorHub > страницу сведений Alauda Cache Service for Redis OSS.
     • Нажмите ссылку Confirm в уведомлении New Version Detected, затем нажмите кнопку Confirm в последующем диалоге, чтобы подтвердить обновление.
     • Если уведомление New Version Detected не отображается, обновление недоступно.

     Более подробные инструкции по обновлению plugin см. в документации Operator.

4. Чтобы обновить сам экземпляр Redis, см. Руководство по обновлению экземпляра.