Oracle Cloud Infrastructureドキュメント

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

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

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

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

  • 最大サージ。この更新操作中にいつでも開始できる新規ノードの最大数。この値を設定すると、既存のノードが終了する前に新しいノードが多すぎてしまい、過剰なコストが発生する可能性があります。デフォルト値は1です。最大値は5です。

  • 最大使用不可。この更新操作中にいつでも終了できる既存のノードの最大数。ワークロードを処理するのに十分なノードが残っていることを確認するには、この値を設定します。デフォルト値は0です。最大値は7です。

これらの値の1つが0(ゼロ)より大きい必要があります。

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

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

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

ノート

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

  • OKEノード・プールの更新の手順に従って、ノード・プール構成を更新します。

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

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

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

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

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

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

    oci ce node-pool update [OPTIONS]

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

    プロシージャ

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

    2. その同じコマンドに(あとではなく) --node-pool-cycling-detailsオプションを含めます。

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

      $ 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操作を使用して、ノード・プールを更新します。

    新しいワーカー・ノードを追加する変更を加えた場合は、次のステップを考慮してください。

    1. ワーカー・ノードに必要なレジストリまたはリポジトリを構成します。OKEサービスおよびアプリケーション・イメージで使用する自己管理パブリックまたはイントラネット・コンテナ・レジストリへのアクセス権があることを確認します。

    2. Compute Cloud@Customerの外部でコンテナ化されたアプリケーションを公開するサービスを作成します。コンテナ化されたアプリケーションの公開を参照してください。

    3. アプリケーションで使用する永続ストレージを作成します。コンテナ化されたアプリケーションのストレージの追加を参照してください。

    既存のノードのプロパティを変更するには、かわりに新しい設定で新しいノード・プールを作成し、作業を新しいノードに移動します。

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