単一リージョンでの復元

このページでは、単一リージョンで Cassandra を復元する方法について説明します。

単一リージョンのデプロイでは、Apigee ハイブリッドは単一のデータセンターまたはリージョンにデプロイされます。デプロイに複数の Apigee 組織がある場合、復元プロセスではすべての組織のデータが復元されます。複数組織の設定で、特定の組織を復元することはできません。

注: 単一リージョンの復元を開始する前に、前提条件となる次の手順が該当するかどうかを検討してください。

トラブルシューティングと根本原因分析（RCA）のために既存の設定を保持する場合は、Apigee コントローラを除くすべての org および env コンポーネントを Kubernetes クラスタから削除してから、クラスタを保持する必要があります。クラスタには、トラブルシューティングに使用できる既存の Apigee データストア（Cassandra）が含まれます。新しい Kubernetes クラスタを作成し、その新しいクラスタに Cassandra を復元します。
ハイブリッドインストールが複数の組織で設定されている場合は、単一のリージョンで復元を続行する前に、各組織のオーバーライドファイルを取得します。手順 3 で説明する復元構成を、いずれか 1 つのオーバーライドファイルに追加できます。他のオーバーライドファイルには復元構成を追加しないでください。

リージョンをバックアップから復元する

overrides.yaml ファイル内の Cassandra 復元の詳細を更新します。

namespace: YOUR_RESTORE_NAMESPACE # Use the same namespace as in your original cluster.
cassandra:
  hostNetwork: false
...
restore:
  enabled: true
  serviceAccountPath: "SA_JSON_FILE_PATH"
  dbStorageBucket: "CLOUD_STORAGE_BUCKET_NAME"
  cloudProvider: "GCP"  # required verbatim "GCP" (all caps)
  snapshotTimestamp: "TIMESTAMP"
...
backup:
  enabled: false
...

ここで

プロパティ	説明
`namespace`	`YOUR_RESTORE_NAMESPACE` 復元用の名前空間。元のクラスタと同じ名前空間を使用します。
`cassandra:hostNetwork`	`hostNetwork` は必須で、必ず `false` に設定する必要があります。
`restore:enabled`	デフォルトでは、復元は無効になっています。このプロパティを `true` に設定する必要があります。
`restore:serviceAccountPath`	`SA_JSON_FILE_PATH` バックアップ用に作成したサービスアカウントへのファイルシステム上のパス。
`restore:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_NAME` データ復元に使用するバックアップアーカイブを保存する Google Cloud Storage バケットの名前。注: Hybrid バージョン 1.13 以降では、バケット名に `gs://` を接頭辞として付ける必要はありません。この接頭辞のサポートは非推奨となりました。今後のリリースで削除される予定です。
`restore:cloudProvider`	`GCP` `cloudProvider: "GCP"` プロパティは必須です。
`restore:snapshotTimestamp`	`TIMESTAMP` 復元するバックアップスナップショットのタイムスタンプ。使用できるタイムスタンプを確認するには、`dbStorageBucket` に移動し、バケット内にあるファイルを確認します。各ファイル名にはタイムスタンプの値が含まれます。例: `backup_20210203213003_apigee-cassandra-default-0.tgz` ここで、`20210203213003` は、その時点で作成されたバックアップを復元する場合に使用する `snapshotTimestamp` の値です。
`backup:enabled`	このプロパティが以前 `true` に設定されていた場合は、`false` に設定する必要があります。注: 復元時にバックアップを有効にしないでください。

最初からクリーンなクラスタがない場合は、Helm のハイブリッドリージョンを廃止するのドキュメントに沿って、既存の Hybrid インストールをクリーンな状態にします（Cert Manager はインストールしたままにできます）。これにより、ステップ 11 の開始まで Helm ランタイムの設定マニュアルに従った場合と同じ状態になります。
Apigee の名前空間に Pod が残っていないことを確認します。
```
kubectl get pods -n APIGEE_NAMESPACE
```
CSI バックアップを使用している場合は、次のコマンドを実行して、復元プロセスで使用する volumesnapshots が表示されることを確認します。
```
kubectl get volumesnapshot -n APIGEE_NAMESPACE
          
```
ステップ 10: Helm を使用して Apigee ハイブリッドをインストールするに記載されているように、すべての Hybrid コンポーネントを 1 つずつインストールします。datastore をインストールするコマンドを実行すると、apigee-cassandra-restore Pod が作成されますが、apigee-org コンポーネントをインストールした後にのみ running 状態になります。

Cassandra のバックアップと復元について詳しくは、Cassandra のバックアップの概要をご覧ください。

復元ジョブの進行状況を確認し、apigeeds と他のすべての Pod が稼働していることを確認します。

apigeeds を確認します。

kubectl get apigeeds -n APIGEE_NAMESPACE

他のすべての Pod を確認します。
```
kubectl get pods -n APIGEE_NAMESPACE
```

復元が正常に完了し、ランタイムコンポーネントが正常であることを確認したら、クラスタにバックアップを構成することをおすすめします。

overrides-restore.yaml ファイルから restore 構成を削除します。
backup 構成を overrides-restore.yaml ファイルに追加します。

以下のコマンドを使用して backup 構成を適用します。

helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f overrides-restore.yaml