Oracle Cloud Infrastructureドキュメント

作業リクエストの表示

Container Engine for Kubernetes (OKE)の操作を作業リクエストとして表示する方法をご紹介します。

多くのContainer Engine for Kubernetesサービス・リクエストは、すぐに有効になりません。たとえば、ノード・プールの作成は、必要なすべてのノードがアクティブになるまで完了しません。このような場合、リクエストは非同期に処理され、その進行状況は関連する作業リクエストによって追跡されます。作業リクエストは、進行中の非同期操作を可視化するアクティビティ・ログで、操作の進行状況の各ステップをトラッキングできます。各作業リクエストには、プログラムで対話して自動化に使用できるOCIDがあります。

作業リクエストには、リクエストが開始および終了した時間に関する情報が含まれます。操作が失敗した場合、作業リクエストは、プロセスのどのステップにエラーがあったかの判断に役立ちます。一部の操作は複数のリソースに影響を与えます。たとえば、ノード・プールの作成はノードにも影響します。作業リクエストによって、操作が影響するリソースのリストが提供されます。

詳細は、作業リクエストおよび作業リクエストAPIを参照してください。

ノード・プール作業リクエスト

Container Engine for Kubernetesによって管理されるリソースは、一度に1つの作業リクエストのみをサポートできます。別の作業リクエストの進行中に起動された作業リクエストは失敗し、競合が返されます。一部の操作は他の操作の完了に依存するため、各操作の作業リクエストをモニターして、それが成功したことを確認してから次の操作に進む必要があります。ワークフローでノードが正常に作成され、ノードが「アクティブ」ステータスで登録されると、ノード・プールの作成作業リクエストのステータスは「成功」になります。

作業リクエストのステータス

次の表に、作業リクエストの状態を示します:

ステータス

説明

受入済

リクエストは、処理対象の作業リクエスト・キュー内にあります。

処理中

指定されたリクエストに対して作業リクエスト・レコードが存在しますが、関連付けられたWORK_COMPLETEDレコードは存在しません。

成功しました

このリクエストに対して作業リクエスト・レコードが存在し、関連付けられたWORK_COMPLETEDレコードの状態は「成功」です。

失敗しました

このリクエストに対して作業リクエスト・レコードが存在し、関連付けられたWORK_COMPLETEDレコードの状態は「失敗」です。

取消中

作業リクエストは取消中です。

取消済

作業リクエストは取り消されました。

作業リクエストを表示するために必要なIAMポリシー

Oracle Cloud Infrastructureを使用するには、管理者によってポリシーでセキュリティ・アクセス権が付与されている必要があります。このアクセス権は、コンソール、あるいはSDK、CLIまたはその他のツールを使用したREST APIのいずれを使用している場合でも必要です。権限がない、または認可されていないというメッセージが表示される場合は、管理者に連絡して、アクセス権のタイプおよび作業するコンパートメントを確認してください。

管理者の場合: 作業リクエストは、作業リクエストを生成する操作の権限を継承します。操作の作業リクエスト、ログおよびエラー・メッセージをユーザーが表示できるようにするには、操作を実行する権限をユーザーに付与するポリシーを記述します。たとえば、起動中のインスタンスに関連付けられている作業リクエストをユーザーが表示できるようにするには、ユーザーがインスタンスを起動できるようにするポリシーを記述します。

ユーザーがテナンシのすべての作業リクエストをリストできるようにするには、次のポリシーを使用します:

Allow group SupportTeam to inspect work-requests in tenancy

ポリシーを初めて使用する場合は、「ポリシーの開始」と「共通ポリシー」を参照してください。

作業リクエストの詳細の取得

クラスタまたはノード・プール・リソースの作業リクエストの詳細を取得します。

選択したクラスタまたはノード・プール・リソースに対する作業リクエストの詳細を取得するには、次のいずれかの方法を使用します。

コンソールを使用して作業リクエストの詳細を取得するには

