既存の Redis 4 キャッシュを Redis 6 にアップグレードする方法

  • [アーティクル]

Azure Cache for Redis では、Azure Cache for Redis の Redis 4 から Redis 6 へのバージョンのアップグレードをサポートしています。 アップグレードは、毎月の定期メンテナンスに似ています。 アップグレードはメンテナンスと同じパターンで行われます。まず、レプリカ ノードの Redis バージョンが更新され、その後プライマリ ノードが更新されます。 クライアント アプリケーションでは、アップグレード操作を計画メンテナンス イベントとまったく同じように処理する必要があります。

予防の手順として、アップグレードする前に、既存の Redis 4 キャッシュからデータをエクスポートし、より低い環境で Redis 6 キャッシュを使用してクライアント アプリケーションをテストすることをお勧めします。

エクスポート方法の詳細については、「Azure Cache for Redis でデータをインポートまたはエクスポートする」を参照してください。

重要

新機能で発表したように、2023 年 6 月 30 日に Azure Cache for Redis インスタンスのバージョン 4 を廃止します。 その日付より前に、キャッシュ インスタンスをすべてバージョン 6 にアップグレードする必要があります。

Redis 4 の廃止の詳細については、「廃止」とよく寄せられる質問に関するページを参照してください。

前提条件

制限事項

  • Basic レベルでキャッシュをアップグレードすると、数分間利用できなくなり、データ損失が発生します。
  • geo レプリケートされたキャッシュでのアップグレードはサポートされていません。 アップグレードする前に、キャッシュ インスタンスのリンクを手動で解除する必要があります。
  • Cloud Services に依存するキャッシュのアップグレードはサポートされていません。 アップグレードする前に、キャッシュ インスタンスを仮想マシン スケール セットに移行する必要があります。
  • Redis 6 にアップグレードする場合は、要件に従って VNet を構成する必要があります。 アップグレードが正しく構成されていない場合は、アップグレードが失敗するか、アップグレード後にキャッシュが正しく機能しない可能性があります。

キャッシュのバージョンを確認する

アップグレードする前に、Azure Cache for Redis の [リソース] メニューから [プロパティ] を選択して、キャッシュの Redis のバージョンを確認します。 代わりに Redis 6 を使うことをお勧めします。

Screenshot of properties selected in the Resource menu.

Azure portal を使用したアップグレード

  1. Azure portal で、Redis 4 から Redis 6 にアップグレードする Azure Cache for Redis インスタンスを選択します。

  2. 画面の左側で、[詳細設定] を選択します。

  3. キャッシュ インスタンスがアップグレードに適格である場合は、次の青いバナーが表示されます。 続行する場合は、バナー内のテキストを選択します。

    Screenshot informing you that you can upgrade your cache to Redis 6 with more features. Upgrading your cache instance can't be reversed.

  4. アップグレードは永続的で、接続が一時的に切断される可能性があることを通知するポップアップがダイアログ ボックスに表示されます。 キャッシュ インスタンスをアップグレードする場合は、[はい] を選択します。

    Screenshot showing a dialog with more information about upgrading your cache with Yes selected.

  5. アップグレードの状態を確認するには、 [概要] に移動します。

    Screenshot showing Overview in the Resource menu. Status shows cache is being upgraded.

Azure CLI を使用したアップグレード

プライベート エンドポイントを使用していない Azure CLI を使用してキャッシュを 4 から 6 にアップグレードするには、次のコマンドを使用します。

az redis update --name cacheName --resource-group resourceGroupName --set redisVersion=6

プライベート エンドポイント

キャッシュでプライベート エンドポイントが有効になっている場合は、PublicNetworkAccess が有効か無効かに基づいて適切なコマンドを使用します。

PublicNetworkAccess が有効な場合:

 az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Enabled redisVersion=6

PublicNetworkAccess が無効な場合:

az redis update --name <cacheName> --resource-group <resourceGroupName> --set publicNetworkAccess=Disabled redisVersion=6

PowerShell を使用したアップグレード

PowerShell を使用してキャッシュを 4 から 6 にアップグレードするには、次のコマンドを使用します。

Set-AzRedisCache -Name "CacheName" -ResourceGroupName "ResourceGroupName" -RedisVersion "6"

次のステップ