ホストされたコントロール プレーンを使用してAzure Red Hat OpenShiftにノード プールを作成する

適用対象: ✔️ ホストされたコントロール プレーンのアーキテクチャ

ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftを作成したら、ノード プールを作成してコンピューティング容量を追加できます。 ノード プールは、同じ構成を共有するコンピューティング ノードのグループです。 1 つのクラスターに複数のノード プールを追加できるため、ワークロードに合わせてさまざまなノードの種類とサイズを混在させることができます。

ほとんどのノード プールのプロパティは、作成後に変更できません。 ノード プールを作成する前に、 ノード プールのプロパティリファレンス を注意深く確認してください。 VM サイズ、ディスク構成、サブネット、可用性ゾーンなどの変更できないプロパティを変更するには、ノード プールを削除して新しいノード プールを作成する必要があります。

Prerequisites

  • Azure CLI バージョン 2.93.0 以降。 az --versionを使用して、インストールされているバージョンを見つけます。 インストールまたはアップグレードが必要な場合は、Azure CLI のインストールを参照してください。

環境変数の設定

次の環境変数をまだ設定していない場合は、先に進む前にシェルで設定します。 プレースホルダーの値を独自の値に置き換えます。

LOCATION="<azure-region>"
SUBSCRIPTION_ID="$(az account show --query id --output tsv)"
CUSTOMER_RG_NAME="<resource-group-name>"
CLUSTER_NAME="<cluster-name>"
NP_NAME="<node-pool-name>"
NP_VERSION="<node-pool-version>"

Note

サポートされているリージョンの一覧については、「 クラスター リージョンの選択」を参照してください。

(省略可能)OS ディスク暗号化を設定する

ホストされたコントロール プレーンを使用したAzure Red Hat OpenShiftでは、ノード プール OS ディスクに対して 2 つのオプションの暗号化方法がサポートされています。 どちらのメソッドもノード プールの作成後は変更不可であり、同じノード プール上でそれらを組み合わせることができます。

  • カスタマー マネージド キー (CMK) 暗号化では、Azure Key Vaultまたは Azure Key Vault Managed HSM 内のキーを参照するAzure Disk Encryption セットを使用して OS ディスクを暗号化します。
  • ホストでの暗号化 は、VM データのエンドツーエンドの暗号化を提供します。 VM ホストに格納されているデータは保存時に暗号化され、ストレージ サービスに暗号化されてフローされます。

どちらの暗号化オプションも必要ない場合は、「 ノード プールの作成」に進みます。

ディスク暗号化セットを作成する

カスタマー マネージド キーを使用してノード プール OS ディスクを暗号化するには、Azure Key Vault または Managed HSM のキーを参照するAzure Disk Encryption セットを作成します。 次に、ノード プールを作成するときにディスク暗号化セットを参照します。 ディスク暗号化セットは、クラスターと同じサブスクリプションと場所にある必要があります。

Note

Disk Encryption Sets は、ノード プールの OS ディスクを暗号化します。 この機能は etcd 暗号化とは無関係であり、クラスターの状態データが保存時に暗号化されます。 etcd 暗号化の詳細については、「 クラスター暗号化戦略の選択」を参照してください。

Important

