Azure フレキシブル サーバ PostgreSQL を使用するためのアップグレード - 第 1 世代 Horizon Cloud ポッド

このページでは、Azure フレキシブル サーバ PostgreSQL に関連する Horizon Cloud ポッドのアップグレードに関する重要な事項について説明します。このページでは、Azure フレキシブル サーバ PostgreSQL の使用を含むポッドのアップグレードに対して第 1 世代テナントが有効になっている場合の前提条件と必要な手順についても説明します。

この機能を使用するには、Horizon Cloud オペレーション チームが第 1 世代テナントを明示的に有効にする必要があります。

概要

2024 年 9 月より前にデプロイおよびアップグレードされた Horizon Cloud ポッドは、Microsoft Azure 単一サーバ PostgreSQL サービスを使用してデプロイされます。

2024 年 9 月以降、テナントで Microsoft Azure フレキシブル サーバ PostgreSQL サービスの使用が有効になっている場合、ポッドがアップグレードされると、ポッドは代わりに Microsoft Azure フレキシブル サーバ PostgreSQL サービスを使用します。

次の図は、アップグレード後のポッドのアーキテクチャを示しています。この図とアップグレード前のポッドの図の違いは、 Database Network というラベルのサブネットです。このサブネットは、Azure フレキシブル サーバ PostgreSQL データベース サービスへの接続に必要です。このデータベース サブネットの詳細については、次のセクションを参照してください。

ポッドのマニフェスト情報

この機能を有効にしているお客様へのリリース ビークルは Omnissa Horizon Cloud on Microsoft Azure 2408 という名前で、以下が含まれます。

• ポッド マニフェスト 5041.x。このマニフェストには、上記の機能のサポートと、プラットフォーム コードの改善が含まれています (通常はリリースされたマニフェストに含まれています)。
• マニフェストと互換性のあるバージョンの Horizon Agents Installer (HAI) 24.2.0。
• 特にドキュメントに記載されていない限り、この HAI バージョンはマニフェスト 5041.x に組み込まれています。5041.x のポッドで [仮想マシンのインポート] ウィザードを実行すると、この HAI バージョンからエージェントがインストールされます。この HAI バージョンは、マニフェスト 5041.x のポッド内のインポート済み仮想マシンの手動インストールでもサポートされています。

Azure フレキシブル サーバ PostgreSQL 機能に対して明示的に有効になっているユーザーのみが、このリリースのビークルとポッド マニフェストにアクセスできます。

前提条件

テナントでこの機能を使用できる場合は、ポッドをアップグレードする前に、次の前提条件を満たす必要があります。

• ポッドの Azure サブスクリプションで、この機能を使用するためにアップグレードするポッドごとに CIDR /28 のサブネットを作成し、サブネットのプロパティで Microsoft.Storage エンドポイントを選択し、サブネット委任 を Microsoft.DBforPosgreSQL/flexibleServers に設定します。Azure フレキシブル サーバ PostgreSQL データベース サービスは、ポッドの管理サブネットを使用する代わりに、このサブネットを使用します。上記のアーキテクチャ図では、この新しいサブネットに Database Network というラベルが付けられています。このサブネットは、ポッドの VNet または別の VNet に配置できます。

• ポッドのサービス プリンシパルがカスタム ロールを使用している場合は、そのカスタム ロールに Microsoft.Network/privateDnsZones/virtualNetworkLinks/read および Microsoft.Network/privateDnsZones/read

• Azure IP 168.63.129.16 を IP フォワーダまたは条件付きフォワーダとして DNS サーバに追加します。この前提条件は、DNS サーバが Azure プライベート DNS ゾーンを解決することを提供します。これは、次の項目で説明するように、このポッド マニフェストの要件です。

