UiPath Documentation
automation-suite
2.2510
true
OpenShift の Automation Suite のインストール ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

前提条件の確認

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 とサブドメインが正常に解決可能であることを検証します。
オブジェクト ストレージ APIinput.json ファイルで指定されたアクセス情報に基づいて ObjectStore API にアクセスできることを検証します。この手順は UiPath® サービスのインストールを正常に完了するために必須です。
キャッシュ/RedisRedis への接続を検証します。 この手順はインストールを正常に完了するために必須です。
容量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 を使用して帯域外で確認する必要がある内容を正確に説明します。

除外されるトークン必要なクラスター スコープのアクセスチェックで検証される内容
INGRESSnodes [list]Automation Suite の FQDN は、クラスター内のすべてのノードから Istio イングレス ゲートウェイを経由して HTTPS 経由でアクセス可能であること。
NAMESPACEnamespaces [get, list]<argocd>、インストーラー、<uipath>の名前空間が存在し、<uipath>に必要なインジェクション ラベルが付けられていること。
OSScustomresourcedefinitions [list]インストールから除外した独自のコンポーネント (Istio や OPA Gatekeeper など) が存在し、サポートされているバージョンです。
StorageClassstorageclasses [get], nodes [list]input.json のストレージクラスが存在し、実際にワーカーノードにボリュームをプロビジョニングしてマウントできること (チェックにより、テスト StatefulSet が作成され、ボリュームがバインドされてマウントされるまで待機します)。
NODEnodes [list, get]、ノード メトリック各ワーカー ノードが CPU と RAM の最小要件を満たし、CPU、メモリ、ポッド数が過剰に使用されていないこと。
GPUnodes [list]有効な GPU 製品に対して、利用可能な GPU を持つ十分な数の GPU ラベル付きノードが存在し、最小ノード数は有効になっている GPU 製品によって異なります。
CONNECTIVITYsecuritycontextconstraints 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-labels
    kubectl 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 nodes
    kubectl 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 CONNECTIVITY
    uipathctl prereq run input.json --versions versions.json --included CONNECTIVITY
    

    または、異なるワーカー ノード上の 2 つのポッドをスケジュールし、ポッド IP と ClusterIP Serviceを介して相互にアクセスできることを確認します。

重要:

これらのチェックを除外しても、基になる要件は削除されません。対応する動作は、実行時にも引き続き必要です。インストールに進む前に、上記の表のすべてのプロパティを検証してください。

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得