Azureでキー ストアとディスク暗号化セットを維持する責任があります。
キーを保持しないと、それらのキーを使用するノード プールが中断されます。
VM は動作を停止し、その結果、影響を受けるノードで実行されているワークロードは機能を停止します。 Red Hat Site Reliability Engineering (SRE) は、お客様のキーにアクセスしたり、バックアップしたり、複製したり、取得したりすることはできません。

  1. ディスク暗号化リソースの環境変数を設定します。 プレースホルダーの値を独自の値に置き換えます。

    KEYVAULT_NAME="<key-vault-name>"
    KEYVAULT_KEY_NAME="<key-name>"
    DISK_ENCRYPTION_SET_NAME="<disk-encryption-set-name>"
    
  2. 暗号化キーを格納するための消去保護を有効にしたKey Vaultを作成します。 パージ保護機能により、保存期間が満了する前に削除されたコンテナーが完全に削除されるのを防ぎ、誤っての削除や悪意のある削除から保護します。

    az keyvault create \
        --name $KEYVAULT_NAME \
        --resource-group $CUSTOMER_RG_NAME \
        --location $LOCATION \
        --enable-purge-protection true
    

    Note

    消去保護は必須であり、有効にした後は無効にできません。 既定では、削除されたボールトは 90 日間保持されます。 より迅速な名前の再利用を許可するには、 --retention-days <number-of-days> (最小 7 日間) を追加します。

  3. Key Vaultに暗号化キーを作成します。

    az keyvault key create \
        --vault-name $KEYVAULT_NAME \
        --name $KEYVAULT_KEY_NAME \
        --protection software
    
  4. Key Vault リソース ID とキー URL を取得します。

    KEYVAULT_ID=$(az keyvault show --name $KEYVAULT_NAME --query "[id]" -o tsv)
    KEYVAULT_KEY_URL=$(az keyvault key show --vault-name $KEYVAULT_NAME --name $KEYVAULT_KEY_NAME --query "[key.kid]" -o tsv)
    
  5. ディスク暗号化セットを作成します。

    az disk-encryption-set create \
        --name $DISK_ENCRYPTION_SET_NAME \
        --location $LOCATION \
        --resource-group $CUSTOMER_RG_NAME \
        --source-vault $KEYVAULT_ID \
        --key-url $KEYVAULT_KEY_URL
    
  6. ディスク暗号化セットのリソース ID と ID プリンシパル ID を取得します。

    DES_ID=$(az disk-encryption-set show --name $DISK_ENCRYPTION_SET_NAME --resource-group $CUSTOMER_RG_NAME --query 'id' -o tsv)
    DES_IDENTITY=$(az disk-encryption-set show --name $DISK_ENCRYPTION_SET_NAME --resource-group $CUSTOMER_RG_NAME --query "[identity.principalId]" -o tsv)
    
  7. ディスク暗号化セットのマネージド ID にKey Vaultへのアクセス権を付与します。 次のコマンドは、必要なwrapkey、unwrapkey、およびgetキーのアクセス許可を提供する、Key Vault Crypto Service Encryption ユーザー ロールを割り当てます。

    az role assignment create \
        --assignee $DES_IDENTITY \
        --role "Key Vault Crypto Service Encryption User" \
        --scope $KEYVAULT_ID
    

ホストで暗号化を登録する

ホストでの暗号化は、VM データのエンドツーエンドの暗号化を提供します。 VM ホストに格納されているデータは保存時に暗号化され、ストレージ サービスに暗号化されてフローされます。

ホストで暗号化を使用してノード プールを作成する前に、サブスクリプションに EncryptionAtHost 機能を登録します (まだ登録していない場合)。

az feature register --namespace Microsoft.Compute --name EncryptionAtHost

登録状態を確認します。

az feature show --namespace Microsoft.Compute --name EncryptionAtHost

ノード プールを作成する

Important

