アップグレードを完了する

Context

Automation Suite クラスターのアップグレード後、新しいノードがクラスターに正常に参加できるように、いくつかの変更を行う必要があります。これらの変更操作を自動化するには、 upgradeUiPathAS.sh スクリプトを使用することをお勧めします。

このページでは、コンピューティング リソースのカスタム スクリプト拡張機能 (CSE) を置き換え、新しいバージョンの Automation Suite へのアップグレード時に新しいノードをクラスターに追加できるようにする方法について説明します。

以降のセクションに記載されているプロセスでは、Azure リソースに対していくつかの小さな変更を行い、前提条件を検証するために必要なスクリプトをダウンロードします。スクリプトは <targetVersion> フォルダーと Modules フォルダー内にあります。プロセスが失敗すると、ファイルを保持するかどうか尋ねられます。

前提条件が有効であることを確認した後は、すべてのコンピューティング リソースで CustomScriptExtension オブジェクトが更新され、新たに追加されたノードで Automation Suite の <targetVersion> が使用されるようになります。最後に、初期クラスター ノード上のファイルは <targetVersion> のファイルと一致するように上書きされます。

準備

前提条件

次の要件を満たしていることを確認してください。

• デプロイに関連付けられた Managed Service ID (MSI) (<basename>-MSI など) を、デプロイ内のすべてのスケールセット/仮想マシンに割り当てられたユーザー ID として追加する必要があります。これを行うには、[Scaleset/virtual machine] > [Identity] > [User Assigned] > [Add] に移動します。Automation Suite の新しいバージョンのテンプレートには、既に MSI が追加されている可能性があります。

• You must grant the existing MSI rights to read/write/manage secrets in the deployed key vault (named like <basename>-VAULT). To do this, go to the keyvault, click Access Policies, then Add, select all Secret Operations, choose the MSI, then Add.

• 必ず cluster_config.json ファイルを確認し、文字列 ("true"/"false") としてマークされた Boolean 値を実際の Boolean 値 (true/false) に変更ます。たとえば、次のとおりです。

  注:

  Automation Suite を v2022.10 から v2023.4 以降にアップグレードする際に、Orchestrator が新旧両方のバージョンで有効化されている場合は、cluster_config.json ファイルの orchestrator.block_classic_executions フラグを true に設定する必要があります。このフラグを使用すると、クラシック フォルダーでのジョブの実行をブロックすることに同意したものとみなされます。フラグを使用しない場合、アップグレードの操作は失敗します。新規インストールの場合、このパラメーターは不要です。

  • ゾーンの回復機能を有効化するには、"zone_resilience": true を使用します。
  • インストーラーでデータベースを作成できるようにするには、"sql.create_db": true を使用します。

• アップグレード プロセスの後、新しい cluster_config.json ファイルの内容を、デプロイ Key Vault の clusterConfig という名前の Azure Key Vault シークレットにエクスポートします (詳しくは、前述にリスト表示した項目をご覧ください)。FixedRKEAddress フィールドの値を内部ロード バランサーの IP として使用します。このためには、以下のようなコマンドを実行します。

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)
  

• アップグレード スクリプトを実行しているマシンでは、Azure にログインし、コンテキストを正しいサブスクリプションに設定する必要があります。アカウントは、クラスターがデプロイされたリソース グループで Owner ロールを持つ必要があります。

考慮事項と推奨事項

アップグレード操作を開始する前に、以下の推奨事項を考慮してください。

• We strongly recommend updating to the latest RHEL OS version supported by Automation Suite. For details, see Deployment profiles at a glance.
• アップグレード操作を開始する前に、デプロイのストレージ アカウント (<basename>st)で logs と flags という名前の 2 つのコンテナーを作成できます。これらのファイルを作成しない場合は、アップグレード スクリプトが代わりにを行できます。
• デプロイされたサーバー スケールセットに Ceph ディスクが接続されていない場合、スクリプトによって Ceph ディスクが作成され、サーバー スケール セットに接続されます。
• アップグレード プロセスによって VMSS モデルが変更されますが、古いインスタンスには適用されません。
• For details on the upgrade errors you might encounter, see Manual: Online upgrade and Automated: Online upgrade.

実行

Automation Suite の新しいバージョンへのアップグレードを正常に実行するには、次の手順に従います。

1. upgradeUiPathAS.sh スクリプトをこちらからダウンロードします。

2. スクリプトをダウンロードしたパスに移動し、コマンド chmod +x ./upgradeUiPathAS.sh を実行します。

3. Linux 環境で、アップグレード プロセスを対話型モードまたは非対話型モードで実行します。

   • オプション A: プロセスを対話モードで実行する場合は、次のコマンドを使用します。

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     The script asks you to provide a series of parameters during the run. For details on the required parameters, see Deploying Automation Suite to Azure.

   • オプション B: プロセスを非対話型モードで実行するには、次の手順を実行します。

     1. ダウンロードしたスクリプトの横に <targetVersion> フォルダーを作成します。

     2. <targetVersion> フォルダー内に、次の構造を持つ paramValues.json という名前のファイルを作成します。

        { "param1":"value1", "param2":"value2" } です。

        For details on the required parameters, see Deploying Automation Suite to Azure.

     3. upgradeUiPathAS.sh スクリプトを実行します。

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        注:

        前述のコマンドに含まれる {ASversion} を Automation Suite のバージョンに置き換えてください。Automation Suite のバージョンは、Azure テンプレートのバージョンと異なる場合があります。

パラメーター

Automation Suite の特定のバージョンに更新するために必要なパラメーターの説明は、 cluster_config.json ファイルで確認できます。cluster_config.jsonファイルは、こちらから入手できます。