クラスタまたはノード・プール・リソースの作業リクエストの詳細を取得します。

  1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします「コンテナとアーティファクト」で、「Kubernetesクラスタ(OKE)」をクリックします。
  2. リストからコンパートメントを選択します。
  3. 「クラスタ・リスト」ページで、作業リクエストの詳細を取得するクラスタの名前をクリックします。
  4. クラスタ内の特定のノード・プールの作業リクエストの詳細を取得する場合は、「リソース」の下の「ノード・プール」をクリックし、ノード・プールの名前をクリックします。
  5. 作業リクエストを表示するには、「リソース」の下の「作業リクエスト」をクリックします。

  6. 「作業リクエスト」リストで、詳細を取得する作業リクエストを検索します。最近の作業リクエストごとに、次の情報を参照できます。

    • 操作タイプ:作業リクエストによって実行されている操作。
    • ステータス:ステータスとその説明のリストは、「作業リクエスト・ステータス」を参照してください。
    • ID:作業リクエストのOCID。
    • リソース:リソースの名前。
    • 開始時間:作業リクエストが開始されたUTCベースの日時グループ。
    • 終了時間:作業リクエストが終了されたUTCベースの日時グループ。
  7. 特定の作業リクエストをクリックすると、次のものが表示されます。
    • ログ・メッセージ:ワークフローのステージおよび各ステージのタイムスタンプに関する情報。
    • エラー・メッセージ:エラーおよびエラーのタイムスタンプに関する情報。
    • 関連付けられたリソース:作業リクエストの影響を受けるリソースの名前、タイプおよびOCID。
CLIを使用して作業リクエストの詳細を取得するには

コマンドライン・インタフェース(CLI)を使用して、クラスタまたはノード・プール・リソースの作業リクエストの詳細を取得します。

次のコマンドを入力します。

oci ce work-request get --work-request-id work_request_id [OPTIONS]

オプションのリストは、CLIのオンライン・ヘルプを参照してください:

oci ce work-request get --help

コマンドの詳細は、oci ce work-request getを参照してください。

APIを使用して作業リクエストの詳細を取得するには

APIを使用して、クラスタまたはノード・プール・リソースの作業リクエストの詳細を取得します。

GetWorkRequestメソッドを実行して、クラスタまたはノード・プールの作業リクエストの詳細を取得します。詳細は、GetWorkRequestを参照してください。

作業リクエストのリスト

クラスタまたはノード・プール・リソースの作業リクエストをリストします。

次のいずれかの方法を使用して、選択したクラスタまたはノード・プール・リソースの作業リクエストのリストを表示します。

コンソールを使用して作業リクエストをリストするには

OCIコンソールを使用して、クラスタまたはノード・プール・リソースの作業リクエストをリストします。

  1. ナビゲーション・メニューを開き、「開発者サービス」をクリックします「コンテナとアーティファクト」で、「Kubernetesクラスタ(OKE)」をクリックします。

  2. リストからコンパートメントを選択します。

  3. 「クラスタ・リスト」ページで、作業リクエストをリストするクラスタの名前をクリックします。
  4. クラスタ内の特定のノード・プールの作業リクエストの詳細を取得する場合は、「リソース」の下の「ノード・プール」をクリックし、ノード・プールの名前をクリックします。

  5. 「リソース」の下の「作業リクエスト」をクリックします。

    「作業リクエスト」リストには、最近の作業リクエストが表示されます。

CLIを使用して作業リクエストをリストするには

クラスタまたはノード・プール・リソースの作業リクエストをリストするには、コマンドライン・インタフェース(CLI)を使用します。

次のコマンドを入力します。

oci ce work-request list --compartment-id compartment-OCID --resource-type CLUSTER|NODEPOOL --cluster-id cluster-OCID --resource-id resource-OCID [OPTIONS]

オプションのリストは、CLIのオンライン・ヘルプを参照してください:

oci ce work-request list --help

コマンドの詳細は、oci ce作業リクエスト・リストを参照してください。

APIを使用して作業リクエストをリストするには

APIを使用して、クラスタまたはノード・プール・リソースの作業リクエストをリストします。

ListWorkRequestsメソッドを実行して、クラスタまたはノード・プール・リソースの作業リクエストをリストします。詳細は、ListWorkRequestsを参照してください。