ノード プール ワーカーがデプロイされているサブネットに関連付けられているネットワーク セキュリティ グループ (NSG) と、VNet 統合サブネットに関連付けられている NSG は、「 必要なネットワーク セキュリティ グループ トラフィック」で説明されているトラフィックを許可する必要があります。 NSG に必要なトラフィックをブロックする拒否規則がある場合、作成したノード プールは、操作がタイムアウトするまで Provisioning 状態のままになります。

  1. 次のBicep テンプレートをnodepool.bicepとして保存します。

    次の例では、2 つの Standard_D8s_v6 ノードを含むノード プールを作成します。

    param clusterName string
    param nodePoolName string
    param nodePoolVersion string
    
    resource cluster 'Microsoft.RedHatOpenShift/hcpOpenShiftClusters@2026-10-01' existing = {
      name: clusterName
    }
    
    resource nodepool 'Microsoft.RedHatOpenShift/hcpOpenShiftClusters/nodePools@2026-10-01' = {
      parent: cluster
      name: nodePoolName
      location: resourceGroup().location
      properties: {
        version: {
          id: nodePoolVersion
          channelGroup: 'stable'
        }
        platform: {
         subnetId: cluster.properties.platform.subnetId
         vmSize: 'Standard_D8s_v6'
          osDisk: {
            sizeGiB: 64
            diskStorageAccountType: 'StandardSSD_LRS'
          }
        }
        replicas: 2
      }
    }
    

    カスタマー マネージド キーを使用して OS ディスクを暗号化するには、 encryptionSetId プロパティを osDisk ブロックに追加し、値を Disk Encryption Set リソース ID に設定します。

    osDisk: {
      ...
      encryptionSetId: '<disk-encryption-set-resource-id>'
    }
    

    ホストで暗号化を有効にするには、platform ブロックに enableEncryptionAtHost プロパティを追加します。

    platform: {
      ...
      enableEncryptionAtHost: true
    }
    

    Note

    enableEncryptionAtHostと同じノード プール上のencryptionSetIdを組み合わせて、ホストでの暗号化とカスタマー マネージド キーの暗号化の両方を使用できます。

  2. Bicep ファイルをデプロイします。

    az deployment group create \
      --name 'aro-hcp-nodepool' \
      --subscription "${SUBSCRIPTION_ID}" \
      --resource-group "${CUSTOMER_RG_NAME}" \
      --template-file nodepool.bicep \
      --parameters \
        clusterName="${CLUSTER_NAME}" \
        nodePoolName="${NP_NAME}" \
        nodePoolVersion="${NP_VERSION}"
    
  3. 新しいノードの状態が Ready であることを確認します。

    oc get nodes
    

    次の出力例は、2 つのノード プールのノードを示しています。 新しいノード プール (np-2) のノードは、次の準備ができています。

    NAME                          STATUS   ROLES    AGE     VERSION
    mycluster-np-1-722lp-6fhkr   Ready    worker   82m     v1.31.5
    mycluster-np-1-722lp-hvg7r   Ready    worker   82m     v1.31.5
    mycluster-np-2-c7d7l-fdpms   Ready    worker   3m19s   v1.31.5
    mycluster-np-2-c7d7l-rk7kt   Ready    worker   3m41s   v1.31.5
    
  1. ノード プールを作成します。

    次の例では、2 つの Standard_D8s_v6 ノードを含むノード プールを作成します。

    az aro hcp cluster nodepool create \
      --resource-group "${CUSTOMER_RG_NAME}" \
      --cluster-name "${CLUSTER_NAME}" \
      --name "${NP_NAME}" \
      --replicas 2 \
      --vm-size Standard_D8s_v6 \
      --version "${NP_VERSION}" \
      --channel-group stable
    

    カスタマー マネージド キーを使用して OS ディスクを暗号化するには、Disk Encryption Set リソース ID を使用して --disk-encryption-set 引数を追加します。 --disk-encryption-set "${DES_ID}"

    ホストで暗号化を有効にするには、 --encryption-at-host trueを追加します。 両方の引数を追加することで、同じノード プールで両方の暗号化オプションを組み合わせることができます。

  2. 新しいノードの状態が Ready であることを確認します。

    oc get nodes
    

    次の出力例は、2 つのノード プールのノードを示しています。 新しいノード プールのノードの準備が整いました。

    NAME                          STATUS   ROLES    AGE     VERSION
    mycluster-np-1-722lp-6fhkr   Ready    worker   82m     v1.31.5
    mycluster-np-1-722lp-hvg7r   Ready    worker   82m     v1.31.5
    mycluster-np-2-c7d7l-fdpms   Ready    worker   3m19s   v1.31.5
    mycluster-np-2-c7d7l-rk7kt   Ready    worker   3m41s   v1.31.5
    

ノード プールのプロパティ参照

次の表では、構成できるノード プールのプロパティについて説明します。 変更不可としてマークされたプロパティは、ノード プールの作成時にのみ設定できます。

