適用対象: ✔️ ホストされたコントロール プレーンのアーキテクチャ
ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftを作成したら、ノード プールを作成してコンピューティング容量を追加できます。 ノード プールは、同じ構成を共有するコンピューティング ノードのグループです。 1 つのクラスターに複数のノード プールを追加できるため、ワークロードに合わせてさまざまなノードの種類とサイズを混在させることができます。
ほとんどのノード プールのプロパティは、作成後に変更できません。 ノード プールを作成する前に、 ノード プールのプロパティリファレンス を注意深く確認してください。 VM サイズ、ディスク構成、サブネット、可用性ゾーンなどの変更できないプロパティを変更するには、ノード プールを削除して新しいノード プールを作成する必要があります。
Prerequisites
- ホスト型コントロール プレーンを使用する既存の Azure Red Hat OpenShift クラスター ない場合は、「ホストされたコントロール プレーン クラスターを使用してAzure Red Hat OpenShiftを作成する」を参照してください。
- ノード プールと VNet 統合サブネットに関連付けられているネットワーク セキュリティ グループ (NSG) は、必要なトラフィックを許可する必要があります。 詳細については、「 必要なネットワーク セキュリティ グループトラフィック」を参照してください。
- OpenShift CLI (
oc) がインストールされています。 OpenShift CLI の使用開始を参照してください。 - カスタマー マネージド キー暗号化の場合、キーを作成するには、Key Vault Crypto Officer ロール (Azure Key Vault の場合) または Managed HSM Crypto Officer ロール (Managed HSM の場合) のアクセス許可が必要です。
- 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) は、お客様のキーにアクセスしたり、バックアップしたり、複製したり、取得したりすることはできません。
ディスク暗号化リソースの環境変数を設定します。 プレースホルダーの値を独自の値に置き換えます。
KEYVAULT_NAME="<key-vault-name>" KEYVAULT_KEY_NAME="<key-name>" DISK_ENCRYPTION_SET_NAME="<disk-encryption-set-name>"暗号化キーを格納するための消去保護を有効にしたKey Vaultを作成します。 パージ保護機能により、保存期間が満了する前に削除されたコンテナーが完全に削除されるのを防ぎ、誤っての削除や悪意のある削除から保護します。
az keyvault create \ --name $KEYVAULT_NAME \ --resource-group $CUSTOMER_RG_NAME \ --location $LOCATION \ --enable-purge-protection trueNote
消去保護は必須であり、有効にした後は無効にできません。 既定では、削除されたボールトは 90 日間保持されます。 より迅速な名前の再利用を許可するには、
--retention-days <number-of-days>(最小 7 日間) を追加します。Key Vaultに暗号化キーを作成します。
az keyvault key create \ --vault-name $KEYVAULT_NAME \ --name $KEYVAULT_KEY_NAME \ --protection softwareKey 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)ディスク暗号化セットを作成します。
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ディスク暗号化セットのリソース 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)ディスク暗号化セットのマネージド 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 状態のままになります。
次の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を組み合わせて、ホストでの暗号化とカスタマー マネージド キーの暗号化の両方を使用できます。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}"新しいノードの状態が
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
ノード プールを作成します。
次の例では、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を追加します。 両方の引数を追加することで、同じノード プールで両方の暗号化オプションを組み合わせることができます。新しいノードの状態が
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 ノードがサポートされます。