UiPath Documentation
automation-suite
2.2510
true
Linux の Automation Suite のインストール ガイド
重要 :
このコンテンツの一部は機械翻訳によって処理されており、完全な翻訳を保証するものではありません。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

アップグレードを実行する

Automation Suite クラスターのアップグレード (メンテナンス モード、バックアップ手順、アップグレード プロセスを含む) を実行します。

重要:

Automation Suite のアップグレードを実行するには、クラスターをメンテナンス モードにする必要があります。メンテナンス モードでは、アップグレード プロセス全体でダウンタイムが発生します。その間、ビジネス オートメーションは中断されます。 アップグレードの前に、クラスターと SQL データベースのバックアップを作成することを強くお勧めします。これは、アップグレード操作中に何か問題が発生した場合に、クラスターを確実に復元できるようにするためです。

アップグレードを実行するには、次の手順を実行する必要があります。

  1. 前提条件の確認を実行します。
  2. バックアップを構成します。
  3. バックアップを無効化します。
  4. クラスターをメンテナンス モードにします。
  5. Longhorn ワークロード、MongoDB データ、Ceph を Helm ベースのデプロイに移行します。
  6. Kubernetes およびその他のインフラストラクチャ コンポーネントを更新します。
  7. 共有コンポーネントと UiPath® サービスをアップグレードします。

前提条件の確認を実行する​

クラスターをメンテナンス モードにする前に、アップグレードの要件がすべて満たされていることを確認する必要があります。

  1. 次のコマンドを使用して、インフラストラクチャの前提条件の確認を実行します。

    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json
    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl rke2 prereq run cluster_config.json --versions versions/helm-charts.json
    
  2. 次のコマンドを使用して、共有コンポーネントとサービスの前提条件の確認を実行します。

    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json
    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl prereq run cluster_config.json --versions versions/helm-charts.json
    
注:

Automation Suite の現在のバージョンで大文字の FQDN が使用されている場合、前提条件の確認は失敗し、小文字の FQDN に切り替えるよう求めるメッセージが表示されます。この場合は、アップグレードを続行する前に FQDN を小文字に更新してください。手順については、「 インストール後に FQDN を設定する」をご覧ください。

バックアップを構成する​

バックアップを構成するには、次の手順に従います。

  1. クラスターでバックアップが有効であることを確認します。現在のデプロイで使用したバージョンと同じバージョンのインストーラーを使用してバックアップを作成する必要があります。

    詳しくは、Automation Suite のアップグレード元のバージョンに対応するバックアップと復元のドキュメントをご覧ください。たとえば、Automation Suite 2023.4 からのアップグレードを計画している場合は、詳しくは、v2023.4 のガイドをご覧ください。

  2. SSH を介していずれかのサーバー ノードに接続します。

  3. 必要なすべてのボリュームがクラスターにバックアップされていることを確認します。

    • 2022.4 以前からアップグレードする場合は、次のコマンドを実行します。

      /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
      /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup
      
    • 2022.10 以降からアップグレードする場合は、次のコマンドを実行します。

      ./configureUiPathAS.sh snapshot list
      ./configureUiPathAS.sh snapshot list
      
    • 2024.10 以降からアップグレードする場合は、次のコマンドを実行します。

      ./bin/uipathctl snapshot list
      ./bin/uipathctl snapshot list
      
注:

バックアップには時間がかかることがあるため、その場合は 15 分から 20 分ほど待ってから再度ボリュームのバックアップを確認してください。

バックアップが作成されたら、続いて次の手順を実行します。

注:

23.10.0 以降のバージョンからアップグレードする場合は、必ずターゲット バージョン ディレクトリから uipathctl コマンドを使用してください。

バックアップを無効化する​

クラスターをメンテナンス モードにする前に、バックアップを無効化して、クラスターが最適でないステートでバックアップされないようにする必要があります。詳細については、「 スナップショットのバックアップを無効化する」をご覧ください。

クラスターをメンテナンス モードにする​

クラスターをメンテナンス モードにすると、イングレス コントローラーとすべての UiPath® サービスがシャットダウンし、Automation Suite クラスターへのすべての受信トラフィックがブロックされます。

  1. クラスターをメンテナンス モードにするには、以下を実行します。

    ./bin/uipathctl cluster maintenance enable
    ./bin/uipathctl cluster maintenance enable
    
  2. クラスターがメンテナンス モードであることを確認するには、以下を実行します。

    ./bin/uipathctl cluster maintenance is-enabled
    ./bin/uipathctl cluster maintenance is-enabled
    

アップグレード前の移行操作を実行する​

次の必須のアップグレード前コマンドを実行します。

./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions
./bin/uipathctl cluster pre-upgrade cluster_config.json --versions-dir ./versions

