OKEワーカー・ノード・プールの作成

新しいノード・プールを作成するには、oci ce node-pool createコマンドと必要なパラメータを使用します。

oci ce node-pool create --cluster-id cluster_OCID --compartment-id compartment_OCID --name pool_name --node-shape node_shape_name [OPTIONS]

1. コマンドを実行するために必要な情報を取得します。

   • ノード・プールを作成するコンパートメントのOCID: oci iam compartment list

   • このノード・プールのクラスタのOCID: oci ce cluster list

   • ノード・プールの名前です。機密情報を入力しないでください。

   • ワーカー・サブネットOCIDおよびフォルト・ドメインを含む、ノードの配置構成。詳細は、このページの「コンソール」タブを選択し、配置構成を参照してください。このオプションの内容と形式を表示するには、次のコマンドを使用します。

     $ oci ce node-pool create --generate-param-json-input placement-configs

     次のコマンドを使用して、フォルト・ドメインをリストします: oci iam fault-domain list。配置構成で複数のフォルト・ドメインまたは複数のサブネットを指定しないでください。システムで最適なフォルト・ドメインを選択できるようにするには、フォルト・ドメインを指定しないでください。Roving Edge Deviceにはフォルト・ドメインが1つのみあります。

   • (VCNネイティブ・ポッド・ネットワーキング・クラスタのみ)ポッド・サブネットのOCID。ポッド・サブネット(VCNネイティブ・ポッド)の作成を参照してください。詳細は、このページの「コンソール」タブを選択し、「ポッド通信」を参照してください。--pod-subnet-idsオプションを使用します。--pod-subnet-idsオプション値は配列ですが、指定できるポッド・サブネットOCIDは1つのみです。

     ノード・プール内の単一のワーカー・ノードで実行するポッドの最大数。--max-pods-per-nodeオプションを使用します。デフォルト値は「31」です。1から110の数値を入力できます。指定したシェイプで許可されるVNICの数(シェイプの名前を参照)によって、この最大ポッド数が制限されます。Node Shapes and Number of Podsを参照してください。ポッド・サブネットのアドレス領域を節約するには、単一のワーカー・ノードで実行するポッドの最大数を減らします。これにより、ポッド・サブネットに事前に割り当てられているIPアドレスの数が減少します。

     (オプション)このノード・プールのポッドに使用するネットワーク・セキュリティ・グループのOCID。--pod-nsg-idsオプションを使用します。最大5つのNSGを指定できます。

   • このノード・プールのノードで使用するイメージのOCID。

     使用するイメージのOCIDを取得するには、次のコマンドを使用します。

     $ oci compute image list --compartment-id compartment_OCID

     使用するイメージがリストされていない場合、このイメージを使用していたノード・プールのce node-pool getコマンドの出力からイメージのOCIDを取得できます。

     ノート
     
     

     指定するイメージは、display-nameに-OKE-があり、クラスタの作成時に指定したKubernetesバージョンより新しいKubernetesバージョンを持つことはできません。

     クラスタのKubernetesバージョンがcluster list出力に表示されます。イメージのKubernetesバージョンは、image list出力のdisplay-nameプロパティに表示されます。次のイメージのKubernetesバージョンは1.29.9です。

     "display-name": "uln-pca-Oracle-Linux8-OKE-1.29.9-20250325.oci"

     複数のイメージに同じKubernetesバージョンがある場合は、イメージ名の日付に従って最新のイメージを選択します。

     node-pool createコマンドで--kubernetes-versionオプションを指定しないでください。

     カスタム・ブート・ボリューム・サイズをギガバイト単位で指定できます。デフォルトのブート・ボリューム・サイズは50 GBです。カスタム・ブート・ボリューム・サイズを指定するには、--node-source-detailsオプションを使用してブート・ボリューム・サイズとイメージの両方を指定します。--node-image-idと--node-source-detailsの両方を指定することはできません。次のコマンドを使用して、ノード・ソース詳細オプションの内容と形式を表示します。

     $ oci ce node-pool create --generate-param-json-input node-source-details

     カスタム・ブート・ボリューム・サイズを指定する場合、より大きいサイズを使用できるようにパーティションを拡張する必要があります。Oracle Linuxプラットフォーム・イメージには、oci-utilsパッケージが含まれています。そのパッケージのoci-growfsコマンドを使用して、ルート・パーティションを拡張し、ファイル・システムを拡張します。oci-growfsを参照してください。

   • このノード・プール内のワーカー・ノードのシェイプの名前。GPUオペレータ・クラスタ・アドオンを使用している場合は、サポートされているGPUシェイプを使用できます。他のすべてのRoving Edgeシステムの場合、デフォルトのシェイプはVM.PCAStandard1.1であり、別のシェイプを指定できます。使用可能なシェイプの説明は、コンピュート・シェイプを参照してください。

     フレキシブル・シェイプを指定する場合は、次の例に示すようにシェイプ構成も指定する必要があります。ocpusの値を指定する必要があります。memoryInGBsプロパティはオプションです。デフォルト値はギガバイト単位で、ocpusの16倍です。

     --node-shape-config '{"ocpus": 32, "memoryInGBs": 512}'

     ノート
     
     

     実行中の10ポッドごとに、少なくとも2 OCPUと32 GBのメモリーを割り当てます。計画されているワークロードに応じて、より多くのリソースを割り当てる必要がある場合があります。ポッドおよびコンテナのResource Managementを参照してください。

     フレキシブル・シェイプではないシェイプを指定する場合は、--node-shape-configを指定しないでください。OCPUの数およびメモリー量は、コンピュート・シェイプの「標準シェイプ」でこのシェイプに表示される値に設定されます。

   • (オプション)このノード・プール内のノードに使用するネットワーク・セキュリティ・グループのOCID。--nsg-idsオプションを使用します。複数のNSGを指定しないでください。

   • (オプション)ラベル。ノードにラベルを設定すると、特定のノードまたはノードのグループでスケジュールするためのポッドをターゲットにできます。この機能を使用して、特定のポッドが特定の分離、セキュリティまたは規制プロパティを持つノードでのみ実行されるようにします。

     --initial-node-labelsオプションを使用して、ノードにラベルを追加します。ラベルは、Kubernetesクラスタに参加した後にノードに追加するキー/値ペアのリストです。メタデータ制限の詳細は、Metadata Key Restrictionsを参照してください。

     次に、ノード・プール内のノードに適用するラベルの例を示します。

     --initial-node-labels '[{"key":"disktype","value":"ssd"}]

     ラベルに基づいてノードを簡単に選択するには、ポッド構成でnodeSelectorを使用します。Kubernetesは、nodeSelectorセクションで指定されている各ラベルを持つノードにのみポッドをスケジュールします。

     次のポッド構成の抜粋例では、この構成を使用するポッドを、ssdディスク・タイプ・ラベルを持つノードで実行する必要があることを指定します。

     nodeSelector:
       disktype: ssd

   • (オプション)ノード・メタデータ。カスタム・ユーザー・データをノードに添付するには、--node-metadataオプションを使用します。具体的な例については、次のプロキシ設定項目を参照してください。

     メタデータ制限については、Metadata Key Restrictionsを参照してください。ノード・メタデータの最大サイズは32,000バイトです。

   • (オプション)プロキシ設定。ネットワークで、ワーカー・ノードが外部レジストリまたはリポジトリに到達できるようにプロキシ設定が必要な場合は、たとえば、--node-metadataオプションの引数を作成します。

     --node-metadataオプション引数で、次のサンプル・ファイル引数に示すように、crio-proxyおよびcrio-noproxyの値を指定します。

     {
       "crio-proxy": "http://your_proxy.your_domain_name:your_port",
       "crio-noproxy": "localhost,127.0.0.1,your_domain_name,ocir.io,Kubernetes_cidr,pods_cidr"
     }

     クラスタでVCNネイティブ・ポッド・ネットワーキングを使用している場合は、次の例に示すように、169.254.169.254をnoproxy設定に追加します:

     "crio-noproxy": "localhost,127.0.0.1,your_domain_name,ocir.io,Kubernetes_cidr,pods_cidr,169.254.169.254"

   • (オプション)ノードおよびノード・プールの削除設定。ノード・プールの削除時、指定したノードの削除時、ノード・プールのサイズの減少時、またはノード・プール・ノードの配置構成の変更時に、ノードの削除の処理方法を指定できます。これらのノード削除パラメータは、ノード・プールの更新、指定したノードの削除、またはノード・プールの削除時にも設定または変更できます。

     ノード・プールの削除設定を指定するには、--node-eviction-node-pool-settingsオプションの引数を作成します。ノードの削除猶予期間(evictionGraceDuration)を指定できます。ノードは、ポッドが削除されるか、削除猶予期間の終了後に常に削除されます。

     • 削除猶予期間。この値は、ワーカー・ノードをコード化およびドレインできる時間を指定します。

       コード化されているノードには、新しいポッドを配置できません。そのノード上の既存のポッドは影響を受けません。

       ノードが排出されると、各ポッドのコンテナは正常に終了し、必要なクリーンアップを実行します。

       削除猶予期間の値は、ISO 8601形式(PT45S、PT20M、PT39M21Sなど)で表されます。デフォルト値および最大値は60分(PT60M)です。最小値は20秒(PT20S)です。OKEは、常に少なくとも20秒間ノードをドレインしようとします。

     • 強制的な削除。ノードは、ポッドが削除されるか、削除猶予期間の終了後に常に削除されます。デフォルトまたは指定された削除猶予期間の後、1つ以上のポッド・コンテナが完全に排出されていない場合でも、ノードは削除されます。

     次に、--node-eviction-node-pool-settingsオプションの引数例を示します。isForceDeleteAfterGraceDurationプロパティを含める場合、その値はtrueである必要があります。ノードは、ポッドが削除されるか、削除猶予期間の終了後に常に削除されます。

     --node-eviction-node-pool-settings '{"evictionGraceDuration": "PT30M", "isForceDeleteAfterGraceDuration": true}'

     ノート
     
     

     Terraformを使用してnode_eviction_node_pool_settingsを指定する場合、trueがデフォルト値であっても、明示的にis_force_delete_after_grace_durationをtrueに設定する必要があります。Terraformを使用している場合、is_force_delete_after_grace_durationプロパティ設定はオプションではありません。

   • (オプション)タグ。--defined-tagsまたは--freeform-tagsオプションを使用して、ノード・プール・リソースの定義済タグまたはフリーフォーム・タグを追加します。OraclePCA-OKE.cluster_id定義済タグまたはClusterResourceIdentifierフリーフォーム・タグには値を指定しないでください。これらのタグ値はシステムによって生成され、ノード・プール・リソースではなくノード(インスタンス)にのみ適用されます。

     定義済タグまたはフリーフォーム・タグをノード・プール内のすべてのノードに追加するには、--node-defined-tagsおよび--node-freeform-tagsオプションを使用します。

     重要
     
     

     OraclePCA-OKE.cluster_id定義済タグまたはClusterResourceIdentifierフリーフォーム・タグには値を指定しないでください。これらのタグ値はシステムによって生成されます。

   • (オプション)カスタムCA証明書バンドル。プライベート・コンテナ・レジストリへのTLS接続の検証に使用するカスタムCA証明書バンドルを指定できます。custom-ca-bundle-cert、registry-hostおよびregistry-portメタデータ・パラメータを--node-metadataオプションとともに使用します。

     --node-metadataオプション引数では、custom-ca-bundle-certの値を指定する必要があります。

     --node-metadata '{"custom-ca-bundle-cert":"<base64-encoded-cert-content>"}'

     カスタムCAバンドルを使用してプライベート・レジストリを構成した場合は、ノードが新しくプロビジョニングまたは循環(スケール・ダウンおよびバックアップまたはローリング再起動)され、更新された証明書がすべてのワーカー・ノードに適用されていることを確認します。

