- 概要
- 要件
- デプロイ テンプレート
- 手動: インストールを準備する
- 手動: インストールを準備する
- 手順 2: オフライン インストール用に OCI 準拠レジストリを設定する
- 手順 3: 外部 ObjectStore を構成する
- 手順 4: High Availability Add-on を構成する
- 手順 5: SQL データベースを構成する
- 手順 6: ロード バランサーを構成する
- 手順 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 がサポートされた専用のエージェント ノードを追加する
- Task Mining 専用のエージェント ノードを追加する
- Task Mining アプリケーションを接続する
- Automation Suite ロボット専用のエージェント ノードを追加する
- 手順 15: オフライン インストール用に一時的な Docker レジストリを設定する
- 手順 16: インストールの前提条件を検証する
- uipathc を実行する
- 手動: インストールを実行する
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- スタンドアロン製品を Automation Suite に移行する
- 手順 1: スタンドアロンの製品データベースを復元する
- 手順 2: 復元した製品データベースのスキーマを更新する
- 手順 3: Identity 組織データをスタンドアロンから Automation Suite に移動する
- 手順 4: Automation Suite のプラットフォーム データベースをバックアップする
- 手順 5: 組織を Automation Suite にマージする
- 手順 6: 以降済みの製品の接続文字列を更新する
- 手順 7: スタンドアロンの Orchestrator を移行する
- 手順 8: スタンドアロンの Insights を移行する
- 手順 9: スタンドアロンの Test Manager を移行する
- 手順 10: 既定のテナントを削除する
- 単一テナントの移行を実行する
- Automation Suite クラスター間を移行する
- Automation Suite をアップグレードする
- 製品固有の設定
- ベスト プラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バケットに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- TX チェックサム オフロードを無効化する方法
- ArgoCD のログ レベルを手動で Info に設定する方法
- AI Center のストレージを拡張する方法
- 外部レジストリーのエンコードされたpull_secret_valueを生成する方法
- TLS 1.2 で弱い暗号に対処する方法
- TLSのバージョンを確認する方法
- NFS バックアップ ディレクトリの権限を減らす方法
- 証明書の操作方法
- Ceph のバックアップとデータの復元をスケジュールする方法
- レジストリ ポッドから未使用の Docker イメージをクリーンアップする方法
- クラスター内の ObjectStore (Ceph) を使用して DU の使用状況データを収集する方法
- エアギャップ環境に RKE2 SELinux をインストールする方法
- NFS サーバー上の古い差分バックアップをクリーンアップする方法
- FIPS が有効化されたクラスターに Insights をデプロイする方法
- cgroup v2 への移行方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- SQL 接続文字列の検証エラー
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- ウイルス対策が原因でインストールの問題が発生する
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で backlog_wait_time を 0 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- サポート バンドルのログ収集の失敗
- RHEL 8.9 でレジストリの一時インストールが失敗する
- オフライン インストール中に uipath 名前空間のデプロイで頻繁に発生する再起動の問題
- DNS 設定が CoreDNS によって受け入れられない
- 一時レジストリをインストールできない
- メモリ不足によりクラスター内レジストリのシーディングが失敗する
- Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
- Automation Suite 2024.10.0 へのアップグレード後に Automation Hub にアクセスできない
- フック後のインポート中にアップグレードが失敗する
- シングルノードのアップグレードがファブリック ステージで失敗する
- Ceph の異常によりアップグレードが失敗する
- 領域の問題のために rke2 が開始しない
- ボリュームがマウントできず、アタッチ/デタッチ ループ状態のまま
- Orchestrator データベース内のクラシック オブジェクトが原因でアップグレードが失敗する
- Ceph クラスターがサイドバイサイド アップグレード後に機能低下ステートで検出される
- 異常な Insights コンポーネントが原因で移行が失敗する
- Apps のサービス アップグレードの失敗
- インプレース アップグレードのタイムアウト
- Docker レジストリの移行が PVC の削除段階でスタックする
- v2023.10 以降へのアップグレード後に AI Center のプロビジョニングが失敗する
- オフライン環境でアップグレードが失敗する
- アップグレード中に SQL の検証が失敗する
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- Insights の PVC サイズが上書きされたためにアップグレードが失敗する
- Automation Suite 2024.10.1 にアップグレードできない
- Velero の移行の問題によりアップグレードが失敗する
- rook-ceph アプリケーションの削除でアップグレードがスタックする
- 管理ポータルのタイムアウト期間を設定する
- 移行後に認証が機能しない
- 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 へのログインに失敗した
- 基になるディレクトリ接続を更新する
- ロボットが Automation Suite の Orchestrator インスタンスに接続できない
- Automation Suite 2024.10.0 でバックアップの復元に部分的に失敗する
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- FQDN にアクセスすると RBAC アクセス拒否エラーが返されます
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初回インストール後に ArgoCD が進行中ステートになる
- ArgoCD リポジトリ サーバー ポッドが CrashLoopBackOff になる
- Init:0/X でポッドがスタックする
- Ceph-rook のメトリックが監視ダッシュボードに表示されない
- 診断ヘルスチェック中に報告されたエラーの不一致
- アップストリームに正常な問題はありません
- プロキシ設定でログ ストリーミングが機能しない
- オフライン環境でエージェント ノードを追加できない
- サイズの大きい Document Understanding バンドルのアップロード中にノードが応答しなくなる (OOM)
- バックアップ操作が [部分的に失敗] ステータスで失敗する
- Process Mining で高可用性を実行する
- Kerberos を使用してログインすると、Process Mining を取り込むことができなかった
- 障害復旧後、Dapr が 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 サポート バンドルを使用する
- ログを確認する
Linux の Automation Suite のインストール ガイド
証明書を更新する
インストール プロセスによって、ユーザーに代わって自己署名証明書が生成されます。これらの証明書は FIPS 140-2 に対応しており、90 日で有効期限が切れるので、インストールが完了したら速やかに、信頼された証明機関 (CA) によって署名された証明書に置き換える必要があります。証明書を更新しないと、90 日後にインストールが動作を停止します。
Automation Suite を FIPS 140-2 が有効化されたホストにインストールした後で証明書を更新する場合は、その証明書が FIPS 140-2 に対応していることを確認してください。
手順については、「 証明書を管理する」をご覧ください。
FIPS 140-2 を有効化する
GCP のデプロイ テンプレートを使用して Automation Suite のインストールが完了したら、マシンで FIPS 140-2 を有効化できます。手順については、「 セキュリティとコンプライアンス」をご覧ください。
デプロイの出力にアクセスする
デプロイの出力を取得するには、次の手順を実行します。
-
ターミナルを開きます。
-
デプロイ コマンドを実行するディレクトリに移動します。
-
次のコマンドを実行します。
terraform outputterraform output
出力は次の画像のようになります。
出力の定義
この出力により、スイートやクラスターにアクセスするために必要な情報が得られます。
次の表で、値について説明します。
| キー | 説明 |
|---|---|
fqdn | インストールに指定した完全修飾ドメイン名 (FQDN)。必ず DNS 構成時と同じ FQDN を使用してください。 DNS を構成する手順について詳しくは、「 DNS を構成する」をご覧ください。 |
lb_ip | DNS の構成に使用されるロード バランサーの IP アドレスです。 |
bastion_ip | SSH を介してクラスターにアクセスするために必要となる踏み台仮想マシンの IP アドレス。 |
deployment_id | デプロイ内の全リソースの名前に含まれるデプロイ ID。 |
db_credentials | データベースの資格情報を含むシークレットの URL。 |
as_host_credentials | Automation Suite ポータルのホスト組織の資格情報を含むシークレットの URL。 |
as_default_credentials | Automation Suite ポータルのホスト組織の資格情報を含むシークレットの URL。 |
argocd_credentials | インストールされた製品の管理に使用する ArgoCD コンソールの資格情報を含むシークレットの URL。 |
dashboard_monitoring_url | ダッシュボード (Grafana) 監視ツールの URL: https://monitoring.${var.lb_fqdn}/dashboard |
metrics_monitoring_url | メトリック (Prometheus) 監視ツールの URL: https://monitoring.${var.lb_fqdn}/metrics |
alertmanager_monitoring_url | Alertmanager 監視ツールの URL: https://monitoring.${var.lb_fqdn}/alertmanager |
Cluster Administration ポータルにアクセスする
Cluster Administration ポータルは、Automation Suite のインストールを完了し、インストール後に一般的な操作を実行するために必要なすべてのリソースを一元的に確認できる場所です。詳しくは、「 Cluster Administration ポータルの利用を開始する」をご覧ください。
Cluster Administration ポータルにアクセスするには、次の手順に従います。
URL: https://${CONFIG_CLUSTER_FQDN}/uipath-management に移動します。
Cluster Administration ポータルにアクセスするために資格情報は必要ありません。
サービスにアクセスする
サービスにアクセスするには、DNS が構成されている必要があります。詳しくは 、「DNS を構成する」をご覧ください。
目的がテストのみである場合は「クラスターにアクセスするようにクライアント マシンを構成する」の手順に従うこともできます。
自己署名証明書を使用する場合、次の画像のような証明書のエラーが発生する可能性があります。
[ 続行...] を選択し、「 証明書を管理する」の説明に従ってクラスター証明書を更新します。
Automation Suite ポータルにアクセスする
Automation Suite ポータルには https://<fqdn> よりアクセスできます。資格情報は、次の URL で提供されるシークレットにより取得できます。
- ホスト組織の URL:
as_host_credentials - 既定の組織の URL:
as_default_credentials
ArgoCD にアクセスする
ArgoCD コンソールには https://alm.<fqdn> よりアクセスできます。資格情報は、argocd_credentials の URL で提供されるシークレットにより取得できます。
監視ツールにアクセスする
監視ツールに初めてアクセスする場合、管理者として次の既定の資格情報でログインします。
-
ユーザー名: admin
-
パスワード: パスワードを取得するには、 次のコマンドを実行 します。
kubectl get secrets/dex-static-credential -n uipath -o "jsonpath={.data['password']}" | base64 --decodekubectl get secrets/dex-static-credential -n uipath -o "jsonpath={.data['password']}" | base64 --decode
監視ツールへのアクセス時に Dex 認証に使用する既定のパスワードを更新するには、次の手順を実行します。
-
newpasswordを新しいパスワードに置き換えて、次のコマンドを実行します。password="newpassword" password=$(echo -n $password | base64) kubectl patch secret dex-static-credential -n uipath --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"password="newpassword" password=$(echo -n $password | base64) kubectl patch secret dex-static-credential -n uipath --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]" -
次のコマンドを実行して、パスワードを更新します。
./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --versions versions/helm-charts.json
クラスターにアクセスする
-
ターミナルを開き、SSH を使用して踏み台に接続します。
bastion_ipがデプロイの出力に表示されます。ssh -i <path_to_private_key> <username>@<bastion_ip>ssh -i <path_to_private_key> <username>@<bastion_ip> -
踏み台からは、次のコマンドを使用して、SSH を介して他のノードにアクセスできます。ユーザー名は、踏み台への接続に使用したものと同じである必要があります。
<node_address>は、GCP コンソールのInternal IP列に示されています。ssh -i .ssh/private_key <username>@<node_address>ssh -i .ssh/private_key <username>@<node_address>
以下のダッシュボードにクラスターのステートが示されているのがわかります。
ノード数を編集する
GPC コンソールを使用して、次の手順によりノード数 (サーバーまたはエージェント ノード) を編集します。
-
[ Instance Group ] タブで MIG を検索し、変更するノード タイプに対応する MIG を選択します。
-
[編集] を選択します。
-
必要に応じて [インスタンス数 ] フィールドを変更し、[ 保存] を選択します。
デプロイを削除する
デプロイを削除する場合は、次の手順を実行します。
-
ターミナルを開き、テンプレートを解凍したフォルダーに移動します。
-
次のコマンドを実行します。
terraform destroyterraform destroy -
承認を求められたら、
Yesと入力します。