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

背景

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 が追加されている可能性があります。
デプロイした Key Vault (<basename>-VAULT など) でシークレットを読み取り/書き込み/管理する権限を既存の MSI に付与する必要があります。これを行うには、Key Vault に移動し、[Access Policies] > [Add]をクリックし、すべての [Secret Operations] を選択してから MSI を選択し、[Add] をクリックします。
必ず cluster_config.json ファイルを確認し、文字列 ("true"/"false") としてマークされた Boolean 値を実際の Boolean 値 (true/false) に変更ます。たとえば、次のとおりです。
- ゾーンの回復機能を有効化するには、"zone_resilience": true を使用します。
- インストーラーでデータベースを作成できるようにするには、"sql.create_db": true を使用します。
注:
Automation Suite を v2022.10 から v2023.4 以降にアップグレードする際に、Orchestrator が新旧両方のバージョンで有効化されている場合は、cluster_config.json ファイルの orchestrator.block_classic_executions フラグを 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)az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)
```
アップグレードスクリプトを実行しているマシンでは、Azure にログインし、コンテキストを正しいサブスクリプションに設定する必要があります。アカウントは、クラスターがデプロイされたリソースグループで Owner ロールを持つ必要があります。

考慮事項と推奨事項

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

Automation Suite でサポートされている最新バージョンの RHEL OS に更新することを強くお勧めします。詳しくは、「デプロイプロファイルの一覧」をご覧ください。
アップグレード操作を開始する前に、デプロイのストレージアカウント (<basename>st)で logs と flags という名前の 2 つのコンテナーを作成できます。これらのファイルを作成しない場合は、アップグレードスクリプトが代わりにを行できます。
デプロイされたサーバースケールセットに Ceph ディスクが接続されていない場合、スクリプトによって Ceph ディスクが作成され、サーバースケールセットに接続されます。
アップグレードプロセスによって VMSS モデルが変更されますが、古いインスタンスには適用されません。
アップグレードエラーの詳細については、「手動: オンラインアップグレード」と「自動: オンラインアップグレード」をご覧ください。

実行

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

upgradeUiPathAS.sh スクリプトをこちらからダウンロードします。
スクリプトをダウンロードしたパスに移動し、コマンド chmod +x ./upgradeUiPathAS.sh を実行します。
Linux 環境で、アップグレードプロセスを対話型モードまたは非対話型モードで実行します。
- オプション A: プロセスを対話モードで実行する場合は、次のコマンドを使用します。
  
  sh upgradeUiPathAS.sh --targetVersion {ASversion}
  
  このスクリプトでは、実行時に一連のパラメーターを指定するよう求められます。必要なパラメーターの詳細については、「Automation Suite を Azure にデプロイする」をご覧ください。
- オプション B: プロセスを非対話型モードで実行するには、次の手順を実行します。
  1. ダウンロードしたスクリプトの横に <targetVersion> フォルダーを作成します。
  2. <targetVersion> フォルダー内に、次の構造を持つ paramValues.json という名前のファイルを作成します。
    
    { "param1":"value1", "param2":"value2" } です。
    
    必要なパラメーターの詳細については、「Automation Suite を Azure にデプロイする」をご覧ください。
  3. upgradeUiPathAS.sh スクリプトを実行します。
    
    sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true
    
    注: 前述のコマンドに含まれる {ASversion} を Automation Suite のバージョンに置き換えてください。Automation Suite のバージョンは、Azure テンプレートのバージョンと異なる場合があります。