2. ノード・プールの作成コマンドを実行します。

   例:

   この例に示されているオプション、および --node-boot-volume-size-in-gbsや nsg-idsなどのその他のオプションについては、コンソールの手順を参照してください。--pod-subnet-idsオプションは、クラスタでVCNネイティブ・ポッド・ネットワーキングが使用されている場合にのみ適用されます。

   $ oci ce node-pool create \
   --cluster-id ocid1.cluster.unique_ID --compartment-id ocid1.compartment.unique_ID \
   --name node_pool_name --node-shape shape_name --node-image-id ocid1.image.unique_ID \
   --placement-configs '[{"availabilityDomain":"AD-1","subnetId":"ocid1.subnet.unique_ID"}]' \
   --pod-subnet-ids '["ocid1.subnet.unique_ID"]' --size 10 --ssh-public-key "public_key_text"

   このnode-pool createコマンドからの出力は、node-pool getコマンドからの出力と同じです。クラスタOCIDが表示され、各ノードの簡単なサマリーが表示されます。ノードの詳細は、ノードのOCIDを指定してcompute instance getコマンドを使用してください。

   work-request getコマンドを使用して、ノード・プール作成操作のステータスを確認します。作業リクエストOCIDは、cluster get出力のmetadataセクションのcreated-by-work-request-idにあります。

   $ oci ce work-request get --work-request-id workrequest_OCID

   クラスタがアクティブ状態または失敗状態になるまで、作業リクエストのステータスはACCEPTEDになります。

   インスタンスのリストでこれらのノードを識別するには、これらのノードの名前の形式はoke-IDであることに注意してください。IDは、ノード・プールOCIDの名前の後の最初の32文字です。このノード・プールOCIDから、名前にID文字列が含まれているインスタンスを検索します。

次の作業:

CreateNodePool操作を使用して、新しいノード・プールを作成します。

次のステップ: