- 概要
- 要件
- インストール前
- インストール
- インストール後
- 移行とアップグレード
- 監視とアラート機能
- クラスターの管理
- 製品固有の設定
- トラブルシューティング
- ODF の S3 リクエストに対する 500 エラーとレート制限
- 外部シークレットのトラブルシューティング
- ODF 4.20 の CSI ドライバー トレレーションの設定
- Durable Execution Service troubleshooting
- TLS 証明書の検証が有効化されていると、AI Center と Document Understanding ポッドの起動に失敗する
- デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない
- TLS 証明書の検証エラー
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- uipathctl で作成されたワークロードのリソース要求と制限を設定する
前提条件の確認
uipathctl prereq run を実行して、名前空間スコープのフローを含む、OpenShift の Automation Suite のインフラストラクチャの前提条件を検証します。
Automation Suite のインストールを開始する前に、前提条件の確認を実行してクラウド インフラストラクチャが適切に構成されていることを確認し、 input.json を検証することをお勧めします。
このページでは、以下の内容について説明します。
前提条件の確認を実行する
クラスター スコープのアクセス権を持つ kubeconfig を使用して前提条件チェックを実行します。名前空間のみのスコープ uipathadmin 場合は、代わりに 「クラスター ロールなしで前提条件チェックを実行する 」を実行します。
input.jsonで設定した入力に基づいて前提条件を確認するには、クラスターの Kubernetes API にアクセスできるマシンから次のコマンドを実行します。
uipathctl prereq run input.json --versions versions.json
uipathctl prereq run input.json --versions versions.json
uipathctl prereq run コマンドで使用できるフラグについて詳しくは、「uipathctl prereq run」をご覧ください。
既定では、 uipathctl prereq コマンドはすべての前提条件を確認します。 また、 コマンドを使用して、次のように、お使いの環境に関連するチェックのみを実行することもできます。
- コンポーネントを実行から除外するには、
--excludedフラグを使用します。たとえばデータベースの接続文字列を確認しない場合は、uipathctl prereq --excluded SQLを実行します。このコマンドは、SQL 関連の条件を除くすべての前提条件の確認を実行します。 - 特定のコンポーネントのみを実行時に含めるには、
--includedフラグを使用します。たとえば、DNS と ObjectStore のみを確認する場合は、uipathctl prereq --included DNS,OBJECTSTORAGEを実行します。 - 詳細な前提条件チェックの出力にアクセスするには、
--verboseフラグを使用します。このフラグをスキップすると、より簡潔で簡略化された出力を得ることができます。
前提条件の確認に含められる/除外できるコンポーネントの名前は、「 前提条件の確認」の出力で確認できます。この例では、アウトデントされている各行の最初の単語がコンポーネント名を表しています。例: SQL、OBJECTSTORE、DNS など。
前提条件と健全性のチェック/テストは、 <uipath> 名前空間で実行されます。 <uipath> の名前空間を作成するために必要な権限を uipathctl ツールに付与するか、チェック/テストを実行する前に自分で名前空間を作成する必要があります。さらに、一部のチェック/テストでは、 hostNetworkの使用を有効化する必要があります。
ホスト ネットワークに関連するテストを実行するには、クラスター管理者権限でのツールの実行を許可する必要があります。そうしないと、前提条件の確認の出力に次の警告が表示されます。
Ran CONNECTIVITY checks...
⚠ [CONNECTIVITY]
⚠ [NETWORK_TEST_SETUP] Failed to create the network test infrastructure: failed to create echo-host-role role: error creating role: roles.rbac.authorization.k8s.io "network-prereq-6c5mt-echo-host-role" is forbidden: user "system:serviceaccount:uipath:uipathadmin" (groups=["system:serviceaccounts" "system:serviceaccounts:uipath" "system:authenticated"]) is attempting to grant RBAC permissions not currently held:
{APIGroups:["security.openshift.io"], Resources:["securitycontextconstraints"], ResourceNames:["hostnetwork-v2"], Verbs:["use"]}
Ran CONNECTIVITY checks...
⚠ [CONNECTIVITY]
⚠ [NETWORK_TEST_SETUP] Failed to create the network test infrastructure: failed to create echo-host-role role: error creating role: roles.rbac.authorization.k8s.io "network-prereq-6c5mt-echo-host-role" is forbidden: user "system:serviceaccount:uipath:uipathadmin" (groups=["system:serviceaccounts" "system:serviceaccounts:uipath" "system:authenticated"]) is attempting to grant RBAC permissions not currently held:
{APIGroups:["security.openshift.io"], Resources:["securitycontextconstraints"], ResourceNames:["hostnetwork-v2"], Verbs:["use"]}
前提条件チェックで検証される内容
以下の表に示す確認が各ノードで実行されます。
| チェック | 説明 |
|---|---|
| SQL 接続 | Automation Suite が UiPath® 製品や共有サービス (Identity、ポータル、組織管理など) の SQL Server に input.json ファイルで指定されている SQL 接続文字列を使用して正常に接続できることを検証します。この手順はインストールを正常に完了するために必須です。 |
| SQL DB ロール | UiPath® 製品に必要なロールと権限を検証します。この手順はインストールを正常に完了するために必須です。 |
| SQL DB との相互運用性 | SQL DB の相互運用性の要件を検証します。 |
| FQDN の解決 | FQDN とサブドメインが正常に解決可能であることを検証します。 |
| オブジェクト ストレージ API | input.json ファイルで指定されたアクセス情報に基づいて ObjectStore API にアクセスできることを検証します。この手順は UiPath® サービスのインストールを正常に完了するために必須です。 |
| キャッシュ/Redis | Redis への接続を検証します。 この手順はインストールを正常に完了するために必須です。 |
| 容量 | input.json ファイルで有効化されている製品に基づいて、ワーカー ノードに CPU と RAM の最小容量があることを検証します。 |
| ストレージ クラス | ファイル ストレージのストレージ クラスが Automation Suite ロボットに必要なとおりに設定されていることを検証します。 |
| 任意のコンポーネント | クラスターに、Automation Suite のインストールから除外するコンポーネントがあることを検証します。 |
| Ingress | クラスターの Ingress が正しく構成されていて、FQDN URL 要求が UiPath® 製品に到達できることを検証します。 |
| ネットワーク ポリシー | Automation Suite に設定されているネットワーク ポリシーがクラスターに対応しているかどうかを確認します。 |
| レジストリ | Automation Suite が UiPath® Docker レジストリにアクセスできることを検証します。この手順はインストールを正常に完了するために必須です。 |
| クラスターの接続 | 以下のクラスター通信が適切に設定されているかどうかを検証します。 - 完了した 2 つのランダムなポッド間の通信 - ポッドとマルチノード ClusterIP の間 - ポッドとマルチノード ClusterIP 間の、ClusterIP を使用しない通信 - ポッドとマルチノード ClusterIP の間 (HostNetwork を使用) - ポッドとマルチノード ClusterIP の間 (HostNetwork を使用して ClusterIP が設定されていない) - ClusterIP を介して同じノードに併置された 2 つのポッド間 OpenShift 4.16–4.18 では接続チェックが失敗することがありますポートの競合によるコントロール プレーン ノード。この問題に対処するには、「 トラブルシューティング」 セクションをご覧ください。 |
クラスター ロールなしで前提条件の確認を実行する
このセクションは、Automation Suite インストーラー サービス アカウント (uipathadmin) の名前空間範囲の権限のみを付与し、クラスター範囲の権限を付与していない場合にのみ適用されます。詳しくは、「 クラスター ロールなしでインストール権限を付与する」をご覧ください。
uipathadminがクラスター スコープの権限を持っている場合は、代わりに「前提条件チェックを実行する」の説明に従って前提条件チェックを実行します。
uipathadmin名前空間のみのスコープである場合、固定uipathctl prereq runの一連のチェックは失敗します。これは、クラスター スコープのアクセス (クラスター スコープのリソース (nodes、namespaces、storageclasses、customresourcedefinitionsなど) の読み取り、または接続チェックの場合は hostnetwork-v2 セキュリティ コンテキスト制約を使用する機能のいずれかを必要とするためです。--excluded フラグを使用して、これらのチェックを正確にスキップします。
uipathctl prereq run input.json \
--kubeconfig <uipathadmin.kubeconfig> \
--versions versions.json \
--excluded "INGRESS,NAMESPACE,OSS,StorageClass,NODE,GPU,CONNECTIVITY"
uipathctl prereq run input.json \
--kubeconfig <uipathadmin.kubeconfig> \
--versions versions.json \
--excluded "INGRESS,NAMESPACE,OSS,StorageClass,NODE,GPU,CONNECTIVITY"
チェックを除外しても、基になる要件は削除されません。このプロパティは、正常なインストールに対して引き続き必要です。次の表は、除外された各チェックが検証する内容、必要なクラスター スコープのアクセス、およびクラスター管理者が cluster-admin 権限を持つ kubeconfig を使用して帯域外で確認する必要がある内容を正確に説明します。
| 除外されるトークン | 必要なクラスター スコープのアクセス | チェックで検証される内容 |
|---|---|---|
INGRESS | nodes [list] | Automation Suite の FQDN は、クラスター内のすべてのノードから Istio イングレス ゲートウェイを経由して HTTPS 経由でアクセス可能であること。 |
NAMESPACE | namespaces [get, list] | <argocd>、インストーラー、<uipath>の名前空間が存在し、<uipath>に必要なインジェクション ラベルが付けられていること。 |
OSS | customresourcedefinitions [list] | インストールから除外した独自のコンポーネント (Istio や OPA Gatekeeper など) が存在し、サポートされているバージョンです。 |
StorageClass | storageclasses [get], nodes [list] | input.json のストレージクラスが存在し、実際にワーカーノードにボリュームをプロビジョニングしてマウントできること (チェックにより、テスト StatefulSet が作成され、ボリュームがバインドされてマウントされるまで待機します)。 |
NODE | nodes [list, get]、ノード メトリック | 各ワーカー ノードが CPU と RAM の最小要件を満たし、CPU、メモリ、ポッド数が過剰に使用されていないこと。 |
GPU | nodes [list] | 有効な GPU 製品に対して、利用可能な GPU を持つ十分な数の GPU ラベル付きノードが存在し、最小ノード数は有効になっている GPU 製品によって異なります。 |
CONNECTIVITY | securitycontextconstraints use hostnetwork-v2で ;ホスト ネットワーク テスト ポッドのroles [create] | ポッドは、オーバーレイ ネットワーク上で (ポッド IP によって)、 ClusterIP Serviceを介して、および を使用してノード間で通信できること hostNetwork。 |
除外されたチェックを手動で検証する
チェックを除外した後、クラスター管理者は、cluster-admin 権限を持つ kubeconfig を使用して、除外された各要件を手動で検証する必要があります。
-
INGRESS:すべてのワーカー ノードがReadyされ、イングレス ルートが存在することを確認します。kubectl get nodes -o wide oc get routes -n <istio-system> curl -sko /dev/null -w "%{http_code}\n" https://<fqdn>kubectl get nodes -o wide oc get routes -n <istio-system> curl -sko /dev/null -w "%{http_code}\n" https://<fqdn>インストーラーの
INGRESSチェックでは、クラスター内のすべてのノードで FQDN をプローブし、ゲートウェイが応答した際に (404や OpenShift の503など) 到達可能として扱います。これは、Automation Suite をインストールする前にバックエンドが FQDN を提供するバックエンドがないためです。この段階では200を期待しないでください。上記のcurlコマンドはワークステーションから実行されるため、FQDN がまだ解決されないか、マシンからルーティングされていない場合は、代わりに000出力されることがあります。これはクライアント側の到達可能性を反映しており、それ自体はクラスターの問題ではありません。ここで重要なシグナルは、ワーカー ノードがReadyであり、イングレス ルートが存在することです。 -
NAMESPACE:名前空間が存在し、<uipath>に必要なインジェクション ラベルが付いていることを確認します。kubectl get ns <argocd> <uipath> kubectl get ns <uipath> --show-labelskubectl get ns <argocd> <uipath> kubectl get ns <uipath> --show-labels出力に
istio-injection=enabledとuipath-injection=enabledと表示する必要があります。 -
OSS:CRD が存在すること、Istio がサポート対象のバージョンであること、および構成済みのゲートウェイが実行されていることを確認します。kubectl get crd | grep -E 'istio.io|gatekeeper' istioctl version oc get pods -l istio=ingressgateway -n <istio-system>kubectl get crd | grep -E 'istio.io|gatekeeper' istioctl version oc get pods -l istio=ingressgateway -n <istio-system>Istio のバージョンが 1.14.0 以降であること、および
input.jsonのgateway_selectorが実行中のゲートウェイと一致していることを確認します。 -
StorageClass:ストレージ クラスが存在することを確認します。kubectl get sc <name>kubectl get sc <name>次に、それに対して 1 GiB の
PersistentVolumeClaimを作成し、それをマウントするポッドを作成します。PVC がBoundに達し、ポッドがワーカー ノードで起動することを確認します。これにより、チェックでカバーされているのと同じゾーンとトポロジの互換性が実行されます。 -
NODE:ノードごとに割り当て可能な容量と使用率を確認します。kubectl get nodes -o custom-columns=NAME:.metadata.name,CPU:.status.allocatable.cpu,MEM:.status.allocatable.memory kubectl top nodeskubectl get nodes -o custom-columns=NAME:.metadata.name,CPU:.status.allocatable.cpu,MEM:.status.allocatable.memory kubectl top nodes各ノードには、少なくとも 8 つの CPU と 16 Gi の割り当て可能であり、CPU とメモリの使用率が 80% 未満であることを示す必要があります。Kubernetes クラスターとノードのノード サイジングをクロスチェックします。
-
GPU:GPU ノード数が要件 (Document Understanding モダン プロジェクトの場合は 5 ノード、それ以外の場合は最小ノードなし) を満たしていること、およびそれらのノードで割り当て可能な GPU が利用可能であることを確認します。kubectl get nodes -l nvidia.com/gpu.present=true kubectl get nodes -o custom-columns=NAME:.metadata.name,GPU:.status.allocatable.'nvidia\.com/gpu'kubectl get nodes -l nvidia.com/gpu.present=true kubectl get nodes -o custom-columns=NAME:.metadata.name,GPU:.status.allocatable.'nvidia\.com/gpu'2 番目のコマンドの出力には、0 より大きい値が含まれている必要があります。GPU のサイズ要件については、「 Kubernetes クラスターとノード」をご覧ください。
-
CONNECTIVITY:最も信頼できるオプションは、クラスター管理者が admin kubeconfig を使用してこのチェックのみを実行することです。uipathctl prereq run input.json --versions versions.json --included CONNECTIVITYuipathctl prereq run input.json --versions versions.json --included CONNECTIVITYまたは、異なるワーカー ノード上の 2 つのポッドをスケジュールし、ポッド IP と
ClusterIPServiceを介して相互にアクセスできることを確認します。
これらのチェックを除外しても、基になる要件は削除されません。対応する動作は、実行時にも引き続き必要です。インストールに進む前に、上記の表のすべてのプロパティを検証してください。