バックアップを復元する

注:

クラスターの復元後は、スナップショットのバックアップは有効化されていません。復元後にスナップショットのバックアップを有効化するには、「 スナップショットのバックアップを有効化する」をご覧ください。

クラスターを復元しても、SQL Server、ObjectStore、OCI 準拠のレジストリなどの外部データ ソースは復元されません。必ず、これらのデータソースを適切なスナップショットに復元してください。

クラスターを復元するには、次の手順に従います。

1. すべてのサーバー ノードにクラスター インフラストラクチャをインストールします。詳細。。。

   注:

   復元クラスターに提供するハードウェアは、バックアップ クラスターのハードウェアと類似のものでなければなりません。詳しくは、「ハードウェアおよびソフトウェアの要件」をご覧ください。

2. 復元したクラスター上でスナップショットを構成します。詳細。。。

3. 復元するスナップショットを選択します。詳細。。。

4. データと設定を復元します。詳細。。。

手順 1: クラスター インフラストラクチャをインストールする

準備

1. 復元インストーラーをダウンロードします。これは、as-installer.zip パッケージに含まれています。ダウンロードの手順については、「インストール パッケージをダウンロードする」をご覧ください。

2. オフライン環境では、外部の OCI 準拠レジストリまたは一時レジストリを指定する必要があります。レジストリの設定は、元のクラスターの設定と同じでなければならないことに注意してください。レジストリを設定するには、以下の手順を参照してください。

   • 外部 OCI 準拠レジストリを設定する
   • 一時的な Docker レジストリを設定するこのオプションは、障害が発生する前に外部の OCI 準拠のレジストリを使用していなかった場合にのみ選択してください。

3. 構成ファイルを準備し、すべてのクラスター ノードで使用できるようにします。構成ファイルを準備するには、以下のいずれかの手順を実行します。

   • オプション A: 障害が発生する前にクラスターに適用した cluster_config.json ファイルを再利用します。
   • オプション B: 以下の例に示すように、最小限必要なパラメーターを指定した cluster_config.json ファイルを作成します。

     {
       "fixed_rke_address": "fqdn",
       "fqdn": "fqdn",
       "rke_token": "guid",
       "profile": "cluster_profile",
       "external_object_storage": { 
         "enabled": false 
       },
       "install_type": "offline or online",
       "snapshot": {
         "enabled": true,
         "nfs": {
           "server": "nfs_server_endpoint",
           "location": "nfs_server_mountpoint"
         }
       },
       "proxy": { "enabled": false }
     }
     

以下の表では、cluster_config.json ファイルで最小限指定する必要があるすべてのパラメーターについて説明します。必ず、元のクラスターで使用したものと同じパラメーター値を指定してください。パラメーター値は復元後に変更できます。

重要:

オフライン環境では、以下の表に示す cluster_config.json パラメーターの設定とは別に、外部の OCI 準拠のレジストリ設定も指定する必要があります。詳しくは、「外部の OCI 準拠レジストリの設定」を参照してください。

パラメーター	値 (Value)
fqdn	Automation Suite クラスターの FQDN。値は、古い FQDN と同じである必要があります。別の FQDN 値を指定すると、復元が失敗する可能性があります。
fixed_rke_address	負荷分散ノードの登録と Kube API 要求に使用する固定アドレス。 推奨どおりロード バランサーを構成している場合は、fqdn の値と同じ値にする必要があります。それ以外の場合は、最初のサーバー ノードの fqdn 値を使用します。詳しくは、「ロード バランサーを構成する」をご覧ください。
rke_token	ここには、新たに生成された GUID を使用します。これは、事前共有されるクラスター固有のシークレットです。クラスターに参加させる、すべてのノードで必要です。
profile	インストールのプロファイルを設定します。使用可能なプロファイルは次のとおりです。 default – シングルノードの評価プロファイル ha – マルチノードの高可用性対応の運用プロファイル
install_type	実行イン予定のストールの種類を表示します。以下のオプションがあります。 online – インターネットにアクセス可能なインストール offline – インターネットにアクセスできないインストール
server	スナップショットの保存場所の FQDN または IP アドレス ( mynfs.mycompany.com や 192.23.222.81 など) です。
location	スナップショットの保存場所またはパスです。
infra.pod_log_path	ポッド ログに使用するカスタム ディレクトリへのパスです。 これは、クラスターがカスタム ポッド ログのパスを使用して構成されている場合に必要です。
proxy	このパラメーターは、プロキシが有効な場合にのみ必須です。詳しくは、「 任意: プロキシ サーバーを構成する」をご覧ください。

cluster_config.jsonの構成方法について詳しくは、「手動: 高度なインストール」をご覧ください。

実行

プライマリ サーバー ノードにクラスター インフラストラクチャをインストールする

プライマリ復元クラスター ノードにインフラストラクチャをインストールするには、次のコマンドを実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json --accept-license-agreement --restore

重要:

プライマリ サーバー ノードから残りのサーバー/エージェント ノードに cluster_config.json をコピーします。プライマリ サーバー ノードでのインフラストラクチャのインストール手順では、残りのノードが必要とする値が追加されます。