• Azure ポータルを使用して、この機能を使用するためにアップグレードするポッドごとに、次の特性を持つプライベート DNS ゾーンを作成します。

  • プライベート DNS ゾーンの名前は、ポッドのデプロイ場所に応じて次のパターンにする必要があります。

    • Azure Commercial Cloud に展開: name.postgres.database.azure.com。name は選択した名前です(例: hcspod1.postgres.database.azure.com)。ポッドのサブスクリプションが Azure Commercial Cloud にある場合、プライベート DNS ゾーン名は、Horizon Universal Console の検証およびポッドのアップグレード プロセスを満たすためにパターン *.postgres.database.azure.com である必要があります。

    • Azure Gov Cloud にデプロイ: name.postgres.database.usgovcloudapi.net。ここで、name は選択した名前です(例: hcspod1.postgres.database.usgovcloudapi.net)。ポッドのサブスクリプションが Azure Commercial Cloud にある場合、プライベート DNS ゾーン名は、Horizon Universal Console の検証およびポッドのアップグレード プロセスを満たすためにパターン *.postgres.database.usgovcloudapi.net である必要があります。

  • プライベート DNS ゾーンで、前提条件の Database Network サブネットを持つ VNet を指す仮想ネットワーク リンクを作成します(上記の最初の前提条件で作成)。
  • プライベート DNS ゾーンのレコード セットに、タイプ A のプレースホルダ レコード セット(たとえば hcs-pgflex-test という名前で、IP アドレスが 0.0.0.0)を追加します。このプレースホルダは、アップグレード プロセスが開始される前に、事前検証チェックで使用されます。
  • プライベート DNS ゾーンの プロパティ セクションから、プライベート DNS ゾーンの リソース ID をコピーします。このリソース ID を Horizon Universal Console の [ポッドの編集] フローに入力し、アップグレード前にポッドの詳細に値を保存します。

• DNS サーバが別の VNet にある場合は、プライベート DNS ゾーンに仮想ネットワーク リンクを作成して、その DNS サーバを指すようにする必要もあります。複数の DNS サーバがあり、それらが異なる VNet に属している場合は、これらの VNet ごとに仮想ネットワーク リンクを作成します。

必要なデータベース ネットワーク サブネットの追加

CIDR /28 の Database Network に使用するサブネットを作成し、サブネットのプロパティで Microsoft.Storage エンドポイントを選択し、サブネット委任を Microsoft.DBforPosgreSQL/flexibleServers として設定します。

前提条件の設定を使用したプライベート DNS ゾーンの作成

次のスクリーンショットは、プライベート DNS ゾーンを作成するための Azure ポータルのウィザードを示しています。これらのスクリーンショットでは、選択したリソース グループはポッドの VNet と同じリソース グループであり、入力した名前は [ hcspod1.postgres.database.azure.com] です。プライベート DNS ゾーンを独自のリソース グループに作成することもできます。

メモ: Azure ポータルには、 azure.com が Azure インフラストラクチャ ドメインであることに関連するメッセージが表示されることがあります。このメッセージは無視してかまいません。Azure フレキシブル サーバ PostgreSQL サービスには、プライベート DNS ゾーンの使用が Microsoft によって推奨されています。

ポータルにプライベート DNS ゾーンが作成されたことが示されたら、そのプライベート DNS ゾーンに移動し、次の条件を満たします。

仮想ネットワーク リンクの作成

プライベート DNS ゾーンで、前提条件の Database Network サブネットを持つ VNet を指す仮想ネットワーク リンクを作成します(上記の最初の前提条件で作成)。ウィザードはリンク名を要求します。次のスクリーンショットは、名前が hcspod1-vnetlink で適切な VNet が選択されたリンクの作成を示しています。作成 をクリックして、リンクの追加を完了します。

メモ: DNS サーバが別の VNet にある場合は、プライベート DNS ゾーンに仮想ネットワーク リンクを作成して、その DNS サーバを指すようにする必要もあります。複数の DNS サーバがあり、これらの DNS サーバが異なる VNet に属している場合は、各 DNS サーバに仮想ネットワーク リンクを作成します。