財産 説明 必須 不変
name ノード プールの名前。 長さは 1 ~ 15 文字で、文字で始まり、文字または数字で終わり、文字、数字、ハイフンのみを含める必要があります。 はい はい
version.id ノード プールの OpenShift バージョン ( 4.22.1など)。 コントロール プレーンのバージョン以下である必要があります。 はい いいえ
version.channelGroup OpenShift 更新チャネル。 サポートされている値は、 stable と fastのみです。 いいえ はい
platform.vmSize ノードのAzure VM サイズ。 サポートされているサイズについては、「 サポートされている仮想マシンのサイズ」を参照してください。 可用性は、クラスターのAzureの場所によっても異なります。 はい はい
platform.subnetId サブネットのAzure リソース ID。 クラスターと同じ仮想ネットワークに属している必要があります。 このサブネットに接続されている NSG は、必要なノード プール トラフィックを許可する必要があります。 指定されていない場合は、クラスターのサブネットが既定値になります。 いいえ はい
platform.availabilityZone ノードプールの可用性ゾーン。 指定しない場合、ノード プールは可用性セットに作成されます。 詳細については、「可用性ゾーンとは」を参照してください。 いいえ はい
platform.osDisk.sizeGiB OSディスクサイズはGiB単位です。 最小値は 64 です。 最大値は 4095 です。 既定値は 64 GiB です。 Ephemeral ディスクの場合、最大値は 2040 で、VM のサイズはさらに小さくなります。 いいえ はい
platform.osDisk.diskStorageAccountType マネージド ディスクの種類。 有効な値: Premium_LRS、 StandardSSD_LRS、 Standard_LRS。 既定値は Premium_LRS です。 詳しくは、「Azure マネージド ディスクの種類」をご覧ください。 いいえ はい
platform.osDisk.diskType OS ディスクの種類。 Managedは、ディスクをAzureマネージド ディスクとして格納します。 Ephemeral は、低遅延とノード操作の迅速化のために、ディスクを VM のローカル ストレージに格納します。 エフェメラル ディスクには、OS ディスク イメージ サイズ以上のローカル ストレージ容量を持つ VM サイズが必要です。 既定値は Managed です。 詳細については、 Azure VM のエフェメラル OS ディスクに関するページを参照してください。 いいえ はい
platform.osDisk.encryptionSetId OS ディスクを暗号化するDiskEncryptionSetのAzure リソース ID。 クラスターと同じサブスクリプションと場所に存在する必要があります。 ディスク暗号化セットの作成を参照してください。 いいえ はい
platform.enableEncryptionAtHost ノード プール内のすべてのノードの VM ホストで暗号化を有効にします。 既定値は false です。 ホストでの暗号化の登録に関するページを参照してください。 いいえ はい
replicas プロビジョニングするノードの数。 autoScalingが構成されていない場合は必須です。 最低値は0です。 Conditional いいえ
autoScaling ノード プールの自動スケールを有効にします。 replicasが構成されていない場合は必須です。 autoScaling.minとautoScaling.maxを設定して、ノード数の範囲を定義します。 Conditional いいえ
labels 新しく作成されたノードにキーと値のペアとして適用される Kubernetes ラベル。 いいえ いいえ
taints 新しく作成されたノードに適用される Kubernetes テイント。 各テイントには key と effectが必要です。 有効な効果: NoSchedule、 PreferNoSchedule、 NoExecute。 いいえ いいえ
nodeDrainTimeoutMinutes ノード交換時の、Pod Disruption Budget で保護されたワークロードに対する猶予期間(分) 範囲: 0 ~ 10080 (1 週間)。 値 0 は時間制限がないことを意味します。 クラスター レベルの既定値をオーバーライドします。 いいえ いいえ

Note

ホストされたコントロール プレーンを使用するAzure Red Hat OpenShiftは、すべてのノード プールでクラスターあたり最大 500 個のワーカー ノードをサポートします。 可用性ゾーンにデプロイされたノード プールでは、ノード プールあたり最大 500 ノードがサポートされます。 可用性セットにデプロイされたノード プールでは、ノード プールあたり最大 200 ノードがサポートされます。

次のステップ