- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 7: DNS を構成する
- 手順 8: ディスクを構成する
- 手順 9: カーネルと OS レベルの設定を構成する
- 手順 10: ノード ポートを構成する
- 手順 11: その他の設定を適用する
- 手順 12: 必要な RPM パッケージを検証してインストールする
- 手順 13: cluster_config.json を生成する
- Cluster_config.json のサンプル
- 全般的な構成
- プロファイル構成
- 証明書の設定
- データベースの構成
- 外部 ObjectStore の構成
- 署名済み URL の構成
- ArgoCD の構成
- Kerberos 認証の構成
- 外部の OCI 準拠レジストリの設定
- Disaster Recovery - アクティブ/パッシブおよびアクティブ/アクティブの構成
- High Availability Add-on の構成
- Orchestrator 固有の設定
- Insights 固有の構成
- Process Mining 固有の構成
- Document Understanding 固有の構成
- Automation Suite ロボット固有の構成
- 監視の構成
- 任意: プロキシ サーバーを構成する
- 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する
- 任意: カスタムの Resolv.con を渡す
- 任意: フォールト トレランスを向上させる
- GPU がサポートされた専用のエージェント ノードを追加する
- Automation Suite ロボット専用のエージェント ノードを追加する
- 手順 15: オフライン インストール用に一時的な Docker レジストリを設定する
- 手順 16: インストールの前提条件を検証する
- uipathc を実行する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- NFS バックアップ ディレクトリの権限を減らす方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- Ceph の読み取り専用モードから移行する
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- TLSのバージョンを確認する方法
- 証明書の操作方法
- Ceph のバックアップとデータの復元をスケジュールする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- FIPS が有効化されたクラスターに Insights をデプロイする方法
- cgroup v2 への移行方法
- 仮想マシンの再起動後に Kerberos 認証を回復する方法
- ローカルの Docker イメージをクラスター内のレジストリにプッシュする方法
- バックアップからバケットを除外する方法
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- TLS 証明書の検証エラー
- ウイルス対策によりインストールと操作に問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- RHEL 8.9 でレジストリの一時インストールが失敗する
- オフライン インストール中に uipath 名前空間のデプロイで頻繁に発生する再起動の問題
- DNS 設定が CoreDNS によって受け入れられない
- メモリ不足によりクラスター内レジストリのシーディングが失敗する
- Document Understanding モダン プロジェクトが有効化されていて、AI Center が無効化されている場合、前提条件の確認に失敗します
- XFS ボリュームマウントの失敗により Pod が Init 状態でスタックする
- Rancher と etcd ディスクのマウント順序が正しくないため、再起動後にクラスターのデータが失われるように見える
- Ceph の異常によりアップグレードが失敗する
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- オフライン環境でアップグレードが失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- Insights の PVC サイズが上書きされたためにアップグレードが失敗する
- 大文字のホスト名が原因でアップグレードが失敗する
- 管理ポータルのタイムアウト期間を設定する
- 移行後に認証が機能しない
- Kinit: Cannot find KDC for realm <AD Domain> while getting initial credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- 無効なステータス コードが原因で GSSAPI 操作が失敗した
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- アカウントが無効なため AD ユーザーのログインに失敗した
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- 初回インストール後に ArgoCD が進行中ステートになる
- ArgoCD リポジトリ サーバー ポッドが CrashLoopBackOff になる
- 手動による ArgoCD ネットワーク ポリシーの軽減策 (GHSA-47m3-95c7-g2g8)
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- 診断ヘルスチェック中に報告されたエラーの不一致
- uipathctl で作成されたワークロードのリソース要求と制限を設定する
- アップストリームに正常な問題はありません
- Redis の起動がウイルス対策によってブロックされる
- TLS 証明書の検証が有効化されていると、AI Center と Document Understanding ポッドの起動に失敗する
- Fluentd では、IPv6 環境ではログはエクスポートされません
- デスクトップ版の Studio では Integration Service のコネクタとアクティビティを読み込めない
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- pyodbc 形式の接続文字列を使用して AutomationSuite_ProcessMining_Warehouse データベースに接続できない
- Airflow のインストールが「sqlalchemy.exc.ArgumentError: Could not parse rfc1738 URL from string ''」で失敗する
- SQL Server ポート 1433 を使用する IP テーブル ルールを追加する方法
- CData Sync を実行しているサーバーの Automation Suite の証明書が信頼されない
- Process Mining を無効化してから再度有効化すると、読み込みに失敗する
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
ネットワーク要件
Automation Suite のネットワーク要件 (IPv6、デュアルスタック、外部依存関係のサポートなど)
Automation Suite は、IPv6 およびデュアルスタック構成をサポートしています。
シングルスタック IPv4 からデュアルスタックまたはシングルスタック IPv6 への移行はサポートされていません。SQL、Redis、オブジェクト ストレージ、外部 DNS などのすべての外部依存関係で、有効な IP ファミリがサポートされている必要があります。
IPv6 またはデュアルスタック構成
IPv6 またはデュアル スタックを有効化するには、cluster_config.json ファイルの network パラメーターを設定して、Automation Suite で IPv4、IPv6、またはその両方を使用するかどうかを指定する必要があります。
次のように設定できます。
-
デュアルスタック構成: Automation Suite サービスとイングレス コンポーネントに対する IPv4 と IPv6 の両方の通信を可能にします。次の例を使用して、デュアルスタックネットワークを設定できます。
"network": { "ipv4": { "enabled": true }, "ipv6": { "enabled": true } }"network": { "ipv4": { "enabled": true }, "ipv6": { "enabled": true } } -
シングルスタック IPv6 設定: IPv6 のみの通信を有効化し、IPv4 を無効化します。次の例を使用して、シングルスタック IPv6 ネットワークを設定できます。
"network": { "ipv4": { "enabled": false }, "ipv6": { "enabled": true } }"network": { "ipv4": { "enabled": false }, "ipv6": { "enabled": true } }
Integration Service の一部のコネクタでは IPv6 がサポートされていない場合があります。この機能を有効化する前に、使用するコネクタのプロバイダーのドキュメントと認証要件を確認して、IPv6 がサポートされていることを確認してください。
ファイアウォールを使用する
firewalld はサポートされていません。Automation Suite インストーラーは、インストール中に firewalld を自動的に無効化します。インストール後も firewalld が無効化のステートのままになっていることを確認してください。
Automation Suite では、必要なノード間通信のために、ホスト マシン上に既定の IP テーブル ルールが設定されます。firewalld を介して設定されるようなカスタム IP テーブル ルールは、Automation Suite によって設定される IP テーブル ルールと競合する可能性があるため、サポートされません。ただし、ネットワーク レベルで追加のファイアウォール ルールを適用することは可能です。
IP テーブルの変更は推奨されておらず、サポートもされていません。
ファイアウォール アプリケーションは、クラスター間ではなくネットワーク ゲートウェイで有効化することをお勧めします。
オンライン環境でトラフィックを許可する
このページでは、オンライン デプロイでさまざまな UiPath® 製品、コンポーネント、および連携に使用されるドメインのリストを示します。これらのドメインとの間でのトラフィックを許可する必要があります。そうしないと、Automation Suite が正常に機能しない可能性があります。
使用する UiPath® の製品およびサービスのエンドポイントとポートを、許可リストに追加してください。たとえば AI Center を所有していなければ、それに必要なドメインを許可リストに追加する必要はありません。
一般的な要件
クラスターの安定性を確保するには、お使いの環境が次の要件を満たしている必要があります。
- ノード間の往復時間 (RTT) は最小限 (<10 ms RTT) である必要があります。
- 高可用性の要件を満たしている必要があります。
インストール
-
必要なインストーラー ファイルと構成スクリプトをダウンロードする場合:
https://download.uipath.com
-
コンテナー イメージおよびメタデータをダウンロードする場合:
-
https://registry-data.uipath.com -
https://registry.uipath.com上記の URL は、インストール時、既存のクラスターへの新しいノードの追加、新しいバージョンへのアップグレード、ArogCD を使用したアプリケーションの同期時に必要です。 これらの URL は、Kubernetes がイメージをプルできるようにするために、実行時に必要になる場合もあります。
-
-
サポート バンドルの生成や診断ツールなどの、サポート機能ツールを使用する場合:
https://sfbrprddeploywe.azurecr.iohttps://sfbrprddeploywe.westeurope.data.azurecr.io
-
Kubernetes または RKE2 のインストールの場合:
https://rpm.rancher.io
-
UiPath® にビジネス テレメトリを送信する場合:
https://dc.services.visualstudio.com
UiPath® へのテレメトリ データの送信を選択した場合にのみ必要です。
共有プラットフォーム機能
Automation Suite ポータル
-
Azure Active Directory との連携の場合:
https://login.microsoftonline.com/*
-
(オプション)Application Insights の場合:
https://dc.services.visualstudio.com/*
Identity
-
Azure Active Directory との連携の場合:
https://login.microsoftonline.com/*https://graph.microsoft.com/*
-
SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
-
Redis 接続の場合: Redis のデプロイ時に生成されるポート番号とパスワード
-
Active Directory との連携の場合:
- Kerberos: ポート
88 - LDAP エンドポイント: ポート
389 - DC 検出のための DNS: ポート
53
- Kerberos: ポート
-
SAML 認証の場合: Automation Suite 用に構成された SAML エンドポイント
-
システムのメール通知の場合: Automation Suite 用に構成された SMTP サーバーおよびポート
-
接続時の証明書の検証で、CRL をダウンロードする必要がある場合: 証明書によって特定されるエンドポイント
Webhook
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
- Orchestrator Webhook の定義でユーザーが定義した HTTP(S) Webhook エンドポイント
組織管理
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
- Ceph との連携の場合: インフラストラクチャの設定時に接続が生成されます。
監査
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
ライセンス
-
オンラインでのライセンスのアクティベーション、更新、およびその他のオンライン ライセンス操作の場合:
https://activate.uipath.com/
-
SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
-
Redis 接続の場合: Redis のデプロイ時に生成されるポート番号とパスワード
Orchestrator
-
Automation Suite は、インストール時にシードされたアクティビティ パッケージを使用して、Orchestrator 内からホスト ライブラリ フィードを提供し、アウトバウンド アクセスは必要ありません。代わりに 、ライブラリ フィードが UiPath® のオフィシャル フィードをポイントする場合は、以下を許可します。
https://pkgs.uipath.com/official/index.jsonhttps://pkgs.dev.azure.com/uipath/Public.Feeds/_packaging/UiPath-Official/nuget/v3/index.json
pkgs.uipath.comは公式フィードの新しいアドレスであり、Azure DevOps でホストされているアドレスを置き換えます。デプロイが両方を移行する間は、両方を許可します。発表されたフィードの移行日については、「 非推奨化のタイムライン」をご覧ください。
Test Manager
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
- Webhook コネクタを介した HTTP(S) 呼び出し
- Xray for Jira (オンプレミスまたはクラウド)、ServiceNow、AzureDevOps への HTTP(S) 呼び出し
AI Center
-
SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
-
すぐに使えるモデルおよびメタデータは UiPath の GitHub リポジトリから取得され、モデル自体は UiPath のストレージ アカウントからダウンロードされます。すぐに使えるモデルのスケジューラーは継続的に実行されるため、以下の URL はブロックできません。また、最後の 3 つの URL は実行時に必要です。以下の URL にアクセスできることを確認してください。
-
追加される新しいモデルをすぐに使えるモデルのメタデータが取得できるようにするには、以下の URL へのアクセスが必要です。
https://github.comhttps://raw.github.comhttps://raw.githubusercontent.comhttps://api.github.com
-
ダウンロードした新しいモデルのクローンを作成するために必要です。
https://uipath.blob.core.windows.net
-
依存関係をダウンロードするためのスキルのデプロイおよびトレーニング パイプラインでは、実行時に以下の URL へのアクセスが必要です。
-
Python パッケージインデックス:
http://pypi.python.org/http://pypi.org/
-
モデル パッケージと
requirements.txtで必要とされる Python ライブラリに基づく、Python PIP によってホストされるパブリック ドメイン
-
-
-
https://du-metering.uipath.com注:この URL は、AI Center が外部 Orchestrator に接続されている場合にのみ必要です。
-
https://du.uipath.com
Document Understanding
-
SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
-
OCR の場合:
-
リージョンに適用できる UiPathDocumentOCR エンドポイント
-
Microsoft OCR (任意): リージョンに適用できるエンドポイント
-
Google OCR (任意):
https://vision.googleapis.com/v1/images:annotate
-
-
データ抽出の場合: リージョンに適用できる FormExtractor エンドポイント
-
https://du-metering.uipath.com注:この URL は、AI Center が外部 Orchestrator に接続されている場合にのみ必要です。
-
https://du.uipath.com
Insights
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
Data Service
- SQL 接続の場合: 使用する接続 (パイプライン経由の場合もあり)
ランタイム URL の依存関係
-
https://activate.uipath.com -
smtp.sendgrid.net(または SMTP サーバーを構成するもの)- ポート レベルのブロックを考慮する必要があります。
- SMTP サーバーに関連付けられた TLS または SSL 証明書は、オフライン環境外で CRL を取得しなくても検証できる必要があります。
-
https://dc.services.visualstudio.com/v2/track
Azure の依存関係
Azure インフラストラクチャを使用する場合は、このセクションに示されている Azure 用の RHEL yum ミラーを許可する必要があります。
これらの URL は Azure のみに適用されます。別のクラウド サービス プロバイダー (CSP) を使用する場合、URL は異なります。
-
http://rhui-1.microsoft.com -
http://rhui-2.microsoft.com -
http://rhui-3.microsoft.com -
Azure Active Directory との連携の場合:
https://login.microsoftonline.com/*https://graph.microsoft.com/*
ドキュメント
Automation Suite およびバンドルされている製品の UiPath® 公式ドキュメントにユーザーがアクセスできるようにするには、ドキュメント固有の URL も許可する必要があります。完全なリストについては、「 UiPath® ドキュメントの Web サイト URL」をご覧ください。