セカンダリ サーバーにクラスター インフラストラクチャをインストールする

セカンダリ サーバーにインフラストラクチャをインストールするには、以下の手順を実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j server --accept-license-agreement --restore

すべてのエージェント マシンにインフラストラクチャをインストールする

エージェント ノードにインフラストラクチャをインストールするには、以下の手順を実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j agent --accept-license-agreement --restore

オフライン インストール用にクラスター内レジストリをハイドレートする

この手順は、オフライン インストールにクラスター内レジストリを使用する場合にのみ必要です。 復元をトリガーする前に、次のコマンドを使用してレジストリをハイドレートする必要があります。

./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json

サービス・ノードへのクラスター・インフラストラクチャーのインストール

Task Mining ノードにクラスター インフラストラクチャをインストールする

Task Mining ノードにクラスター インフラストラクチャをインストールするには、以下の手順を実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j task-mining --accept-license-agreement --restore

Automation Suite ロボット ノードにクラスター インフラストラクチャをインストールする

Automation Suite ロボット ノードにクラスター インフラストラクチャをインストールするには、以下の手順を実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j asrobots --accept-license-agreement --restore

GPU ノードにクラスター インフラストラクチャをインストールする

GPU ノードにクラスター インフラストラクチャをインストールするには、以下の手順を実行します。

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j gpu --accept-license-agreement --restore

手順 2: 復元のためにクラスターを準備する

インフラストラクチャをインストールしたら、復元するクラスター スナップショットを準備する必要があります。 シナリオに応じて、次のコマンドを実行する必要があります。

• 外部 Objectore を使用する場合:

  ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --only velero --versions versions/helm-charts.json
  

• クラスター内 Ceph-ObjectStore を使用する場合:

  ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --only base,rook-ceph-operator,rook-ceph-object-store,velero --versions versions/helm-charts.json
  

復元したクラスターのバックアップを構成するには、「クラスター スナップショットを構成する」のセクションの手順に従います。

手順 3: 復元するスナップショットを選択する

スナップショットの構成後、既存のスナップショットの一覧を表示して、復元ポイントとして使用するスナップショットを決定します。

手順 4: データと設定を復元する

以前のクラスターに戻すには、--from-snapshot <snapshot-name> フラグを使用して、変換元のスナップショットの名前を指定します。

./bin/uipathctl snapshot restore create <restore_name> --from-snapshot <snapshot_name>

このコマンドは、復元プロセスをバックグラウンドでトリガーします。復元プロセスが完了するまでコマンドの完了を待機するには、 --wait オプションを渡します。復元プロセスのステータスを確認するには、次のコマンドを実行します。

./bin/uipathctl snapshot restore history

スナップショット名を指定しない場合、クラスターは最後に成功したスナップショットに復元されます。利用可能なスナップショットについては、スナップショットのリストをご覧ください。

Cluster_config.json を復元する

Automation Suite クラスターの回復後、cluster_config.json ファイルを回復することもできます。今後クラスターに新しいノードを追加する際やアップグレードをする際などにこのファイルを使用できます。

cluster_config.jsonを復元するには、次の手順に従います。

1. 次のコマンドを実行して、最後に適用された構成を見つける必要があります。

   ./bin/uipathctl manifest list-revisions
   

次の例は、コマンド出力の例です。

VERSION  UPDATED                        STATUS
1        2024-11-07 00:46:41 +0000 UTC  successful
2        2024-11-07 01:14:20 +0000 UTC  successful
3        2024-11-07 01:23:23 +0000 UTC  successful

2. バックアップの作成前にデプロイされた正しいバージョン番号を選択し、次のコマンドを実行して cluster_config.json ファイルを取得します。

   ./bin/uipathctl manifest get-revision --version <VERSION>
   

次の例は、コマンド出力の例です。

./bin/uipathctl manifest get-revision --version 1 > ./cluster_config.json

信頼ストアに CA 証明書を追加する

クラスターの復元後、復元した仮想マシンの信頼ストアに CA 証明書を追加してください。詳しくは、以下のページをご覧ください。

• TLS 証明書にアクセスする
• CA 証明書をホスト信頼ストアに追加する

新しい監視パスワードを取得する

Automation Suite クラスターの復元後、新しい監視パスワードを取得する必要があります。このためには、「監視ツールにアクセスする」の手順を実行します。

復元したクラスターで AI Center を有効化する

AI Center™ が有効化された Automation Suite クラスターを復元した後、「復元したクラスターで AI Center を有効化する」の手順に従います。

新しい Kerberos チケットの生成

Kerberos 認証が設定されている場合は、Kerberos チケットの有効期限が切れていないことを確認する必要があります。

新しい Kerberos チケットを生成するには、次のコマンドを実行します。

kubectl get cronjobs -A | grep kerberos //to identify the job with name kerberos-tgt-update
kubectl create job --from=cronjob/<cron-job-name> <new_job_name> -n <namespace>

<cron-job-name>、<new_job_name>、<namespace> は、それぞれ cron ジョブの実際の名前、新しいジョブの意図した名前、実際の名前空間に置き換えてください。