このコマンドは、Longhorn のワークロードをローカルの PV に、MongoDB のデータを SQL に選択的に移行し、Ceph のデプロイを ArgoCD から Helm ベースのデプロイに移行します。

Kubernetes およびその他のインフラストラクチャ コンポーネントを更新する​

Kubernetes およびその他のインフラストラクチャ コンポーネントをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。

重要:

生成された cluster_config.json ファイルを、「クラスター構成を更新する」の説明に従って更新したことを確認してください。

注:

Automation Suite 2.2510.0 以降、Task Mining は利用できなくなったため、専用の Task Mining ノードがある場合は、「 クラスターからノードを削除する」の手順に従って、そのノードをクラスターから削除できます。

Automation Suite でノードを再利用する場合は、次のコマンドを実行してtaint を削除できます。

kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-
kubectl taint nodes <nodename> task.mining/cpu=present:NoSchedule-
cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json
cd /opt/UiPathAutomationSuite/latest/installer

./bin/uipathctl rke2 upgrade cluster_config.json --versions versions/helm-charts.json
注:
  • 前のコマンドをプライマリ サーバー ノードで実行すると、インストーラーと cluster_config.json が /opt/UiPathAutomationSuite/<version>/installer の既定の場所にコピーされ、すべてのマシンのインフラストラクチャがアップグレードされます。

  • /opt/UiPathAutomationSuite/<version>の既定の場所には、すべてのノードで 5 GB 以上の空き容量が必要です。

  • 既定の場所を変更するには、次の環境変数を目的の場所で更新します。その場所がすべてのノードで利用可能であり、アップグレードを実行するために必要なアクセス許可があることを確認します。

    export INSTALLER_DIRECTORY=/path/to/copy/installer
    export INSTALLER_DIRECTORY=/path/to/copy/installer
    
  • 前のコマンドを実行してアップグレードを実行すると、インストーラーが /path/to/copy/installer/<version>/installer の場所にコピーされます。version は、実行するインストーラーのバージョンに置き換えられます。

トラブルシューティング​

  • インストーラーにカスタムの場所を明示的に使用していない限り、プライマリ サーバーのアップグレード ログは /opt/UiPathAutomationSuite/latest/installer/upgrade-logs の既定の場所にあります。
  • 他のすべてのノードでは、INSTALLER_DIRECTORY 変数を使用して場所を明示的に変更しない限り、ログは /opt/UiPathAutomationSuite/<version>/installer/upgrade-logs の既定の場所にあります。

共有コンポーネントと UiPath® サービスをアップグレードする​

  1. Insights を有効化している場合は、次のコマンドを実行して、アップグレード後も Insights のデータが保持されるようにする必要があります。

    kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -
    kubectl -n uipath create cm migration-lock --from-literal=migration=pending --dry-run=client -o yaml | kubectl apply -f -
    
    注:

    Insights が有効でない場合、このコマンドを実行しても悪影響はありません。

  2. 共有コンポーネントと UiPath® 製品サービスをアップグレードするには、プライマリ サーバー ノードで次のコマンドを実行します。

    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
    
  3. クラスターをメンテナンス モードから解除するには、プライマリ サーバー ノードで次のコマンドを実行します。

    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl cluster maintenance disable
    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl cluster maintenance disable
    
    重要:

    このアップグレードにより UiPath® 製品ポッドが復元されます。これは、新しいバージョンのグラフでは ArgoCD の同期時にレプリカ数が設定されるためです。ただし、クラスターがメンテナンス モードに移行することはありません。明示的に uipathctl cluster maintenance disable を実行する必要があります。

    実行するまで、メンテナンス モードが中断された CronJobs は中断されたままになり、メンテナンス モードが追加された uipath.com/last_replica_count 注釈はデプロイと StatefulSet に残ります。その注釈が存在する間は、後続の uipathctl cluster maintenance enable はそれらのワークロードをスキップし、スケール ダウンしません。

    注:

    uipathctl cluster maintenance is-enabled は、デプロイ レプリカと ArgoCD アプリケーションのみを評価します。アップグレードによってレプリカが復元されるため、このコマンドは、CronJobs が中断されている間、メンテナンス モードが無効になっていることを報告できます。を実行します uipathctl cluster maintenance disable。

  4. Automation Suite が正常かどうかを確認するには、次のいずれかのコマンドを実行します。

    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl health check
    cd /opt/UiPathAutomationSuite/latest/installer
    ./bin/uipathctl health check
    
    注:

    helm-charts.json見つからない場合は、代わりに versions.jsonを使用することもできます。versions.jsonをダウンロードするには、「インストール パッケージをダウンロードする」をご覧ください。

アップグレードの完了後、該当するクリーンアップと移行のアクティビティを実行します。

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得