Automation Suite
2022.4
偽
- 概要
- 要件
- インストール
- インストール後
- クラスターの管理
- 監視とアラート機能
- 移行とアップグレード
- 製品固有の設定
- ベストプラクティスとメンテナンス
- トラブルシューティング
- インストール時にサービスをトラブルシューティングする方法
- クラスターをアンインストールする方法
- オフライン成果物をクリーンアップしてディスク領域を改善する方法
- Redis データをクリアする方法
- Istio ログを有効化する方法
- ログを手動でクリーンアップする方法
- sf-logs バンドルに保存されている古いログをクリーンアップする方法
- AI Center のストリーミング ログを無効化する方法
- 失敗した Automation Suite インストールをデバッグする方法
- アップグレード後に古いインストーラーからイメージを削除する方法
- Longhorn スナップショットを自動的にクリーンアップする方法
- NIC チェックサムオフロードを無効にする方法
- RHEL 8.4 OS でオフライン インストールを実行できない
- バンドルのダウンロード中のエラー
- バイナリがないため、オフライン インストールが失敗する
- オフライン インストールでの証明書の問題
- Longhorn のセットアップ中に最初のインストールが失敗する
- SQL 接続文字列の検証エラー
- selinux iscsid モジュールの前提条件の確認が失敗する
- Azure ディスクが SSD としてマークされない
- 証明書の更新後のエラー
- OS のアップグレード後に Automation Suite が動作しない
- Automation Suite で Backlog_wait_time を 1 に設定する必要がある
- ワークロードの準備ができていないためボリュームをマウントできない
- インストールおよびアップグレード中に RKE2 が失敗する
- 管理ポータルのタイムアウト期間を設定する
- 基になるディレクトリ接続を更新する
- 移行後にログインできない
- Kinit: Cannot Find KDC for Realm <AD Domain> While Getting Initial Credentials
- kinit: Keytab contains no suitable keys for *** while getting initial credentials
- GSSAPI operation failed with error: An invalid status code was supplied (Client's credentials have been revoked).
- Alarm received for failed kerberos-tgt-update job
- SSPI Provider: Server not found in Kerberos database
- Login Failed for User <ADDOMAIN><aduser>.Reason: The Account Is Disabled.
- ArgoCD へのログインに失敗した
- サンドボックス イメージを取得できない
- ポッドが ArgoCD UI に表示されない
- Redis プローブの障害
- RKE2 サーバーの起動に失敗する
- UiPath 名前空間でシークレットが見つからない
- 初期インストール後、ArgoCD アプリが Progressing ステートになる
- MongoDB ポッドが CrashLoopBackOff になるか、削除後に PVC プロビジョニングの保留中になる
- Unexpected inconsistency; run fsck manually
- クラスターの復元後に MongoDB またはビジネス アプリケーションの機能が低下する
- self-heal-operator および sf-k8-utils リポジトリが見つからない
- クラスターの復元またはロールバック後にサービスが異常になる
- RabbitMQ ポッドが CrashLoopBackOff でスタックする
- Prometheus が CrashloopBackoff ステートでメモリ不足 (OOM) エラーを伴う
- 監視ダッシュボードに Ceph-rook メトリックが表示されない
- Automation Suite 診断ツールを使用する
- Automation Suite サポート バンドル ツールを使用する
- ログを確認する
Orchestrator の構成を更新する
Automation Suite インストール ガイド
最終更新日 2024年4月24日
Orchestrator の構成を更新する
Orchestrator の構成を更新します。以下を確認してください。
UiPath.Orchestrator.dll.config
のカスタム構成- すべての
web.config
設定 - ストレージ (パッケージ、実行メディア、バケット データ) - ほとんどが
Storage.Type=FileSystem
に適用可能 - カスタムの NLog ターゲット
- カスタムの資格情報ストア
- テナント構成ごとの暗号化キー
提供されている Orchestrator 構成ツールを使用することによって、以下の手順の多くを簡略化できます。
orchestrator_configurator.sh
bash ツールでは Orchestrator のカスタム構成マップを更新し、Orchestrator の既知の BLOB ストレージの場所にファイルをアップロードできます。提案されたアクションの確認をスキップするには、-y
パラメーターを使用します。
レンズや kubectl などのツールを使用して、
orchestrator-customconfig
構成マップを編集します。
values.json
ファイル内で要求の制限を設定します。この設定を変更すると、Orchestrator のデプロイが自動的に再実行されます。
{
"Kestrel": {
"Limits": {
"MaxRequestBodySize": 314572800
}
}
{
"Kestrel": {
"Limits": {
"MaxRequestBodySize": 314572800
}
}
移行前の手順で編集した
appSettings.custom.json
ファイルに、appSettings
セクションで必要なすべてのカスタマイズが含まれます。orchestrator-customconfig
構成マップ内のこの .json
ファイルを、values.json
ファイルの appSettings
キーの下に配置する必要があります。
{
"ExampleSetting.Enabled": true,
"ExampleSetting.Type": "BasicExample",
"ExampleSetting.Count": 3
}
{
"ExampleSetting.Enabled": true,
"ExampleSetting.Type": "BasicExample",
"ExampleSetting.Count": 3
}
Orchestrator 構成ツールは、カスタム appSettings 内のキーを構成マップ内に既に存在するキーとマージできます。
-c|--app-settings
パラメーターを使用してアプリの設定をアップロードできます。
./orchestrator-configurator.sh -c appSettings.custom.json
./orchestrator-configurator.sh -c appSettings.custom.json
構成ツールを使用している場合は、すべての手順を実行して必要な appSettings の上書きをすべて集め、最後に 1 回スクリプトを実行します。
ローカルの FileStore を使用しており、既存のストレージ コンテンツを Orchestrator にアップロードする必要がある場合は、
/var/orchestator/data
パスの任意の Orchestrator ポッドにそれらのコンテンツを配置してください。
Orchestrator 構成ツールでは、
kubectl cp
で -s|--storage-folder
パラメーターを使用してファイルをアップロードできます。
./orchestrator-configurator.sh -s blobstoragefolder
./orchestrator-configurator.sh -s blobstoragefolder
スクリプトを実行すると、
storage
フォルダーの内容が /var/orchestrator/data
フォルダーの内容になります。
ネットワーク FileStore を使用するには、Orchestrator ArgoCD アプリのパラメーターを編集し、以下を設定します。
storage.type = smb
storage.smb.domain
storage.smb.password
storage.smb.source
storage.smb.username
storage.smb.size
他のストレージ オプションを構成するには、Orchestrator ArgoCD アプリのパラメーターを編集し、以下を設定します。
- 目的のプロバイダー (Azure、AWS、Minio) に対する
storage.type
storage.connectionString
Orchestrator アプリのストレージ設定の概要:
Orchestrator による Amazon や Azure のストレージ バケットへの Web ブラウザー アクセスは、プロバイダー側の同一オリジン ポリシーにより制限される可能性があります。このようなバケットのコンテンツに正常にアクセスするには、Orchestrator からのクロス オリジン要求を許可するように各プロバイダーを設定する必要があります。
Orchestrator からのクロス オリジン要求を許可するように各プロバイダーを構成する方法については、こちらをご覧ください。
NLog 拡張機能をインストールするには、
uipath
バケット内の Ceph
にこれらをコピーする必要があります。これで、起動時に Orchestrator ポッドがこれらを読み込むようになります。また、nlog.json
ファイルの orchestrator-customconfig
に構成を配置することも必要です。
構成ツールでこれを実行するには、
-n|--nlog-extensions-folder
パラメーターと -l|--nlog-config-file
パラメーターを使用します。
./orchestrator-configurator.sh -n nlogextensions -l nlog.custom.json
./orchestrator-configurator.sh -n nlogextensions -l nlog.custom.json
プラグインは、ローカル パス
/var/orchestrator/plugins/nlog
にある Orchestrator ポッドで入手できます。構成ツールによって assemblyFile のパスが自動的に更新され、そのパスの先頭にプラグインのパスが付加されます。
資格情報ストアの構成変更は
appsettings.custom.json
に含まれているため、構成の更新は必要ありません。
手動で変更を加えるには、appSettings セクションにある
orchestrator-customconfig
の values.json
ファイル内にこれらを配置します。
Secure Store のアセンブリも必要な場合は、
/var/orchestrator/plugins/securestore/
パスにある任意の Orchestrator ポッド内にそれらを配置する必要があります。
これは、Orchestrator 構成ツールで、
-p|--securestore-plugins-folder
パラメーターを使用して実行できます。
./orchestrator-configurator.sh -p securestoreplugins
./orchestrator-configurator.sh -p securestoreplugins
暗号化キーを設定するには、
APPSETTINGS__EncryptionKey
の値を上書きして、暗号化キーを Kubernetes シークレット orchestrator-generated-secrets
内で置き換えます。これを行うには、次のコマンドを実行します。ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"
ENCRYPT_KEY=$(echo <key>|base64 -w 0)
kubectl -n uipath patch secret orchestrator-generated-secrets --type='json' \
-p="[{'op': 'replace', 'path': '/data/APPSETTINGS__EncryptionKey', 'value':'$ENCRYPT_KEY'}]"
注: 必ず、
<key>
を UiPath.Orchestrator.dll.config
から取得したキーの値に置き換えてください。