- Linux の Automation Suite のリリース ノート
- EKS/AKS の Automation Suite のリリース ノート
Automation Suite リリース ノート
公開日: 2024 年 4 月 25 日
ライセンス関連のテナント制限の変更
以下のいずれかのサービスを含むライセンスをお持ちの場合は、ライセンスを更新すると、100 個のテナントそれぞれでこれらのサービスを有効化できるようになりました。
- Automation Hub
- Process Mining
- Test Manager
- Insights
公開日: 2023 年 11 月 22 日
UiPath.OrganizationMigrationApp の新しいバージョンが公開
UiPath.OrganizationMigrationApp の新しいバージョンをリリースしました。このツールはスタンドアロン製品から Automation Suite への移行に役立ちます。新しいバージョンでは、Automation Suite v2023.10.0 に移行できるようになりました。
詳しくは、「スタンドアロン製品を Automation Suite に移行する」をご覧ください。
公開日: 2023 年 11 月 3 日
更新内容
Kerberos 認証の変更
追記 (2024 年 8 月 14 日): CLI ツールを使用した Kerberos 認証の更新はサポートされなくなりました。または、「 cluster_config.json を介して Kerberos 認証を構成する」に示す方法を使用して Kerberos 認証を更新できます。
インストール エクスペリエンスの効率化
インストール エクスペリエンスを刷新し、オンライン/オフライン、シングルノード/マルチノードのいずれのインストール モードでも、同様の手順が共有され、共通のコマンドを活用できるようにしました。この改良は、より一貫性のあるシームレスなインストール エクスペリエンスをすべてのユーザーに提供することを目的としています。
対話型インストーラーは、現在は少し異なる目的で使用されています。このインストーラーは cluster_config.json ファイルを生成するためにのみ使用でき、実際のインストールは実行できません。
詳しくは、以下のドキュメントをご覧ください。
サイドバイサイド アップグレードの導入
並列クラスターを使用して Automation Suite のアップグレードを実行できるようになりました。この新しいアップグレード方法はサイドバイサイド アップグレードと呼ばれ、古い Automation Suite クラスター (業界ではブルー デプロイと呼ばれることが多い) から新しいクラスター (グリーン デプロイ) にトラフィックを切り替えることができます。この方法のメリットの 1 つは、現在の環境がアップグレード操作の影響を全く受けないことです。さらに、アップグレード中に問題が発生した場合は、古いデプロイに簡単にロールバックできます。
詳細な要件、アップグレード マトリクス、手順については、「サイドバイサイド アップグレードを実行する」をご覧ください。
サイドバイサイド アップグレードは効率的で、ワークフローの運用を中断するリスクが少ないため、Automation Suite インスタンスのアップグレードに推奨される方法です。
インプレース アップグレードの強化
サイドバイサイド アップグレード メカニズムの代わりに、インプレース アップグレードを使用して Automation Suite のバージョンを移行することもできます。過去に Automation Suite をアップグレードしたことがある場合は、この方法をよくご存じのはずです。
このアップグレード プロセスに固有の点は、設定とデータを同一のハードウェア上で完全な状態で維持できることです。使用されるクラスターは 1 つだけです。つまり、前のステートに戻す場合は、バックアップと復元の操作に頼る必要があります。
このアップグレード メカニズムはこれまでも使用されていた方法ですが、今回のリリースではこのメカニズムの複雑さが大幅に軽減されました。インプレース アップグレードは、オンラインとオフラインの両方のシナリオで同一となりました。さらに、以前はアップグレード プロセスを自動または手動のどちらで行うかを選択する必要がありましたが、新しくなったアップグレード フローではこの区別は関係ありません。つまり、すべてのユーザーに対して単一の指示が適用されます。この改良の結果、オートメーションのアップグレードの実行にこれまで使用されていた uipathctl.sh ツールが削除されました。
詳細な要件、アップグレード マトリクス、手順については、「インプレース アップグレードを実行する」をご覧ください。
Linux の Automation Suite から EKS/AKS の Automation Suite への移行
Linux の Automation Suite を既に使用しているものの、EKS/AKS の Automation Suite のほうが自社のニーズに適していると考えるユーザーに朗報があります。EKS/AKS の Automation Suite の新しいインストールに移行できるようになりました。
ただし、現在のところ、埋め込みの Automation Suite から EKS/AKS 上の Automation Suite の既存インストールに移行することはできません。
要件、必要なデータ移行操作、ステップバイステップの手順について詳しくは、「Linux の Automation Suite から EKS/AKS の Automation Suite に移行する」をご覧ください。
Longhorn の削除による安定性と品質の向上
安定性と品質を向上させるため、Longhorn に代わるメカニズムを実装しました。この変更の概要は、データとボリュームがサーバー マシンにアタッチされたディスクと直接連携するというもので、以下のようないくつかの影響があります。
- Insights、Docker レジストリ、監視アプリケーションが、サーバー ノードでのみ実行されるようになりました。
- Insights に対して外部 ObjectStore バケットを構成できるようになりました。詳しくは、「外部 ObjectStore の構成」をご覧ください。
- NFSv3 のサポートが追加されました。
- Longhorn から移行せずにアップグレード プロセスが完了すると、バックアップから復元されたクラスターには Longhorn が含まれなくなります。
- AI Center のパイプラインには追加のストレージが必要になりました。このパイプラインは、追加の AI Center ディスクがマウントされているマシン (サーバー マシンまたはエージェント マシンのいずれか) で動作します。
uipathctl のご紹介
CLI ツールを統一する取り組みの一環として、uipathctl をご紹介します。現在、この新しいツールの主な目的は、Automation Suite のインストールに影響する問題の診断とトラブルシューティング、サイドバイサイド アップグレードの実行、Linux の Automation Suite から EKS/AKS の Automation Suite への移行、外部の OCI 準拠のレジストリへの移行、および cluster_config.json ファイルの生成を支援することです。
今後、他の多くのシナリオでも uipathctl が頼りになるツールになります。ご期待ください。
署名付き URL を使用しない ObjectStore へのアクセス
署名付き URL を介したアクセスを無効化できる機能が導入され、外部 ObjectStore に対する権限が強化されました。
この設定を一度有効化すると元に戻せなくなり、グローバルに適用されますのでご注意ください。個々の製品レベルでの変更はできません。
この特定の設定では、Task Mining、および特定のアクティビティ ( [ストレージ テキストを書き込み]、[ストレージ ファイルをアップロード]、[ストレージ ファイルのリストを取得]、[ストレージ テキストを読み込み]、[ストレージ ファイルをダウンロード]、[ ストレージ ファイルを削除]) はサポートされていない点を考慮してください。
外部 Docker レジストリの改良機能
外部 Docker レジストリを大幅に改良しました。新機能のメリットは以下のとおりです。
- 外部の Docker レジストリにプライベート証明書を備えて、セキュリティをさらに強化できます。
- ミラー レジストリ スクリプトでは Automation Suite の成果物をコピーするためにインターネットへのアクセスが必要ですが、これに加えて、
hydrate-registry.shスクリプトがサポートされるようになりました。このスクリプトは、オフラインの tar バンドルを使用してそれを解凍し、中身を外部 Docker レジストリに直接アップロードします。このため、レジストリを管理する選択肢を柔軟に選択できるようになりました。
ネットワーク アクセスに制限がある顧客向けのオフライン バンドルの分割
ネットワーク アクセスに制限があるユーザーに対応するため、分割 as.tar.gz ファイルを導入し、オフライン インストールの実行に使用できるようにしました。このオフライン バンドルは、ダウンロードしやすいように 52 のパーツに分割されており、すべてのパーツがダウンロードされると再構築できます。
ただし、完全な as.tar.gz ファイルを一度にダウンロードするオプションも、十分な帯域幅を持つユーザーに対して引き続き利用可能です。
分割ファイルをダウンロードして結合する方法について詳しくは、公式ドキュメントをご覧ください。
RHEL のサポート対象のバージョンの追加
Red Hat Enterprise Linux (RHEL) 8.8 を実行するマシンに Automation Suite をインストールできるようになりました。
RHEL kernel version kernel-4.18.0-477.10.1.el8_8 は、Automation Suite クラスターのインストールまたは管理を中断させる問題の影響を受けます。どの Automation Suite ノードも、インストール前またはインストール後にこのバージョンのカーネルを使用していないことを確認してください。以下のコマンドを実行するとカーネルのバージョンを更新できます。
dnf install -y kernel kernel-tools kernel-tools-libs
dnf install -y kernel kernel-tools kernel-tools-libs
SELinux のサポート
Automation Suite のすべてのバージョンで、すぐに使える SELinux がサポートされており、既定のポリシーが有効化されています。
IMDSv2 のサポート
インスタンス プロファイルを使用して AWS S3 に接続できるよう、IMDSv2 がサポートされました。
ArgoCD UI ドキュメントの非推奨化
ベスト プラクティスに確実に従い操作の安定性を維持するため、UiPath では設定やパラメーターを変更する手段として ArgoCD UI の使用を避けることにしました。
代わりに、そういった目的には cluster_config.json ファイルを使用することを強くお勧めします。この変更は、信頼できる情報源の一貫性を構成に対して確保することを目的としています。
ただし、トラブルシューティング、ログの表示、その他の同様の操作に対しては引き続き ArgoCD UI を使用できます。
Kerberos 認証の構成に関する変更
追記 (2024 年 8 月 17 日): Kerberos 認証の構成プロセスを更新しました。configureUiPathAS.sh スクリプトや CLI ツールを使用する代わりに、cluster_config.json ファイルを使用して認証を構成できるようになりました。詳しくは、「 cluster_config.json を介して Kerberos 認証を構成する」をご覧ください。
ライセンスに関するニュース
監査ログのメッセージの変更
管理者によってユーザーが削除され、そのライセンスの割り当てが解除された場合に表示される監査データのメッセージを改良して分かりやすくしました。「User <administrator_name> deallocated all licenses of user(s) <user_names>」というメッセージが表示されるようになりました。
AI Unit の割り当て
AI Unit をテナント レベルでも割り当てられるようになりました。この操作は [管理] セクションで、目的のテナントに対応するライセンスの割り当てウィンドウから実行します。
ライセンス割り当てエンドポイント
API からライセンスを割り当てるための 2 つの新しいエンドポイントを追加しました。
GET/api/account/{accountId}/user-license/group/{groupId}- グループの作成または編集に利用可能なすべてのユーザー ライセンスのリストを取得するには、このエンドポイントを呼び出します。- このエンドポイントを使用するには、ライセンス の [表示] 権限が必要です。
PUT/api/account/{accountId}/user-license/group/{groupId}- グループ ルールの割り当てまたは更新をするには、このエンドポイントを呼び出します。- このエンドポイントを使用するには、ライセンス の [書き込み] 権限が必要です。
Citizen Developers ユーザー グループ
プラットフォームのアクセス制御機能として、新しいユーザー グループ「Citizen Developers」を追加しました。この新しいグループは組織レベルで定義され、プラットフォーム内のすべてのサービスとシームレスに連携します。
Citizen Developers グループでは、市民開発者が不要なアクセス権に混乱させられず、業務に関連するリソースにアクセスできるため、管理者の負担が軽減されます。
このユーザー グループがプラットフォームのさまざまなサービスにどのように連携するかについて詳しくは、製品ドキュメントをご覧ください。
AAD のカスタム属性マッピング
既存の AAD との連携では自動属性マッピングが提供されていますが、このリリースでは、組織がカスタム属性マッピングを使用する機能が導入されました。
事業部門属性のカスタム マッピングのサポートを開始しました。これにより、組織部門などの属性を UiPath® Platform の「事業部門」フィールドにマッピングできます。このマッピングにより、組織内のユーザーのコンテキストの理解が深まり、ユーザー ID を Automation Hub などのサービスと連携させることができます。
事業部門属性は、Azure AD 属性に基づいて、または SAML を介してマッピングできます。
Deployment Assistant のサポート終了
Deployment Assistant のサポートを終了します。これにより、より大きなメリットをもたらすツールの開発や改良を集中して進めることができます。
公式ドキュメントを詳しく確認して既存のツールや機能を理解することを、すべてのユーザーに対して推奨します。公式ドキュメントに関するフィードバックをお寄せください。皆さまのご意見は、ユーザーのニーズに最適なサービスを提供するための、製品の継続的な改良や調整のために不可欠です。
改良点
トラブルシューティングのユーザー エクスペリエンスの向上
Automation Suite のトラブルシューティングとデバッグに役立つ新しい CLI ツールを導入しました。新しいツールは uipathtools と呼ばれ、健全性コマンドに固有の uipathctl 機能のサブセットが含まれています。軽減手順にタイムリーにアクセスできるように、標準リリースよりも高い頻度で uipathtools の更新プログラムを提供する予定です。
uipathtools と uipathctl の CLI ツールでは、以前の Automation Suite 診断ツール diagnostics-report.sh (現在は提供されていない) に含まれていたすべての診断機能を利用できます。
SSO 認証の改良
ArgoCD のシングル サインオン (SSO) を有効化する手順を更新しました。現在は、Dex 構成ファイルと指定したパラメーターを使用する必要があります。
詳しくは、こちらのドキュメントをご覧ください。
バグ修正
- 追記 (2024 年 1 月): レプリカのクリーンアップ スクリプトによって、ノード上のストレージが誤って再利用されていました。詳しくは、トラブルシューティングに関するドキュメント「ストレージ再利用パッチ」をご覧ください。
- 以前は、スケジュールされたバックアップとオンデマンド バックアップの両方が、1 時間のタイムアウト後に失敗していました。現在は、タイムアウト期間を 3 時間に延長できるようになりました。詳細については、「スナップショットのバックアップを有効化する」と「スナップショットのオンデマンド バックアップ」をご覧ください。
configureUiPathAS.shスクリプトで ODBC 接続文字列が正しく更新されなかったり読み取られなかったりすることがありました。現在、この問題は修正されています。- 最初の実行から 90 日後に Automation Suite インストーラーを再実行しようとすると、エラーが発生していました。インストーラーは、有効期間が 90 日間の自己署名証明書を生成し、それが再実行されたときに、既に期限が切れている証明書については再検証を求めていました。
管理者のバグ修正
- Automation Express ライセンスはクラウド環境専用ですが、オンプレミスのデプロイでも割り当てが可能になっていました。この問題は現在は修正されました。
- Action Center - Named User ライセンスを持つ組織には、Data Service ユニットが付与されていませんでした。この問題は現在は修正されました。
- 組織を削除しても、そのライセンスは解放されませんでした。現在は、組織が削除されると、その組織に割り当てられていたライセンスはすべてライセンス プールに戻ります。
- 構成マップの NLog 設定
minLevelが適用されていませんでした。既定のminLevelは、重要度が「Info」以上のログが記録されることを示す「Info」です。にもかかわらず、minLevelの設定が適用されておらず、重要度レベルが低い「Trace」や「Debug」のログも書き込まれていました。 - 以前は、セキュリティ グループを取得するときに既知の SID が誤って含まれ、予期しない動作が発生するという問題がありました。セキュリティ グループを取得するときに既知の SID が含まれることがなくなり、よりスムーズで予測可能な機能が保証されます。
- v2022.10.1 以降にアップグレードした後に、ホスト テナントにログインしてからログアウトし、その後で別のテナントに切り替えると、選択したテナントではなく、以前のログアウト場所にリダイレクトされていました。現在は、ログアウトしてテナントを切り替えた後は、以前のログアウト場所ではなく、選択したテナントのページに正しくリダイレクトされるようになりました。
既知の問題
FIPS 140-2 のサポートの制限
追記 (2026 年 1 月 22 日): Insights は、FIPS 140-2 が有効化されたマシンで実行される Automation Suite のデプロイではサポートされていません。FIPS 140-2 の要件への準拠を維持するには、Insights を無効化する必要があります。
詳しくは、「 セキュリティとコンプライアンス」をご覧ください。
Insights の PVC サイズが上書きされたことによるアップグレードの失敗
追記 (2024 年 12 月 18 日): 問題が発生し、既存の Insights の PVC サイズが誤って上書きされると、アップグレードが失敗します。この問題を解決するには、ArgoCD UI で PVC のサイズを手動で変更する必要があります。詳しくは、「 トラブルシューティング」 セクションをご覧ください。
この問題は、 Automation Suite 2023.10.7 で修正されています。
Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
追記 (2024 年 12 月 18 日): Automation Suite をバージョン 2023.4 以前からアップグレードした後に Insights を再インストールまたはアップグレードすると、Insights のストレージ クラスの変更に伴う問題によりデータが失われます。この問題に対処するには、「 トラブルシューティング」をご覧ください。
Automation Suite 2023.10.7 の問題を修正しました。
非 HA Redis でのノード メンテナンスの問題
追記 (2024 年 12 月 18 日): ある問題により、HA Redis 以外のシナリオでノードのドレインを実行すると、 redis-cluster-0 ポッドが終了ステートでスタックします。この問題を解決するには、次のコマンドを使用してポッドを強制的に削除する必要があります。
kubectl -n redis-system delete pod redis-cluster-0 --force
kubectl -n redis-system delete pod redis-cluster-0 --force
Automation Suite 2023.10.7 の問題を修正しました。
アクティブ/パッシブ チェック中の不要な Redis DNS 解決の検証
追記 (2024 年 12 月 18 日): ある問題により、アクティブ/パッシブの前提条件の確認時に、 redis.<primary-fqdn> と redis-db.<primary-fqdn> の Redis DNS 解決の検証が不必要に行われます。この問題は、 Automation Suite 2023.10.7 で修正されています。
Insights の注釈、課題がブロックされる、インストーラー
追記 (2024 年 12 月 18 日): Insights のアノテーションに関する問題により、Automation Suite インストーラーがブロックされます。Automation Suite 2023.10.7 の問題を修正しました。
追加ノードでの RKE2 サービスの意図しないアップグレード
追記 (2024 年 11 月 26 日): 最初のサーバー以外のノードでは、/etc/yum.conf ファイルにexclude= rke2-*が追加されない問題を特定しました。特定の環境 (特にオンライン環境) では、すべてのコンポーネントをアップグレードしようとすると、最初のサーバー以外のノードで RKE2 サービスが意図せずアップグレードされる可能性があります。
この問題を修正するには、Automation Suite クラスターのすべてのノード上の /etc/yum.conf ファイルに手動で exclude=rke2-*を追加する必要があります。
サイドバイサイド アップグレード中に AI Center のスキルの同期が失敗する
追記 (2024 年 12 月 18 日): 構文の問題により、サイドバイサイド アップグレード中に aicenter skill sync コマンドと aicenter skill status コマンドが失敗します。
この問題を修正するには、構文を手動で編集する必要があります。詳しくは、「 トラブルシューティング」 セクションをご覧ください。
Test Automation SQL の接続文字列は無視されます
追記 (2024 年 10 月 17 日): cluster_config.json ファイルの orchestrator.testautomation セクションで SQL 接続文字列を指定すると、uipathctl バイナリでは接続文字列が無視され、代わりに orchestrator セクションの接続文字列が使用されます。この問題を解決するには、「 トラブルシューティング」 セクションをご覧ください。
ノード ラベルの設定中にインストールが失敗する
追記 (2024 年 10 月 17 日): IMDSv2 のみが有効化されている AWS マシンに Automation Suite をデプロイすると、ノード ラベルの入力中にインストールが失敗します。この問題を解決するには、「 任意: マルチノードの HA 対応の運用クラスターにおけるゾーン障害に対する復元設定を有効化する」の「重要」の注をご覧ください。
システム アップグレード名前空間でジョブが失敗したためアップグレードできない
追記 (2024 年 10 月 17 日): Automation Suite のアップグレードは、 system-upgrade 名前空間に失敗したジョブが存在するため失敗します。アップグレード コマンドがいずれかの段階 (インフラ、ファブリック、またはサービスのアップグレード) で失敗した場合は、アップグレードを再試行する前に次の手順を実行します。
-
system-upgrade名前空間の既存のジョブをリスト表示します。kubectl get jobs -n system-upgradekubectl get jobs -n system-upgrade -
失敗したジョブを削除します。
kubectl -n system-upgrade delete jobs <failed_jobs>kubectl -n system-upgrade delete jobs <failed_jobs>
コマンドの実行時に、 <failed_jobs> プレースホルダーを、失敗したジョブの名前をスペースで区切って置き換えます。
Automation Suite 2023.10.6 の問題を修正しました。
プロキシ環境でポッドが FQDN と通信できない
追記 (2024 年 10 月 17 日): プロキシ環境で、プロキシ サーバーが Istio サービス メッシュ内の他のサービスの TCP ポート (ポート 8080 など) と同じポートを使用すると、ポッドは FQDN と通信できません。この問題により、次のエラーが発生します。
System.Net.Http.HttpRequestException: The proxy tunnel request to proxy 'http://<proxyFQDN>:8080/' failed with status code '404'.
System.Net.Http.HttpRequestException: The proxy tunnel request to proxy 'http://<proxyFQDN>:8080/' failed with status code '404'.
この問題を修正するには、「トラブルシューティング」セクションをご覧ください。
TLS 1.2 の弱い暗号
追記 (2024 年 8 月 29 日): TLS 1.2 での脆弱な暗号の使用に関連する特定の脆弱性を確認しました。この問題を軽減する方法について詳しくは、「 TLS 1.2 で脆弱な暗号に対処する方法」をご覧ください。
サポート バンドルのログ収集の失敗
追記 (2024 年 8 月 14 日): オフライン環境で外部 OCI レジストリを使用する場合に、サポート バンドルの生成に影響する問題があります。このような状況下では、生成されたサポート バンドルには履歴ログがないため、選択した外部オブジェクト ストレージにアップロードできません。この問題を修正するには、「 トラブルシューティング」 セクションをご覧ください。
外部 ObjectStore に対して不要な ListBucket API の前提条件の確認が失敗する
追記 (2024 年 8 月 14 日): AI Center および Task Mining で外部 ObjectStore を使用すると、 ListBucket API 前提条件の確認が失敗します。ただし、AI Center と Task Mining では ListBucket API 権限は使用されません。Automation Suite 2023.10.5 で不要なチェックを削除しました。
ArgoCD の SSO を有効化できない
追記 (2024 年 8 月 14 日): Dex イメージのバージョンに問題があるため、ArgoCD の SSO を有効化できません。Automation Suite 2023.10.5 の問題を修正しました。
アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
追記 (2024 年 8 月 14 日): ある問題により、アップグレード後も snapshot-controller-crds ポッドが CrashLoopBackOff ステートのままになります。これは、RKE2 のアップグレード中に、新しくインストールした snapshot-controller と既存の が競合するために発生します。この問題を修正するには、「 トラブルシューティング」 セクションをご覧ください。
クラスター内の ObjectStore から外部 ObjectStore への移行が失敗する
追記 (2024 年 8 月): クラスター内の ObjectStore から外部 ObjectStore への移行が、構成の問題により失敗します。したがって、このバージョンの Automation Suite では、Ceph のクラスター内 ObjectStore から外部 ObjectStore への移行を試みてはなりません。Automation Suite 2023.10.2 の問題を修正しました。Ceph から外部 ObjectStore に安全に移行できます。
プロキシ環境で外部オブジェクト ストレージを使用するとコンポーネントが失敗する
追記 (2024 年 7 月 24 日): プロキシ環境で外部ストレージを使用すると、Orchestrator、Automation Suite サポート バンドル ツール、Prometheus、Thanos、Fluentd などが失敗します。Automation Suite 2023.10.3 の問題を修正しました。
Azure Government 上の AKS に対して誤った FQDN で生成されたサポート バンドル
サポート バンドルの生成時に、Azure Government 上の AKS に誤った FQDN が使用されます。 Automation Suite 2023.10.4 の問題を修正しました。
Airflow のネットワーク ポリシーが原因で DNS が正しく機能しない可能性があります
追記 (2024 年 6 月 3 日): まれに、Airflow のネットワーク ポリシーにより DNSが正しく機能しない場合があります。この問題を回避するには、次のコマンドを実行します。
sudo networkPolicyTool.sh --createNetworkPolicy ./Configs/networkPolicyTool/airflow.yaml --add
sudo networkPolicyTool.sh --createNetworkPolicy ./Configs/networkPolicyTool/airflow.yaml --add
ネットワーク ポリシー ツールをインストールするには、トラブルシューティングの記事「 Network Policy Tool」の手順に従います。この問題は、Automation Suite 2023.10.3 で修正されています。
シングルノードのアップグレードがファブリック ステージで失敗する
追記 (2024 年 5 月 20 日): クラスター内のストレージを使用するシングルノード デプロイでバージョン 2022.4.1 以前からのアップグレードを行うと、rook-ceph の移行の問題により、ファブリックの段階で失敗します。この問題を回避するには、「シングルノードのアップグレードがファブリック ステージで失敗する」の手順に従ってください。
CephMgrIsAbsent のアラートに関する問題
追記 (2024 年 4 月 19 日): ストレージに問題がなくても、CephMgrIsAbsent の誤検知アラートが表示されます。この問題は、Automation Suite 2023.10.3 で修正されています。
S3 ObjectStore への移行後に rook-ceph をアンインストールする際のエラー メッセージ
追記 (2024 年 4 月 19 日): rook-ceph をアンインストールする際に、外部オブジェクト ストレージの構成が見つからないことに関するエラー メッセージが表示されます。この問題は、移行が成功しても発生します。この動作は、Automation Suite 2023.10.3 で修正されています。
Ceph のメトリックとアラートに影響する問題
追記 (2024 年 4 月 19 日): 特定の状況下で、Ceph のメトリックとアラートが監視ダッシュボードに表示されないことがあります。この問題を修正するには、「トラブルシューティング」セクションをご覧ください。
SQL Server と SQL データベースの照合順序の違いがサポートされない
追記 (2024 年 2 月 28 日): ストアド プロシージャで SQL Server と SQL データベースの照合順序の違いがサポートされていません。潜在的な問題を回避するには、SQL Server と SQL データベースの両方の照合順序の設定を同一にする必要があります。
MongoDB から SQL Server への移行によりアップグレードが失敗する
追記 (2024 年 2 月 28 日): Automation Suite 2022.10 以前から Automation Suite 2023.10.0 以降へのサイドバイサイド アップグレードおよびインプレース アップグレードに影響する問題を特定しました。MongoDB から SQL Server への移行に問題があるため、Apps を有効化した状態で SQL Server データベースに Kerberos 認証を使用すると、アップグレード操作が失敗します。
追記 (2025 年 4 月 15 日): 解決策として、 Automation Suite 2023.10.9 にアップグレードすることを推奨します。
既存の Automation Suite に新しい製品を追加する際にインストールが失敗する
追記 (2024 年 2 月 28 日): Automation Suite の既存のインストールに新しい製品を追加しようとすると、一時レジストリを指定するようインストーラーによって誤って要求され、インストール プロセスが失敗します。
この問題を解決するには、次の回避策を適用してください。
-
一時レジストリが稼働していることを確認します。
-
次のコマンドを実行して、Docker レジストリ StatefulSet の readinessProbe 設定を変更します。
kubectl patch statefulset docker-registry -n docker-registry --type json -p '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"httpGet":{"scheme":"HTTPS", "path": "/", "port": 5000}}}]'kubectl patch statefulset docker-registry -n docker-registry --type json -p '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"httpGet":{"scheme":"HTTPS", "path": "/", "port": 5000}}}]'
政府機関向けクラウド ストレージへのログ転送に影響する問題
追記 (2023 年 12 月 19 日): Fluentd および Fluent Bit のログを Azure および AWS の政府機関向けクラウド ストレージに転送することはできません。
Splunk を使用し、そちらでアプリケーション ログを転送することをお勧めします。
オフライン インストール実行後のゾンビ プロセス
追記 (2023 年 12 月 19 日): オフライン インストールの実行後、Docker レジストリの Readiness Probe によってゾンビ プロセスがトリガーされます。
この問題を解決するには、v2023.10.0 のオフライン インストールを実行した後に次のコマンドを実行して、既存の Readiness Probe を更新します。この手順は、オンライン インストールでは不要です。
kubectl patch statefulset docker-registry -n docker-registry --type json -p '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"exec":{"command":["sh","-c", "[ -f /var/lib/registry/ready ] || { echo \"Registry is not seeded\"; exit 1; } "]}}}]'
kubectl patch statefulset docker-registry -n docker-registry --type json -p '[{"op": "replace", "path": "/spec/template/spec/containers/0/readinessProbe", "value": {"exec":{"command":["sh","-c", "[ -f /var/lib/registry/ready ] || { echo \"Registry is not seeded\"; exit 1; } "]}}}]'
障害復旧後 Dapr が Process Mining と Task Mining で正しく機能しない
障害復旧後、Dapr が正常に復元されず、Process Mining と Task Mining のサービスを提供するために Dapr が必要とする証明書が正しくありません。dapr、processmining、および taskmining アプリケーションは、最初は正常であるように見えますが、その後は進行中ステートに戻り、環境が不安定になります。Process Mining または Task Mining にログインしても、アプリケーションが読み込まれなかったり、予期しないエラーが返されたりすることがあります。
問題を解決するために必要な手順について詳しくは、「Process Mining のトラブルシューティング」をご覧ください。
Document Understanding のすぐに使えるパッケージのバージョンが見つからない
特定の状況下で、すぐに使えるパッケージのインストーラーが失敗することがあります。失敗した場合、一部の ML パッケージのバージョンが Document Understanding に表示されなくなります。これを修正するには、ArgoCD の同期をトリガーするか、ArgoCD の同期によってインストーラーが自動的にトリガーされてパッケージが再インストールされるのを待ちます。
Document Understanding の接続文字列を設定する際に使用できない文字がある
構成ファイルで接続文字列を手動で設定する場合、PYODBC では Document Understanding データベースのパスワードの先頭に { を使用できません。
v2023.10 へのアップグレード後に AI Center をプロビジョニングできない
v2023.4.3 から v2023.10 にアップグレードすると、AI Center のプロビジョニングで問題が発生します。
システムに「"exception":"sun.security.pkcs11.wrapper.PKCS11Exception: CKR_KEY_SIZE_RANGE」という例外が表示され、テナントの作成が失敗します。
この問題を解決するには、ai-trainer のデプロイで、ロールアウトの再起動を実行する必要があります。これを行うには、次のコマンドを実行します。
kubectl -n uipath rollout restart deploy ai-trainer-deployment
kubectl -n uipath rollout restart deploy ai-trainer-deployment
Kerberos keytab ローテーションでトークンの再生成がトリガーされない
追記 (2025 年 9 月 24 日): 問題が発生し、Kerberos keytab のローテーションで認証トークンがすぐには再生成されず、サービスとデータベース間の接続が一時的に中断する可能性があります。
この問題を解決するには、次のコマンドを実行して、Kerberos チケットの更新 cronjob を手動でトリガーする必要があります。
kubectl delete job tgt-rotate-manual -n uipath --ignore-not-found ; kubectl create job tgt-rotate-manual --from=cronjob/kerberos-tgt-update -n uipath
kubectl delete job tgt-rotate-manual -n uipath --ignore-not-found ; kubectl create job tgt-rotate-manual --from=cronjob/kerberos-tgt-update -n uipath
Automation Suite 2023.10.11 の問題を修正しました。
ユーザー割り当てマネージド ID を使用すると Orchestrator が起動しない
追記 (2025 年 9 月 24 日): 問題により、オブジェクト ストレージにユーザー割り当てマネージド ID を選択するときに storage.useClientID パラメーターを設定できません。このため、アクセスがユーザー割り当てマネージド ID に制限されている環境では Orchestrator を起動できません。
この問題を解決するには、ArgoCD で次のようにパラメーターを手動で設定する必要があります。
- ArgoCD Orchestrator アプリケーションで、[ 詳細 ] > [パラメーター] に移動します。
- [値] テキスト ボックスで [
storage.isExternal : true] を設定し、保存します。
Automation Suite 2023.10.11 の問題を修正しました。
Thanos コンパクターは破損したブロックで停止します
追記 (2025 年 9 月 24 日): ある問題により、Thanos コンパクターは、オブジェクトストアで破損したブロックを検出すると、メトリクスの圧縮を停止します。これにより、コンパクションが防止され、ストレージの使用量が増加します。
この問題に対処するには、「トラブルシューティング」セクションをご覧ください。
Automation Suite 2023.10.11 の問題を修正しました。
オフライン環境でエージェント ノードの追加に失敗する
追記 (2025 年 6 月 26 日): 問題が発生し、オフライン環境でのエージェント ノードの追加プロセスが失敗します。エージェント ノードを追加するには、一時レジストリが実行されている必要があります。この問題を解決するには、一時レジストリを再度有効化して、エージェント ノードに正常に参加させる必要があります。
Automation Suite 2023.10.10 の問題を修正しました。
大きなポリシー OID を持つ CA 証明書が原因でインストールが失敗する
追記 (2025 年 6 月 26 日): 4 バイトを超えるポリシー OID 値が含まれる CertificatePolicies セクションを含む証明機関 (CA) 証明書を使用すると、Automation Suite のインストールが失敗します。この問題により、Automation Suite がこれらの CA 証明書を認識できず、インストール プロセスが中断されます。
この問題に対処するには、 CertificatePolicies セクション内のポリシー OID 値が 4 バイトを超えないようにするか、証明書に CertificatePolicies セクションを追加する CA ジェネレーターを使用しないようにする必要があります。
Automation Suite 2023.10.10 の問題を修正しました。
ライセンス SQL 接続エラー
追記 (2025 年 6 月 26 日): ライセンス SQL 接続エラーは、[データ ソース] プロパティで名前付きインスタンスとポートの両方が指定されている場合に発生します。
Automation Suite 2023.10.10 の問題を修正しました。
Grafana ダッシュボードのエラー
追記 (2025 年 6 月 10 日): マルチノード (HA) 設定では、Grafana は 2 つのレプリカで実行されますが、レプリカ間に共通のデータ ソースがないため、ユーザー セッション管理で問題が発生します。Dashboard not foundやInvalid dashboard UID in the requestなどのエラーが Grafana ダッシュボードに表示されます。
回避策として、Grafana は重要なアプリケーションではないため、次の手順を実行してレプリカの数を 1 に減らすことができます。
-
fabric-installerアプリケーションの helm パラメーターを変更します。これにより、fabric-installerアプリケーションの同期操作が自動的にトリガーされます。kubectl patch application fabric-installer -n argocd --type='json' -p='[{"op": "add", "path": "/spec/source/helm/parameters/-", "value": {"name": "global.rancherMonitoring.grafana.replicas", "value": "1"}}]'kubectl patch application fabric-installer -n argocd --type='json' -p='[{"op": "add", "path": "/spec/source/helm/parameters/-", "value": {"name": "global.rancherMonitoring.grafana.replicas", "value": "1"}}]' -
ArgoCD UI から
rancher-monitoringアプリケーションを同期します。
この問題は、Automation Suite 2023.10.7 で修正されています。
uipathctl health check コマンド
追記 (2025 年 5 月 21 日): 外部 Docker レジストリを使用したオフラインの Automation Suite インストールの場合、既知の問題により uipathctl の健全性チェックコマンド が機能しません。この問題は、 Automation Suite 2023.10.6 で修正されています。
回避策として、Automation Suite 2023.10.6 から uipathctl バイナリをダウンロードし、それを使用して uipathctl の健全性チェック コマンドを実行します。
Kubernetes のアップグレードの失敗
追記 (2025 年 4 月 15 日):deployment.appsにcertificate-injector-webhookがないために問題が発生し、Kubernetes のアップグレードが失敗します。この問題を解決するには、次のコマンドを実行する必要があります。
kubectl delete configmap -n uipath-infra certificate-injector-webhook-configmap --ignore-not-found
kubectl delete configmap -n uipath-infra certificate-injector-webhook-configmap --ignore-not-found
Automation Suite 2023.10.9 の問題を修正しました。
アップグレード後の Document Understanding のデプロイに関する問題
追記 (2025 年 4 月 15 日): ある問題により、Automation Suite 2023.10.x にアップグレードすると、AI Center の DM セッションにファイルをインポートできなくなります。この問題は、古いバージョンの Automation Suite の du-digitizer-worker デプロイがアップグレード後に完全にはクリーンアップされていないために発生します。Automation Suite 2023.10.0 より、デプロイの名前が du-digitizer-worker-deploymentに変更されました。
この問題を解決するには、ArgoCD UI に移動し、 documentunderstanding アプリケーションから古い du-digitizer-worker デプロイを手動で削除する必要があります。削除後、 documentunderstanding アプリケーションを再同期します。
Automation Suite 2023.10.8 の問題を修正しました。
Docker レジストリのクリーンアップ プロセスが不完全です
追記 (2025 年 4 月 15 日): レジストリのクリーンアップ コマンドでは、未使用の Docker イメージをすべてのレジストリ ポッドから効果的にクリアできない問題があります。この問題に対処するには、「 トラブルシューティング」 セクションをご覧ください。
Automation Suite 2023.10.9 の問題を修正しました。
kube-proxyヘルスチェックが機能しない
追記 (2025 年 4 月 15 日):node-monitor コンポーネントは、ノードの健全性の確認やip_forwardが有効かどうかなどの問題がないかノードを監視し、問題が発生した場合kube-proxyノードを遮断しますが、GPU、task-mining、as-robotなどの特定のノードでは機能しません。この問題は、Automation Suite 2023.10.9 で修正されています。
Kerberos チケットは自動的に更新されません
追記 (2025 年 4 月 15 日): クラスターの復元後に Kerberos チケットが自動的に更新されないため、Windows 認証アプリを手動で同期する必要があります。
この問題は、Automation Suite 2023.10.9 で修正されています。
AI Center のストレージの移行の失敗
追記 (2025 年 2 月 13 日): ある問題により uipathctl AI Center で Ceph のクラスター内ストレージから外部オブジェクト ストレージに移行するプロセス中に、 executeMigration を true に正しく設定できません。
この問題を修正するには、AI Center の ArgoCD で executeMigration true に手動で設定してから、再同期を続行し、確実にプルーニングする必要があります。この問題は、 Automation Suite 2023.10.8 で修正されています。
アップグレード後のメール アラートの設定エラー
追記 (2025 年 2 月 13 日): ある問題が、Automation Suite 2022.10 からのアップグレード後に、メール アラートの設定の機能と複数の受信者の設定に影響します。この問題を解決するには、「 トラブルシューティング」をご覧ください。
この問題は、 Automation Suite 2023.10.8 で修正されています。
既定の組織の初期化によるアップグレードの失敗
追記 (2025 年 6 月 26 日): ある問題により、Automation Suite 2022.10 以前からバージョン 2023.10.0 から 2023.10.2 にアップグレードすると、アップグレードが失敗します。この問題は、 platform-services-initialize-default-organization-jobの不明なソケット エラーが原因で発生し、既定の組織が初期化されません。
Automation Suite 2023.10.3 の問題を修正しました。
非推奨化のタイムライン
非推奨化および削除される機能に関する最新情報については、非推奨化のタイムラインを定期的に確認することをお勧めします。
バンドルの詳細
製品バージョン
Automation Suite の各製品における変更点は、以下のリンクから確認できます。
製品が灰色表示されている場合は、この新しいバージョンの Automation Suite ではそのコンポーネントに対する変更はありません。
内部コンポーネントのバージョン
この Automation Suite のリリースには、次のコンポーネントがバンドルされています。
| コンポーネント | バージョン |
|---|---|
| RKE2 | 1.26.5 |
| ArgoCD | 2.7.7 |
| logging-operator | 3.17.10 |
| logging-operator-logging | 3.17.10 |
| Gatekeeper | 3.11.0 |
| rook-ceph | 1.9.4 |
| prometheus-pushgateway | 2.1.6 |
| cert-manager | 1.12.3 |
| rancher-istio | 102.2.0-up1.17.2 |
| rancher-logging | 102.0.1-up3.17.10 |
| rancher-logging-crd | 102.0.1-up3.17.10 |
| rancher-monitoring-crd | 102.0.1-up40.1.2 |
| rancher-gatekeeper-crd | 100.2.0-up3.8.1 |
| rancher-gatekeeper | 100.2.0-up3.8.1 |
| rancher-monitoring | 102.0.1-up40.1.2 |
| longhorn | 1.4.3 |
| longhorn-crd | 1.1.100 |
| reloader | 0.0.129 |
| csi-driver-smb | 1.8.0 |
| velero | 3.1.6 |
| redis-operator | 6.2.18-41 |
| redis-cluster | 6.2.18-65 |
移行ツールのバージョン
必要な移行ツールのバージョンは、移行予定のスタンドアロン製品と対象の Automation Suite のバージョンによって異なります。詳しくは、「 移行の相互運用性マトリクス」をご覧ください。
スタンドアロン製品を Automation Suite の現在のバージョンに移行する手順については、「 完全な移行」をご覧ください。
- ライセンス関連のテナント制限の変更
- UiPath.OrganizationMigrationApp の新しいバージョンが公開
- 更新内容
- Kerberos 認証の変更
- インストール エクスペリエンスの効率化
- サイドバイサイド アップグレードの導入
- インプレース アップグレードの強化
- Linux の Automation Suite から EKS/AKS の Automation Suite への移行
- Longhorn の削除による安定性と品質の向上
- uipathctl のご紹介
- 署名付き URL を使用しない ObjectStore へのアクセス
- 外部 Docker レジストリの改良機能
- ネットワーク アクセスに制限がある顧客向けのオフライン バンドルの分割
- RHEL のサポート対象のバージョンの追加
- SELinux のサポート
- IMDSv2 のサポート
- ArgoCD UI ドキュメントの非推奨化
- Kerberos 認証の構成に関する変更
- ライセンスに関するニュース
- Citizen Developers ユーザー グループ
- AAD のカスタム属性マッピング
- Deployment Assistant のサポート終了
- 改良点
- トラブルシューティングのユーザー エクスペリエンスの向上
- SSO 認証の改良
- バグ修正
- 管理者のバグ修正
- 既知の問題
- FIPS 140-2 のサポートの制限
- Insights の PVC サイズが上書きされたことによるアップグレードの失敗
- Automation Suite のアップグレード後に Insights を再インストールまたはアップグレードするとデータが失われる
- 非 HA Redis でのノード メンテナンスの問題
- アクティブ/パッシブ チェック中の不要な Redis DNS 解決の検証
- Insights の注釈、課題がブロックされる、インストーラー
- 追加ノードでの RKE2 サービスの意図しないアップグレード
- サイドバイサイド アップグレード中に AI Center のスキルの同期が失敗する
- Test Automation SQL の接続文字列は無視されます
- ノード ラベルの設定中にインストールが失敗する
- システム アップグレード名前空間でジョブが失敗したためアップグレードできない
- プロキシ環境でポッドが FQDN と通信できない
- TLS 1.2 の弱い暗号
- サポート バンドルのログ収集の失敗
- 外部 ObjectStore に対して不要な ListBucket API の前提条件の確認が失敗する
- ArgoCD の SSO を有効化できない
- アップグレード後に snapshot-controller-crds ポッドが CrashLoopBackOff ステートになる
- クラスター内の ObjectStore から外部 ObjectStore への移行が失敗する
- プロキシ環境で外部オブジェクト ストレージを使用するとコンポーネントが失敗する
- Azure Government 上の AKS に対して誤った FQDN で生成されたサポート バンドル
- Airflow のネットワーク ポリシーが原因で DNS が正しく機能しない可能性があります
- シングルノードのアップグレードがファブリック ステージで失敗する
- CephMgrIsAbsent のアラートに関する問題
- S3 ObjectStore への移行後に rook-ceph をアンインストールする際のエラー メッセージ
- Ceph のメトリックとアラートに影響する問題
- SQL Server と SQL データベースの照合順序の違いがサポートされない
- MongoDB から SQL Server への移行によりアップグレードが失敗する
- 既存の Automation Suite に新しい製品を追加する際にインストールが失敗する
- 政府機関向けクラウド ストレージへのログ転送に影響する問題
- オフライン インストール実行後のゾンビ プロセス
- 障害復旧後 Dapr が Process Mining と Task Mining で正しく機能しない
- Document Understanding のすぐに使えるパッケージのバージョンが見つからない
- Document Understanding の接続文字列を設定する際に使用できない文字がある
- v2023.10 へのアップグレード後に AI Center をプロビジョニングできない
- Kerberos keytab ローテーションでトークンの再生成がトリガーされない
- ユーザー割り当てマネージド ID を使用すると Orchestrator が起動しない
- Thanos コンパクターは破損したブロックで停止します
- オフライン環境でエージェント ノードの追加に失敗する
- 大きなポリシー OID を持つ CA 証明書が原因でインストールが失敗する
- ライセンス SQL 接続エラー
- Grafana ダッシュボードのエラー
- uipathctl health check コマンド
- Kubernetes のアップグレードの失敗
- アップグレード後の Document Understanding のデプロイに関する問題
- Docker レジストリのクリーンアップ プロセスが不完全です
- kube-proxyヘルスチェックが機能しない
- Kerberos チケットは自動的に更新されません
- AI Center のストレージの移行の失敗
- アップグレード後のメール アラートの設定エラー
- 既定の組織の初期化によるアップグレードの失敗
- 非推奨化のタイムライン
- バンドルの詳細
- 製品バージョン
- 内部コンポーネントのバージョン
- 移行ツールのバージョン