作業リクエストの表示
Kubernetes Engine (OKE)の操作を作業リクエストとして表示する方法をご覧ください。
多くのKubernetes Engineサービス・リクエストは、すぐには有効になりません。たとえば、ノード・プールの作成は、必要なすべてのノードがアクティブになるまで完了しません。このような場合、リクエストは非同期に処理され、その進行状況は関連する作業リクエストによって追跡されます。作業リクエストは、進行中の非同期操作を可視化するアクティビティ・ログで、操作の進行状況の各ステップをトラッキングできます。各作業リクエストには、プログラムで対話して自動化に使用できるOCIDがあります。
作業リクエストには、リクエストが開始および終了した時間に関する情報が含まれます。操作が失敗した場合、作業リクエストは、プロセスのどのステップにエラーがあったかの判断に役立ちます。一部の操作は複数のリソースに影響を与えます。たとえば、ノード・プールの作成はノードにも影響します。作業リクエストによって、操作が影響するリソースのリストが提供されます。
詳細は、作業リクエストおよび作業リクエストAPIを参照してください。
ノード・プール作業リクエスト
Kubernetes Engineによって管理されるリソースは、一度に1つの作業リクエストのみをサポートできます。別の作業リクエストの進行中に起動された作業リクエストは失敗し、競合が返されます。一部の操作は他の操作の完了に依存するため、各操作の作業リクエストをモニターして、それが成功したことを確認してから次の操作に進む必要があります。ワークフローでノードが正常に作成され、ノードが「アクティブ」ステータスで登録されると、ノード・プールの作成作業リクエストのステータスは「成功」になります。
作業リクエストのステータス
次の表に、作業リクエストの状態を示します:
|
ステータス |
説明 |
|---|---|
|
受入済 |
リクエストは、処理対象の作業リクエスト・キュー内にあります。 |
|
処理中 |
指定されたリクエストに対して作業リクエスト・レコードが存在しますが、関連付けられたWORK_COMPLETEDレコードは存在しません。 |
|
成功しました |
このリクエストに対して作業リクエスト・レコードが存在し、関連付けられたWORK_COMPLETEDレコードの状態は「成功」です。 |
|
失敗しました |
このリクエストに対して作業リクエスト・レコードが存在し、関連付けられたWORK_COMPLETEDレコードの状態は「失敗」です。 |
|
取消し中 |
作業リクエストは取消中です。 |
|
取消済 |
作業リクエストは取り消されました。 |
作業リクエストを表示するために必要なIAMポリシー
Oracle Cloud Infrastructureを使用するには、管理者が、テナンシ管理者がポリシーでセキュリティ・アクセス権を付与したグループのメンバーである必要があります。コンソールまたは(SDK、CLIまたはその他のツールを使用した) REST APIのどれを使用しているかにかかわらず、このアクセス権が必要です。権限がない、または認可されていないというメッセージが表示された場合は、テナンシ管理者に、どのタイプのアクセス権があり、どのコンパートメントでアクセスが作業する必要があるかを管理者に確認してください。
管理者の場合: 作業リクエストは、作業リクエストを生成する操作の権限を継承します。操作の作業リクエスト、ログおよびエラー・メッセージをユーザーが表示できるようにするには、操作を実行する権限をユーザーに付与するポリシーを記述します。たとえば、起動中のインスタンスに関連付けられている作業リクエストをユーザーが表示できるようにするには、ユーザーがインスタンスを起動できるようにするポリシーを記述します。
ユーザーがテナンシのすべての作業リクエストをリストできるようにするには、次のポリシーを使用します:
Allow group SupportTeam to inspect work-requests in tenancyポリシーを初めて使用する場合は、アイデンティティ・ドメインの管理および共通ポリシーを参照してください。
作業リクエストのリスト
Kubernetes Engine (OKE)を使用して、クラスタまたはノード・プール・リソースの作業リクエストをリストする方法を確認します。
コンソール、CLIおよびAPIを使用して、選択したクラスタまたはノード・プール・リソースの作業リクエストのリストを表示できます。
- 「クラスタ」リスト・ページで、作業リクエストをリストするクラスタの名前を選択します。リスト・ページまたはクラスタの検索に関するヘルプが必要な場合は、クラスタのリストを参照してください。
- クラスタ内の特定のノード・プールの作業リクエストをリストする場合は、「リソース」で「ノード・プール」を選択し、ノード・プールの名前を選択します。
-
「リソース」で、「作業リクエスト」を選択します。
「作業リクエスト」リストには、最近の作業リクエストが表示されます。
クラスタまたはノード・プール・リソースの作業リクエストをリストするには、コマンドライン・インタフェース(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作業リクエスト・リストを参照してください。
ListWorkRequestsメソッドを実行して、クラスタまたはノード・プール・リソースの作業リクエストをリストします。
作業リクエストの詳細の取得
Kubernetes Engine (OKE)を使用して、クラスタまたはノード・プール・リソースに対する作業リクエストの詳細を取得する方法をご覧ください。
コンソール、CLIおよびAPIを使用して、選択したクラスタまたはノード・プール・リソースに対する作業リクエストの詳細を取得できます。
- 「クラスタ」リスト・ページで、作業リクエストの詳細を取得するクラスタの名前を選択します。リスト・ページまたはクラスタの検索に関するヘルプが必要な場合は、クラスタのリストを参照してください。
- クラスタ内の特定のノード・プールの作業リクエストの詳細を取得する場合は、「リソース」で「ノード・プール」を選択し、ノード・プールの名前を選択します。
-
「リソース」で、「作業リクエスト」を選択します。
「作業リクエスト」リストには、最近の作業リクエストが表示されます。
-
「作業リクエスト」リストで、詳細を取得する作業リクエストを検索します。最近の作業リクエストごとに、次の情報を参照できます。
- 操作タイプ:作業リクエストによって実行されている操作。
- ステータス:ステータスとその説明のリストは、「作業リクエスト・ステータス」を参照してください。
- ID:作業リクエストのOCID。
- リソース:リソースの名前。
- 開始時間:作業リクエストが開始されたUTCベースの日時グループ。
- 終了時間:作業リクエストが終了されたUTCベースの日時グループ。
- 特定の作業リクエストを選択して次を表示します。
- ログ・メッセージ:ワークフローのステージおよび各ステージのタイムスタンプに関する情報。
- エラー・メッセージ:エラーおよびエラーのタイムスタンプに関する情報。
- 関連付けられたリソース:作業リクエストの影響を受けるリソースの名前、タイプおよびOCID。
コマンドライン・インタフェース(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を参照してください。
GetWorkRequestメソッドを実行して、クラスタまたはノード・プールの作業リクエストの詳細を取得します。