- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 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 ログを有効化する方法
- ログを手動でクリーンアップする方法
- 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 イメージをクラスター内のレジストリにプッシュする方法
- バックアップからバケットを除外する方法
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- SQL 接続文字列の検証エラー
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- TLS 証明書の検証エラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- RHEL 8.9 でレジストリの一時インストールが失敗する
- オフライン インストール中に uipath 名前空間のデプロイで頻繁に発生する再起動の問題
- DNS 設定が CoreDNS によって受け入れられない
- メモリ不足によりクラスター内レジストリのシーディングが失敗する
- Document Understanding モダン プロジェクトが有効化されていて、AI Center が無効化されている場合、前提条件の確認に失敗します
- Ceph の異常によりアップグレードが失敗する
- 領域の問題のために rke2 が開始しない
- 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 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に 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 の証明書が信頼されない
- 診断ツールを実行する
- Automation Suite サポート バンドルを使用する
- ログを確認する
Automation Suite でサポートされているデプロイ モード、アーキテクチャの概念、ノード トポロジのオプション。
用語
Automation Suite のデプロイで使用される主要な概念について詳しくは、「 用語集」をご覧ください。
デプロイ モードとユース ケース
Automation Suite では、次のデプロイ モードをサポートしています。
| デプロイ モード | 説明 |
|---|---|
| シングルノード | 評価シナリオとデモ シナリオでサポートされています。詳しくは、「 シングルノードの評価のデプロイ」をご覧ください。 また、特定の条件下での生産にも使用できます。詳しくは、「 シングルノードの運用環境のデプロイ」をご覧ください。 |
| マルチノード | 運用環境での使用がサポートされています。次のモードを使用できます。 - ライト モード: 選択的な HA 構成による軽量デプロイ。詳しくは、「 ライト モードのデプロイ」をご覧ください。 - HA モード: HA が完全に有効になります。詳しくは、「 マルチノードの高可用性対応の運用環境のデプロイ」をご覧ください。 |
シングルノード デプロイは、マルチノード デプロイに必要なハードウェアを追加することで、高可用性 (HA) 設定に変換できます。詳しくは、「 シングルノード (評価) デプロイをマルチノード (HA) デプロイにスケーリング する」をご覧ください。
Automation Suite は、Kubernetes に基づくクラウド ネイティブ アーキテクチャを使用しており、Kubernetes が持つ規模、自動リソース管理、信頼性に関するすべてのメリットを提供します。
これらのメリットを提供するために、Kubernetes の設計は以下の基本的な側面に基づいています。
- 複数の奇数個のマシン上で実行されます (3、5、7 など)。
- 定足数の原則を使用して、独立ノードの障害とデータの破損に対処します。N 台のマシンのクラスターにおいて、定足数を満たす N/2 + 1 台のマシンが残っている限り、そのクラスターは機能して適切に回復することができ、障害は観測されません。
デプロイ アーキテクチャ
このページでは、Automation Suite のアーキテクチャに関する洞察を提供し、インストーラーにバンドルされているコンポーネントについて説明します。
ノードの種類
次の図は、Automation Suite のデプロイで利用可能なノードの種類を示しています。
サーバー ノードは、重要なクラスター操作 (ワークロード オーケストレーション、クラスター ステート管理など) を実行し、受信要求を負荷分散するクラスター管理サービス (制御プレーン) をホストします。Kubernetes は、いくつかの UiPath® 製品や共有コンポーネントを、基になるリソースの可用性に基づいて実行することもできます。
エージェント ノードは、UiPath® 製品と共有コンポーネントのみを実行します。
特殊なエージェント ノードは、GPU 機能を必要とする Document Understanding パイプラインや Automation Suite ロボットなどの特別なワークロードを実行します。ただし、Document Understanding のコア サービスや Automation Suite ロボット サービスは、引き続きサーバー ノードまたはエージェント ノードで実行されます。特殊なエージェント ノードは、UiPath® 製品や共有コンポーネントをホストしません。
Automation Suite では、各ノードでどの UiPath® 製品が実行されるかを保証できません。これは Kubernetes によってのみ管理されます。
シングルノードの評価デプロイ
ここでの シングルノードの評価デプロイ とは、シングルサーバー ノードを意味します。これは、Automation Suite 全体を 1 台のマシンにデプロイすることを意味するものではありません。製品スイート全体を単一のサーバー ノードに収められない場合や、GPU 機能を必要とする Document Understanding パイプラインなどの特別なタスクを実行する場合は、エージェント ノードまたは特殊なエージェント ノードの追加が必要になることがあります。
次の図は、シングルノードの評価のデプロイを示しています。
シングルノードの運用環境のデプロイ
シングルノード デプロイは通常、評価シナリオまたはデモ シナリオに使用されます。限られたケースでは運用環境にも使用できますが、次の条件がすべて満たされている場合に限ります。
- UiPath サポート パッケージを購入する必要があります。
- 外部 ObjectStore を使用する必要があります。詳しくは、「外部 ObjectStore を構成する」をご覧ください。
- バックアップを有効化する必要があります。詳細については、「 クラスターをバックアップおよび復元する」をご覧ください。
- 効果的なトラブルシューティングを可能にするには、サポートされている監視ソリューションを設定する必要があります。詳しくは、「 Automation Suite を監視する」をご覧ください。
後でマルチノード デプロイに移行できます。そのためには、新しいサーバー ノードをクラスターに追加し、そのデプロイをマルチノード (HA) デプロイに変換します。詳細な手順については、「 シングルノード (評価) デプロイをマルチノード (HA) デプロイにスケーリング する」をご覧ください。
この構成では高可用性は実現されないため、マルチノード設定を使用できない場合にのみ考慮する必要があります。マルチノードの高可用性対応のデプロイは、引き続き長期的な推奨オプションです。
ライト モードのデプロイ
ライト モードは、インフラストラクチャ リソースから必要な要件が少ない軽量のデプロイです。高い構成可能性により、高可用性が要求されるサービスに柔軟に対応します。既定では、インフラストラクチャと共有コンポーネントは HA モードでデプロイされ、すべてのサービスはライト モードです (水平ポッドの自動スケーリングは、レプリカを 1 つ以上で有効化します)。
特定のサービスを HA モードに切り替えることができます。また、デプロイ後に追加の設定を実行して、完全な HA 機能を設定することもできます。
ライト モードは運用環境で使用できますが、高可用性が有効化されていないサービスを持つことの影響とリスクに注意する必要があります。
マルチノードの高可用性対応の運用デプロイ
マルチノードの高可用性対応の運用環境デプロイでは、ロード バランサーの背後に 3 つ以上のサーバー ノードが必要です。これは、障害発生時にいずれかのサーバー ノードがダウンした場合でも、Automation Suite で重要なビジネス ワークフローを実行できるようにするためです。クラスター内と外部の両方の高可用性をサポートします。エージェント ノードの数は任意であり、実際の使用状況に基づきます。
次の図は、マルチノードの高可用性対応の運用環境のデプロイを示しています。
High Availability Add-on
マルチノード設定では、高可用性 (HA) が既定で有効化されます。ただし、クラスター サービスが使用する Redis ベースのインメモリ キャッシュは単一のポッドで実行され、単一障害点となります。キャッシュ ノードの障害や再起動の影響を軽減するには、冗長性を備えたマルチポッドのキャッシュのデプロイを可能にする High Availability Add-on (HAA) を購入してください。
マルチノード設定で HAA を有効化する方法について詳しくは、「 クラスターの High Availability Add-on を有効化する」をご覧ください。
オンライン デプロイ
オンライン デプロイとは、Automation Suite のインストール時と実行時の両方でインターネットへのアクセスが必要であることを意味します。すべての UiPath® 製品とサポート ライブラリは、UiPath® レジストリ、または UiPath® が信頼するサードパーティ ストアでホストされます。
制限付きのファイアウォールまたはプロキシ サーバーのいずれかを使用して、インターネットへのアクセスを制限できます。この場合、Automation Suite で必要なトラフィック以外の、インターネット上のトラフィックをすべてブロックします。この種類のセットアップは、 半オンライン デプロイとも呼ばれます。詳しくは、「 ファイアウォールを構成する 」および「 プロキシ サーバーを構成する」をご覧ください。
これらの種類のデプロイは、オフライン デプロイと比較して容易で高速であり、インストールおよび管理するハードウェア リソースが少なくて済みます。
次の図は、オンライン デプロイ モデルを示しています。
オフライン デプロイ
オフライン デプロイ (エアギャップ) とは、インターネットへのアクセスがない、完全に分離された設定です。この種類の設定では、UiPath® 製品のすべてのコンテナー イメージとバイナリ (tarball の形式で提供) を保存するレジストリを追加でインストールする必要があります。
次の図は、オフラインのエアギャップ デプロイ モデルを示しています。
レジストリにバイナリをアップロード (ハイドレート) すると、ハードウェア要件が増え、インストールが複雑になり、オンライン デプロイと比較してインストールの実行に必要な時間が長くなります。
オフライン インストールでは、インストール時の複雑さが増すだけでなく、マシンのメンテナンス、障害復旧、新しいバージョンへのアップグレード、セキュリティ パッチの適用などのクラスター管理操作も複雑になります。
インストール後にデプロイ方法を変更することはできません。つまり、インストールをオンラインで行った場合、オフラインに変更することはできません。また、その逆の変更もできません。慎重に検討した上でデプロイ戦略を選択することをお勧めします。
Automation Suite のアーキテクチャ
次の図に、Automation Suite のアーキテクチャを示します。Docker レジストリと S3 互換 ObjectStore は外部でホストすることもできます。
以下の表に、Automation Suite に含まれるサードパーティ コンポーネントのリストを示します。
| コンポーネント | 任意/必須 | 説明 |
|---|---|---|
| RKE2 | Required | Rancher が提供する Kubernetes ディストリビューション。これは、アーキテクチャ コンポーネントとサービスのすべてを実行するコンテナー オーケストレーション プラットフォームです。 |
| CEPH ObjectStore | 任意です。 (外部 ObjectStore がある場合) | Amazon S3 準拠のオブジェクト/BLOB ストレージを公開するオープンソースのストレージ プロバイダーです。 これにより、サービスは BLOB ストレージのような機能を操作に使用できます。 |
| ArgoCD | Required | オープンソースの Kubernetes 用宣言的 CD ツールです。目的とするアプリケーションのステートを定義するための信頼できる情報源として Git リポジトリを使用する GitOps パターンに従います。Kubernetes クラスター内で実行される Automation Suite コンポーネントと UiPath® サービスに対して、アプリケーション ライフサイクル管理 (ALM) 機能を提供します。 |
| Docker レジストリ | 任意です。 (外部レジストリがある場合) | オンプレミスでインストール時および実行時のコンテナー イメージをプッシュおよびプルするために使用するオープンソースの Docker レジストリです。 |
| Istio | Required | Kubernetes クラスター内で実行されるマイクロサービスに対して、Ingress、要求のルーティング、トラフィック監視などの機能を提供するオープンソースのサービス メッシュです。 |
| Prometheus | 任意です。 (組み込みの監視コンポーネントを除外できます) | Kubernetes 向けのオープンソースのシステム監視ツールキットです。Kubernetes コンポーネントからのメトリック、およびクラスター内で実行されるワークロードをスクレイピングまたは受け入れ、それらを時系列データベースに保存します。 |
| Grafana | 任意です。 (組み込みの監視コンポーネントを除外できます) | Prometheus に保存されているデータのクエリと可視化に使用するオープンソースの可視化ツールです。クラスターおよびサービスの監視に使用するさまざまなダッシュボードを作成、提供できます。 |
| Alertmanager | 任意です。 (組み込みの監視コンポーネントを除外できます) | Prometheus サーバーなどのクライアント アプリケーションが送信するアラートの処理を支援するオープンソースのツールです。アラートの重複削除、グループ化、および適切な受信連携 (電子メール、PagerDuty、OpsGenie など) へのルーティングを行います。 |
| Redis | Required | 一部の UiPath® サービスがキャッシュ機能を一元化するために使用する、高可用性 (HA) 非対応 (単一シャード) の Redis Enterprise です。 |
| FluentD と Fluentbit | Required | 信頼性の高いオープンソースのログ スクレイピング ソリューションです。ログ オペレーターは、すべてのノードに対してバックグラウンド プロセスをデプロイおよび構成し、ノード ファイル システムからコンテナーとアプリケーションのログを収集します。 |
| Gatekeeper | Required | Kubernetes の管理者が、クラスターのコンプライアンスとベスト プラクティスを保証するためのポリシーを実装できるようにするオープンソースのツールです。 |
| Velero | 必須1 | スナップショットのバックアップと復元を可能にするオープン ソース ツールです。 |
| Thanos | Required | 永続性を確保するために Prometheus マトリックスを ObjectStore にプッシュするためのオープンソースのツールです。 |
1 バックアップおよび復元時にのみインストールされます。
外部コンポーネント
また、外部ロード バランサーや SQL Server など、いくつかの外部コンポーネントも用意する必要があります。 このスイートには、いくつかの拡張ポイントが用意されています。