Oracle Cloud Infrastructureドキュメント

OKEノード・プールのノード・サイクリング

Compute Cloud@Customerでは、ノード・プールを更新すると、この更新中に追加された新規ノード、または後で追加された新規ノードのみが更新を受信します。既存のノードを更新された設定を使用する新しいノードに置き換えるには、ノード・サイクリング・オプションを有効にします。

ノード・サイクリングでは、ノード・プール内のすべての既存ノードを、指定した最新の構成にインプレースで更新します。新しいノードが作成され、既存のノードからワークロードがそれらのノードに移動され、現在のノード・プールの更新が適用され、元のノードが終了します。

いつでも起動または終了するノードの最大数を設定できます。

  • Maximum surge. The maximum number of new nodes that can be starting at any time during this update operation. Set this value to avoid adding too many new nodes before existing nodes are terminated, which could incur excessive cost. The default value is 1. The maximum value is 5.

  • Maximum unavailable. The maximum number of existing nodes that can be terminating at any time during this update operation. Set this value to ensure that enough nodes remain to handle the workload. The default value is 0. The maximum value is 7.

これらの値の1つは0より大きい値である必要があります。

これらの値は両方とも、数値(0からノード・プール内の構成済ノード数までですが、前述の最大値を超えない)またはパーセンテージ(0%から100%まで)に設定できますが、前述の最大値を超えるパーセンテージは設定できません。これらの値は最大4文字です。

これらの値は両方とも複数のノードであるか、または両方ともパーセントである必要があります。これらの値の1つをノード数として、もう1つの値をパーセントとして指定することはできません。

これらのプロパティのいずれかを、ノードの最大許容数を超えるパーセント値に設定すると、このノード・プールの最大許容パーセント値を示すエラー・メッセージが表示されます。

ノート

ノード・サイクリング操作が失敗した場合(操作タイムアウトなど)、操作の再実行を試行します。システムが大規模にロードおよび実行されている場合は、ノード・サイクリング操作を複数回実行する必要がある場合があります。

  • ノード・プール構成を更新するには、「OKEノード・プールの更新」の手順に従います。

    1. ノード・プールの詳細ページで、「サイクル・ノード」ボタンを選択します。

    2. 「サイクル・ノード」ダイアログで、「最大サージ」および「最大使用不可」プロパティの値を入力します。

      このトピックの冒頭にあるルールを参照してください。

    3. ダイアログの「サイクル・ノード」ボタンを選択して、ノード・プールの更新操作を開始します。

      更新操作の進行状況をモニターするには、関連付けられた作業リクエストのステータスを表示します。

  • oci ce node-pool updateコマンドの--node-pool-cycling-detailsオプションを使用して、ノード・プール内のすべての既存のノードを更新します。

    oci ce node-pool update [OPTIONS]

    CLIコマンド、フラグおよびオプションの完全なリストは、コマンドライン・リファレンスを参照してください。

    プロシージャ

    1. 「CLI」タブの「OKEノード・プールの更新」の説明に従って、ノード・プール構成を更新するコマンドを作成します。

    2. その同じコマンドに(後からではなく) --node-pool-cycling-detailsオプションが含まれています。

      maximumUnavailableおよびmaximumSurgeの設定に加えて、isNodeCyclingEnabledをtrueに設定してノード・サイクリングを有効にします。デフォルトでは、isNodeCyclingEnabledはfalseで、maximumUnavailableまたはmaximumSurgeのみを設定し、isNodeCyclingEnabledをtrueに設定しない場合、ノード・サイクリングは実行されません。

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
new_configuration_settings \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"value","maximumSurge":"value"}'

      使用可能な値については、このトピックの先頭を参照してください。

      次の例では、ノード・プール内のすべてのノードのイメージが更新されます。

      $ oci ce node-pool update --node-pool-id ocid1.nodepool.unique_ID \
--node-source-details '{"imageId":"ocid1.image.unique_ID","sourceType":"IMAGE"}' \
--node-pool-cycling-details '{"isNodeCyclingEnabled":true,"maximumUnavailable":"5%","maximumSurge":"5%"}'

      更新操作の進行状況をモニターするには、関連付けられた作業リクエストのステータスを表示します。

      作業リクエストOCIDを見つけます。

      oci ce work-request list --compartment-id ocid1.compartment.unique_ID \
--resource-id ocid1.nodepool.unique_ID

      作業リクエストの現在の状態を表示します。

      oci ce work-request get --work-request-id ocid1.workrequest.unique_ID

  • ノード・プールを更新するには、UpdateNodePool操作を使用します。ノード・プール内のすべての既存のノードを更新するには、nodePoolCyclingDetails属性(isNodeCyclingEnabled、maximumSurgeおよびmaximumUnavailable)を使用します。

    APIの使用およびリクエストの署名の詳細は、REST APIおよびセキュリティ資格証明を参照してください。SDKについては、ソフトウェア開発キットとコマンドライン・インタフェースを参照してください。