バックアップの復元

ArcGIS Enterprise Manager を使用して、バックアップから ArcGIS Enterprise on Kubernetes 組織サイトを復元できます。 すべての構成データ、設定、サービス、およびインフラストラクチャ オブジェクトが復元されます。 登録済みデータ ストア内のデータを参照するサービスは再作成されます。

組織が管理 API を介してボリュームを使用してサービスを構成しており、バックアップが作成されたためにボリュームが変更された場合は、復元を実行する前に、Released 状態にあるすべての関連する永続ボリューム (PVs) にパッチを適用して Available にします。 これを完了していない場合、サービスは更新に失敗する可能性があり、PVC が既存の PV にバインドした後に再起動する必要が生じます。 関連付けられている PV にパッチを適用するには、次のコマンドを実行します。

kubectl patch pv <pv name> -p '{"spec": {"claimRef": {"uid": null}}}'

バックアップの復元方法は、障害の種類と組織サイトのアクセシビリティによって異なります。

元の組織サイトにアクセス可能な場合のバックアップの復元

組織サイトでデータ破損またはデータ損失が発生したが、アクセスは可能である場合、アンデプロイしてから再デプロイしなくてもバックアップを復元できます。 元の組織サイトはすべてのバックアップの記録を維持しており、ArcGIS Enterprise Manager を使用して、バックアップの 1 つから復元することができます。

元の組織サイトにアクセス可能な場合にバックアップを復元するには、次の手順を実行します。

  1. 組織の管理者として ArcGIS Enterprise Manager にサイン インします。
  2. [バックアップ] ボタンをクリックします。
  3. バックアップ ページから、復元先のバックアップを決定し、オプション ボタンをクリックします。
  4. [元に戻す] をクリックします。
  5. バックアップの作成に使用された暗号化パス フレーズを入力します。
  6. [元に戻す] をクリックします。

復元操作を開始すると、この操作を管理するジョブが作成され、復元ページが表示され、復元操作の進行状況が表示されます。 組織サイトは、バックアップが作成された時点に復元され、復元が完了するまでアクセスできなくなります。

元の組織サイトにアクセスできない場合のバックアップの復元

