uipathctl で作成されたワークロードのリソース要求と制限を設定する

uipathctl で作成されたワークロードのスケジュールまたは完了に失敗した場合に CPU とメモリの要求と制限を調整する方法。

説明

uipathctl コマンドを実行すると、そのコマンドによって作成された Kubernetes ワークロードが、CPU またはメモリの要件のために失敗することがあります。

次のいずれかの症状が発生する場合があります。

• ポッドは Pending ステートのままであり、そのイベントに Insufficient cpu または Insufficient memoryが含まれます。
• ポッドが OOMKilled ステータスで終了します。
• ワークロードが CPU 調整されているか、コマンドがタイムアウトする前に完了しません。
• アドミッションポリシーは、ポッドのリソース要求または制限が名前空間で設定されている ResourceQuota または LimitRange に準拠していないため、ポッドを拒否します。

この問題は、前提条件の確認、健全性チェック、サポート バンドルの生成、移行、Helm 操作、アップグレードに使用される、uipathctl で作成されたワークロードに影響する可能性があります。

解決策

まず、影響を受けるポッドを特定し、そのイベントを調べます。

kubectl get pods -A
kubectl describe pod <pod-name> -n <namespace>

報告された状態に応じて、以下を行います。

• OOMKilledの場合は、メモリ制限を増やします。また、利用可能なメモリー数が多いノードでポッドをスケジュールする必要がある場合は、メモリー要求も増やします。
• Insufficient cpu または Insufficient memoryの Pending ポッドの場合、要求を減らすのは、より少ない保証容量でワークロードを安全に実行できる場合のみです。それ以外の場合は、クラスターの容量を追加します。
• クォータまたは制限範囲のエラーの場合は、ターゲット名前空間で設定されているポリシーに準拠する要求と制限を指定します。
• 低速なワークロードや CPU 調整が調整されているワークロードの場合は、CPU の制限を引き上げます。

リソース要件は、 input.json で変更することも、1 つのコマンドで上書きすることもできます。

input.json でリソース要件を設定する

uipathctl はワークロードを次のリソース クラスにグループ化します。

クラス	操作	既定の要求 (CPU/メモリ)	既定の制限 (CPU/メモリ)
diagnostic	健全性チェックと読み取り専用検証プローブ	50m / 64Mi	250m / 256Mi
operational	前提条件の確認、サポート バンドル、Helm 操作、ID データの移行	1m / 1k	2 / 2Gi
workload	オブジェクト ストア、PVC、MongoDB の移行、およびファイル サーバーのアップグレード	250m / 512Mi	2 / 2Gi

Automation Suite の構成を使用するコマンドの既定値を変更するには、 に workload_resources を追加します input.json。たとえば、データ量の多い移行ワークロードで利用可能なリソースを増やすには、次の構成を使用します。

{
  "workload_resources": {
    "workload": {
      "requests": {
        "cpu": "500m",
        "memory": "1Gi"
      },
      "limits": {
        "cpu": "2",
        "memory": "4Gi"
      }
    }
  }
}

diagnostic、operational、workload の各クラスは個別に設定できます。変更する値のみを指定することもできます。省略された CPU またはメモリの値は、既定値を保持します。

要求は、対応する制限を超えることはできません。CPU には 500m や 1 、メモリには 256Mi や 1Gi など、標準的な Kubernetes リソースの量を使用します。

1 つのコマンドのリソース要件のオーバーライド

--probe-cpu オプションと --probe-memory オプションを公開するコマンドの場合、そのコマンドによって作成されたヘルパー ポッドのリソース要件を上書きできます。以下に例を示します。

uipathctl health check --probe-cpu 500m --probe-memory 512Mi

各オプションは、指定されたリソースの要求と制限の両方を設定します。1 つのオプションのみを指定すると、もう一方のリソースで有効値が保持されます。

オプションは、次のコマンドで使用できます。

• uipathctl health check
• uipathctl health test
• uipathctl health diagnose
• uipathctl config add-host-admin
• uipathctl config enable-basic-auth
• uipathctl service aicenter sync-skills
• uipathctl service aicenter sync-skill-status
• uipathctl service orchestrator notifications-migration start

両方の設定方法が適用される場合、 uipathctl では次の順序で値が解決され、後の値が優先されます。

1. 組み込みの既定値です。
2. input.jsonまたは適用されているクラスター構成のworkload_resources値。
3. コマンド ライン オプションとして [ --probe-cpu ] または [ --probe-memory ] を使用します。

リソース要件を更新した後、影響を受けるコマンドを再度実行して、uipathctl で作成されたワークロードが正常に開始することを確認します。

ワークロードを完了できる最小の要求と制限を設定します。要求が大きすぎるとスケジュールが妨げられ、制限が低すぎると調整や終了が発生する可能性があります。