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

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 が追加されている可能性があります。

• デプロイされたキー コンテナー内のシークレットの読み取り/書き込み/管理権限を既存の MSI に付与する必要があります ( <basename>-VAULTのような名前が付けられています)。これを行うには、keyvault に移動し、[ アクセス ポリシー]、[ 追加] の順に選択し、すべての [ シークレット操作] を選択し、[MSI]、[ 追加] の順に選択します。

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

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

• Virtual Machine Scale Sets (サーバー、エージェントなど) の RHEL バージョンが更新されており、アップグレード先のバージョンと一致していることを確認します。

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

• Automation Suite を v2023.10 以降にアップグレードする際に、Insights が新旧両方の環境で有効化されている場合は、cluster_config.json ファイルの insights.external_object_storage.bucket_name フラグを、platform と同じバケットに設定する必要があります。フラグを使用しない場合、アップグレードの操作は失敗します。新規インストールの場合、このパラメーターは不要です。

• Automation Suite 2023.10 以降にアップグレードする場合は、sql.create_db が true に設定されている場合は、cluster_config.json の以下のフィールドを入力するようにしてください。

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>
  

• アップグレード プロセスの後、新しい 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 ロールを持つ必要があります。

• Process Mining が有効化されていて、最新バージョンの Airflow を使用する場合は、 AutomationSuite_Airflow データベースの PostgreSQL 接続文字列を指定するようにしてください。

  詳しくは、「 Process Mining のための SQL の要件 」をご覧ください。

  注:

  これは、Automation Suite 2023.10.9 以降にアップグレードした場合にのみ適用されます。

考慮事項と推奨事項

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

• Automation Suite でサポートされている最新バージョンの RHEL OS に更新することを強くお勧めします。詳しくは、「ハードウェアおよびソフトウェアの要件」をご覧ください。

• アップグレード操作を開始する前に、デプロイのストレージ アカウント (<basename>st)で logs と flags という名前の 2 つのコンテナーを作成できます。これらのファイルを作成しない場合は、アップグレード スクリプトが代わりにを行できます。

• デプロイされたサーバー スケールセットに Ceph ディスクが接続されていない場合、スクリプトによって Ceph ディスクが作成され、サーバー スケール セットに接続されます。

• アップグレード プロセスによって VMSS モデルが変更されますが、古いインスタンスには適用されません。

• Azure テンプレートを使用してデプロイされたクラスターに対してアップグレードを実行すると、次の画像のようなエラーが発生する場合があります。

  

  これは 、Azure ロード バランサーの動作の仕組みが原因です。この問題を修正するには、cluster_config.json ファイルの [fixed_rke_address] フィールドを変更します。アップグレード コマンドを実行する前に、このフィールドの値を最初のサーバー インスタンスの IP アドレスに変更する必要があります。Key Vault にアップロードされる cluster_config.json は、ノードが正常ではなく、トラフィックのバランスが取れないため、ILB の IP アドレスが引き続き設定されている必要があります。

実行

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

1. upgradeUiPathAS.sh スクリプトをこちらからダウンロードします。
2. スクリプトをダウンロードしたパスに移動し、コマンド chmod +x ./upgradeUiPathAS.sh を実行します。
3. Linux 環境で、アップグレード プロセスを対話型モードまたは非対話型モードで実行します。

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

  sh upgradeUiPathAS.sh --targetVersion {ASversion}
  

  このスクリプトでは、実行時に一連のパラメーターを指定するよう求められます。必要なパラメーターの詳細については、「Automation Suite を Azure にデプロイする」をご覧ください。

• オプション B: プロセスを非対話型モードで実行するには、次の手順を実行します。
  A。ダウンロードしたスクリプトの横に <targetVersion> フォルダーを作成します。
  B。 <targetVersion> フォルダー内に、次のような構造を持つ paramValues.json という名前のファイルを作成します。 { "param1":"value1", "param2":"value2" } 必要なパラメーターについて詳しくは、「 Automation Suite を Azure にデプロイする」をご覧ください。
  c. 次の upgradeUiPathAS.sh スクリプトを実行します。 sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

  注:

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

パラメーター

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