まず、新しいバックアップ ストアを登録するときにラベル セレクターの一部として使用できるラベルが元の永続ボリューム (PV) に含まれていることを確認します。 また、ソースとターゲットの環境で次の設定が同一であることも確認する必要があります。

  • 完全修飾ドメイン名 (FQDN) とコンテキスト パス (https://dnsalias.domain.com/context)
  • レジストリのホストおよびリポジトリ (docker.io および esridocker)
  • Kubernetes 名前空間 (arcgis)
  • Kubernetes クラスター ドメイン (cluster.local)
  • Kubernetes サービス DNS の接尾辞 (svc.cluster.local)
  • FSGroup および補足グループ ID (カスタム値を使用して配置されている場合)

注意:

これらの設定は、デプロイメント時に指定しました。

既存の PV の静的バインド用の準備

ArcGIS Enterprise on Kubernetes をアンデプロイすると、元の PV のステータスはリリース済みに設定されます。 新しい組織サイトが作成されるまで、既存の PV にパッチをあてないでください。 新しい組織サイトが利用可能になったら、PV の claimRef を削除して、ラベル セレクターを使用してバインドできるようにする必要があります。 適切なラベルを追加して、PV が新しい組織サイトの PVC でバインドできるようにするには、次の手順を実行します。

  1. kubectl を使用して、以前のバックアップ ストアに使用された PV を特定します。
    kubectl get pv
    
  2. kubectl を使用して PV の仕様を取得します。
    kubectl get pv <PV> -o yaml
    

    これらの値は、バックアップ ストアの登録時に参照として使用できます。

    注意:

    前のバックアップ ストア名を忘れた場合は、PV の spec.claimRef.name を分解することで取得できます。 たとえば、PV の spec.claimRef.namedata-volume-arcgis-backup-store-backups-111-backups-main-0 の場合、前のバックアップ ストア名は backups-111 になります。

  3. kubectl を使用して、ラベルを PV に割り当てます。

    これは、PV を新しいバックアップ ストア ポッドにバインドするために使用されます。

    kubectl label pv <pv name> <key>=<value>
    

    たとえば、"arcgis/purpose":"backups" をラベル セレクターとして使用します。

    kubectl label pv <pv name> arcgis/purpose=backups
    
  4. PV にパッチを適用して、uid の値を claimRef フィールドから削除します。 これは、新しいバックアップ ストア ポッドにバインドできるようにするためです。
    kubectl patch pv <pv name> -p '{"spec":{"claimRef":{"uid":null}}}'
    

バックアップ ストアの登録

ステージングの場所およびバックアップ ストアを登録していない場合は、次の手順を実行して、新しいバックアップ ストアを登録し、それを既存の PV にバインドします。

  1. 組織の管理者として ArcGIS Enterprise Manager にサイン インします。
  2. [バックアップ] ボタンをクリックします。
  3. バックアップ ページから、[バックアップ ストアの登録] をクリックします。
  4. ステージングの場所に関する次の情報を入力します。
    • [サイズ (GiB)] - ステージング場所の PV のサイズを定義します。 最小サイズは 16 GiB で、各ストアのバックアップを格納するのに十分に大きなサイズである必要があります。
    • [ストレージ クラス名] - ストレージ クラス名を定義します。
  5. 登録対象のバックアップ ストアのタイプを選択します。
    • Amazon S3
    • Azure Blob
    • Google クラウド ストレージ
    • システム管理ストレージ
    1. Amazon S3 を使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [バケット名] - バックアップを保存するために Amazon S3 で作成されたバケットの名前。
      • [領域] - バケットが作成された領域を指定します。
      • [認証タイプ] - [アクセス キー] または [IAM ロール] を選択します。
      • 認証タイプとしてアクセス キーを使用するなら、次の情報を入力します。
        • [アクセス キー] - IAM ユーザーのアクセス キーを貼り付けるか、入力します。
        • [シークレット キー] - IAM ユーザーのシークレット キーを貼り付けるか、入力します。
    2. Azure Blob を使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [コンテナー名] - バックアップ保存のために Azure で作成されたコンテナーの名前。
      • [ストレージ アカウント] - コンテナーの上位に位置する親ストレージ アカウントの名前。
      • [認証タイプ] - [ストレージ アカウント キー] または [マネージド ID] を選択します。
      • 認証タイプとしてストレージ アカウント キーを使用するなら、次の情報を入力します。
        • [アカウント キー] - 関連付けられているストレージ アカウントのプライマリ アカウント キーまたはセカンダリ アカウント キーを貼り付けるか、入力します。
    3. Google Cloud ストレージを使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [バケット名] - バックアップを保存するために Google Cloud Storage で作成されたバケットの名前。
      • [アクセス キー] - サービス アカウントのアクセス キーを貼り付けるか、入力します。
      • [シークレット キー] - サービス アカウントのシークレット キーを貼り付けるか、入力します。
    4. システム管理ストレージを使用するなら、次の情報を入力します。
      • [ボリュームの種類] - 既存の PV にバインドするには、[静的] を選択します。 管理者は、バインドに必要なラベルが PV に含まれ、バインドできることを確認します。
      • [バックアップ ストア名] - バックアップ ストアの名前を定義します。 これは、以前に登録されたバックアップ ストアの名前と一致する必要があります。 この名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [サイズ (GiB)] - バックアップ ストアの PV のサイズを定義します。 最小サイズは 32 GiB で、静的バインドを使用する場合は、この値が既存の PV のサイズと一致する必要があります。 この値が既存の PV のサイズよりも大きい場合、PVC は PV とバインドしません。
      • [ストレージ クラス名] - ストレージ クラスは既存の PV のストレージ クラスと一致する必要があります。
      • [ラベル セレクター] - 静的プロビジョニングに必要で、ラベルは既存の PV のラベルと一致する必要があります。
  6. [登録] をクリックします。
  7. 注意:
    ストレージ クラスが定義されていない事前作成済みの PV にバインドする場合は、ストレージ クラス名を空白のままにしてください。 クラスター内にデフォルトのストレージ クラスが構成されている場合、DefaultStorageClass アドミッション コントローラーによってデフォルトのストレージ クラスが追加され、PVC がバインドされないようにします。 この場合、管理者は PV にストレージ クラスの指定を追加するか、デフォルトのストレージ クラスの構成を削除する必要があります。

ステージングの場所およびバックアップ ストアが登録済みの場合は、次の手順を実行します。

  1. 組織の管理者として ArcGIS Enterprise Manager にサイン インします。
  2. [バックアップ] ボタンをクリックします。
  3. バックアップ ページから、[バックアップ ストア] をクリックします。
  4. [ストアを登録] をクリックします。
  5. 登録対象のバックアップ ストアのタイプを選択します。
    • Amazon S3
    • Azure Blob
    • Google クラウド ストレージ
    • システム管理ストレージ
    1. Amazon S3 を使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [バケット名] - バックアップを保存するために Amazon S3 で作成されたバケットの名前。
      • [領域] - バケットが作成された領域を指定します。
      • [認証タイプ] - [アクセス キー] または [IAM ロール] を選択します。
      • 認証タイプとしてアクセス キーを使用するなら、次の情報を入力します。
        • [アクセス キー] - IAM ユーザーのアクセス キーを貼り付けるか、入力します。
        • [シークレット キー] - IAM ユーザーのシークレット キーを貼り付けるか、入力します。
    2. Azure Blob を使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [コンテナー名] - バックアップ保存のために Azure で作成されたコンテナーの名前。
      • [ストレージ アカウント] - コンテナーの上位に位置する親ストレージ アカウントの名前。
      • [認証タイプ] - [ストレージ アカウント キー] または [マネージド ID] を選択します。
      • 認証タイプとしてストレージ アカウント キーを使用するなら、次の情報を入力します。
        • [アカウント キー] - 関連付けられているストレージ アカウントのプライマリ アカウント キーまたはセカンダリ アカウント キーを貼り付けるか、入力します。
    3. Google Cloud ストレージを使用している場合は、次の情報を入力します。
      • [バックアップ ストア名] - バックアップ ストアの名前。 名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [バケット名] - バックアップを保存するために Google Cloud Storage で作成されたバケットの名前。
      • [アクセス キー] - サービス アカウントのアクセス キーを貼り付けるか、入力します。
      • [シークレット キー] - サービス アカウントのシークレット キーを貼り付けるか、入力します。
    4. システム管理ストレージを使用するなら、次の情報を入力します。
      • [ボリュームの種類] - 既存の PV にバインドするには、[静的] を選択します。 管理者は、バインドに必要なラベルが PV に含まれ、バインドできることを確認します。
      • [バックアップ ストア名] - バックアップ ストアの名前を定義します。 これは、以前に登録されたバックアップ ストアの名前と一致する必要があります。 この名前に使用できるのは、小文字のアルファベット、数字、およびハイフンだけで、先頭または末尾にハイフンを使用してはいけません。
      • [サイズ (GiB)] - バックアップ ストアの PV のサイズを定義します。 最小サイズは 32 GiB で、静的バインドを使用する場合は、この値が既存の PV のサイズと一致する必要があります。 この値が既存の PV のサイズよりも大きい場合、PVC は PV とバインドしません。
      • [ストレージ クラス名] - ストレージ クラスは既存の PV のストレージ クラスと一致する必要があります。
      • [ラベル セレクター] - 静的プロビジョニングに必要で、ラベルは既存の PV のラベルと一致する必要があります。
  6. [登録] をクリックします。

バックアップ ストアが登録されると、バックアップ ストア内の既存のバックアップはすべてバックアップ ページにリストされますが、復元できるのは同じリリースのバックアップのみになります。

バックアップの復元

バックアップを復元するには、次の手順を実行します。

  1. 組織の管理者として ArcGIS Enterprise Manager にサイン インします。
  2. [バックアップ] ボタンをクリックします。
  3. バックアップ ページから、復元先のバックアップを決定し、オプション ボタンをクリックします。
  4. [元に戻す] をクリックします。
  5. バックアップの作成に使用された暗号化パス フレーズを入力します。
  6. [元に戻す] をクリックします。
注意:

クライアントへのアクセスに ArcGIS Web Adaptor を使用している場合、管理 API から登録解除した後に登録して、復元された組織の構成を反映させます。

復元操作のステータスの確認

復元前に元の組織にアクセスできなかったため、既存のユーザー セッションは無効になり、管理者が復元のステータスを引き続き参照するには、ArcGIS Enterprise Manager にサインインしなおす必要があります。 要求されたら Manager にサインインしなおすと、復元のステータス ページが表示されます。