プレースホルダ レコード セットの追加

プライベート DNS ゾーンのレコード セットに、タイプ A のプレースホルダ レコード セット(たとえば hcs-pgflex-test という名前で、IP アドレスが 0.0.0.0)を追加します。このプレースホルダは、アップグレード プロセスが開始される前に、事前検証チェックで使用されます。次のスクリーンショットは、このプレースホルダ レコード セットの作成を示しています。

プライベート DNS ゾーンのリソース ID をコピーします

プライベート DNS ゾーンの プロパティ セクションから、プライベート DNS ゾーンの リソース ID をコピーします。アップグレード準備フローでこのリソース ID を Horizon Universal Console に入力し、アップグレード前にポッドの詳細に値を保存します。

このリソース ID は、 /subscriptions/UUID/resourceGroups/パターン resourcegroup-name/providers/Microsoft.Network/privateDnsZones/name.postgres.database.azure.com の長い文字列になります。ここで、 UUID はプライベート DNS ゾーンのサブスクリプションの UUID、 resourcegroup-name はプライベート DNS ゾーンのリソース グループ、 name.postgres.database.azure.com はプライベート DNS ゾーンの名前です。

ポッドのアップグレードを実行する前に、必要な情報をポッドの詳細に追加します

フレキシブル サーバ PostgreSQL を使用するようにポッドをアップグレードする前に、データベース ネットワーク サブネットとプライベート DNS ゾーンに関する情報をそのポッドの詳細に追加する必要があります。

ユーザー インターフェイス フローは、次のバナーの アップグレード ボタンから始まります。Horizon Cloud Operations がテナントでこの機能を有効にすると、次のスクリーンショットに示すように、第 1 世代の Horizon Universal Console に PostgreSQL フレキシブル サーバへのアップグレードに関するバナーが表示されます。

1. バナーの [アップグレード ] ボタンをクリックして、データベース ネットワーク サブネットとプライベート DNS ゾーンに関する必要な情報をポッドの詳細に追加するユーザー インターフェイス フローを開始します。

コンソールには、前提条件を説明するボックスが表示され、テナントの Horizon Cloud ポッドが一覧表示されます。ステータス列は、前提条件情報がそのポッドの詳細に追加されているかどうかを示します。

2. ポッドの 編集 をクリックします。[ポッドの編集] ウィザードが起動します。

3. ウィザードで、ポッドの詳細 の手順に移動します。その手順で、[ データベース ] セクションが表示されるまでスクロールします。このセクションでは、前提条件のサブネットを選択し、Azure ポータルからコピーしたプライベート DNS ゾーンのリソース ID を貼り付けます。

この最初のスクリーンショットは データベース セクションを示し、2 番目のスクリーンショットは値が指定されたセクションを示しています。

4. 保存して終了 をクリックして、ポッドの詳細にデータを保存します。

ウィザードを終了した後、バナーの アップグレード ボタンをクリックしてダイアログ ボックスを再度開くと、ボックスにはポッドのステータスが Complete と表示されるようになりました。

ステータスが Complete と表示されているポッドは、アップグレードすることができます。

Horizon Cloud オペレーション チームは、ユーザーと との通信に従ってポッドのアップグレードを開始します 標準のポッド アップグレード プロセス。ポッドのアップグレードが完了すると、Horizon Cloud Operations から通知が届きます。

アップグレードが成功した後

アップグレードで問題が発生した場合にポッドのロールバックをサポートするには、ポッドのアップグレードが完了した後、ポッドの Azure リソース グループには、ポッドの Azure リソース グループ内の以前のマニフェストの単一サーバ PostgreSQL および仮想マシン ディスクが含まれます。

アップグレード後にすべての症状が良好であることが Horizon Cloud オペレーション チームに確認されると、オペレーション チームは API を実行してリソース グループからこれらのアーティファクトを削除します。