パッチの適用

Automation Suite のパッチとは、バグやセキュリティの脆弱性に対処する、既存のバージョンに対する更新です。たとえば、パッチ 2024.10.3 + パッチ 1 です。バージョン 2024.10.3 に影響を与えるすべての問題を修正します。

重要:

更新プログラムを適用する代わりに、同じ修正プログラムを含む累積的な更新プログラム (CU) にアップグレードすることをお勧めします。 パッチで提供されるすべての修正は、パッチのリリースノートに記載されているCUでも入手できます。

既存のバージョンの Automation Suite にパッチを適用するには、次の手順に従います。

1. オフラインのみ。レジストリを最新のイメージで更新します。

   1. 以下のパッチ成果物を パッチ成果物のダウンロード・リンクからダウンロードします。パッチとレジストリ構成の種類に適用できる成果物のセットを選択します。

      • OCI 準拠レジストリを UiPath® レジストリにミラーリングするには、次のアーティファクトをダウンロードします。
        • as-images.txt
        • as-helm-charts.txt
        • mirror-registry.sh
      • OCI準拠レジストリをオフライン・バンドルでハイドレートするには、次のアーティファクトをダウンロードします:
        • hydrate-registry.sh
        • as.tar.gz
      • クラスター内のレジストリを使用するには、次の成果物をダウンロードします。
        • as-fs.tar.gz
        • docker-images.json
        • versions.json

   2. OCI 準拠のレジストリを設定します。

      重要:

      OCI 準拠レジストリの設定手順で参照されているリンクから成果物をダウンロードしないでください。代わりに、「 パッチ アーティファクトのダウンロード リンク 」ページにあるダウンロード リンクを使用してください。

2. Automation Suite 2024.10.4 以降では、パッチ アーティファクトのダウンロード リンクから、対応する uipathctl パッチ バージョンをダウンロードします。./bin インストーラー ディレクトリにある現在の uipathctl バージョンを、パッチが適用された uipathctl バージョンに置き換えます。

   注:

   CLI の設定方法について詳しくは、「uipathctl を実行するuipathctlをご覧ください。

3. versions.jsonをダウンロードします。手順については、「 パッチ アーティファクトのダウンロード リンク」をご覧ください。

4. 次のコマンドを実行してパッチを適用します。

   • Automation Suite 2024.10.4 より前のバージョンの場合:

     uipathctl cluster patch <path_to_cluster_config.json> --versions <path_to_versions.json> --skip-helm --skip-oss-prereq --only <PRODUCTS(comma separated)>
     

     次の構成サンプルは、Orchestrator と Action Center にパッチを適用する方法を示しています。

     uipathctl cluster patch <path_to_cluster_config.json> --versions <path_to_versions.json> --skip-helm --skip-oss-prereq --only orchestrator,actioncenter
     

   • Automation Suite 2024.10.4 以降のバージョンの場合:

     注:

     <current versions.json> 、現在のインストールの versions.json ファイルを参照します。ファイルは、 <installer_directory>/versions/helm-charts.jsonにあります。

     パッチ versions.json をディレクトリにダウンロードし、ディレクトリ パスを --patch-dir-path パラメーターに渡す必要があります。

     パッチを適用するには、関連するすべての versions.json ファイルを 1 つのディレクトリに保存します。

     uipathctl cluster patch cluster_config.json --versions <current versions.json> --skip-oss-prereq --only <PRODUCTS(comma separated)> --patch-dir-path <path to patch versions.json files directory>
     

     重要:

     Automation Suite 2024.10.4 + パッチ 1 の場合、また、 --skip-cli-compatibility-check パラメーターを patch コマンドに追加する必要があります。

     次の構成サンプルは、Orchestrator と Action Center にパッチを適用する方法を示しています。

     uipathctl cluster patch cluster_config.json --versions <current versions.json> --skip-oss-prereq --only orchestrator,actioncenter --patch-dir-path <path to patch versions.json files directory>
     

5. 次の手順を実行して、パッチ操作が成功したかどうかを確認します。

   1. 次のコマンドを実行して、すべてのサービスのバージョンを一覧表示します。

       kubectl -n argocd get application -o wide || helm list -A
      

   2. パッチが適用されたサービスのバージョンが更新されていることを確認します。