• Русский
  • Обновление

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

    Советы по обновлению

    Перед обновлением производственной среды настоятельно рекомендуется проверить процесс обновления в среде разработки или staging. Этот предварительный шаг помогает выявить и устранить потенциальные проблемы совместимости, включая конфликты, связанные с оборудованием, до того, как они повлияют на production-сервисы.

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

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

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

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

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

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

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

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

    Версия Alauda Cache Service for Redis OSSВерсии Redis ServerВерсия ACP
    v5.0.16.0.21, 7.2.14, 8.4.3v4.1, v4.2, v4.3
    v5.0.06.0.21, 7.2.12, 8.4.2v4.1, v4.2, v4.3
    v4.1.x5.0.14, 6.0.20, 7.2.10v4.1, v4.2
    v4.0.x5.0.14, 6.0.20, 7.2.xv4.0
    Совместимость с ACP v4.3

    Alauda Cache Service for Redis OSS v4.1.x и v4.0.x не тестировались с ACP v4.3. Перед обновлением до ACP v4.3 сначала обновите Alauda Cache Service for Redis OSS до v5.0.0 или более поздней версии.

    Обновите экземпляры Redis 5.0 перед обновлением до ACP v4.3

    Обновление оператора Alauda Cache Service for Redis OSS не выполняет автоматическое обновление версии Redis у существующих экземпляров; версию Redis каждого экземпляра необходимо обновлять явно.

    Поскольку для ACP v4.3 требуется Alauda Cache Service for Redis OSS v5.0.x, а v5.0.x больше не поддерживает Redis 5.0, перед обновлением с версии ACP ниже v4.3 до v4.3 необходимо сначала обновить каждый экземпляр Redis 5.0 до поддерживаемой версии (6.0, 7.2 или 8.4).

    Перед началом обновления ACP убедитесь, что в столбце VERSION ни у одного экземпляра не указано 5.0 (например, выполните kubectl get redis -A). Процедуру обновления см. в Руководстве по обновлению экземпляра.

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

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

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

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

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

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

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

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

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

      • 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}]'

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

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