Cloud Storage でのバックアップのスケジュール設定

このページでは、Cloud Storage で Cassandra のバックアップをスケジュールする方法について説明します。この方法では、バックアップは指定した Cloud Storage バケットに保存されます。

Cassandra のバックアップをスケジュールするには、次の手順を実施します。

次の create-service-account コマンドを実行して、標準の roles/storage.objectAdmin ロールを持つ Google Cloud サービスアカウント（SA）を作成します。この SA ロールを使用すると、バックアップデータを Cloud Storage に書き込むことができます。$APIGEE_HELM_CHARTS_HOME/apigee-operator/etc/ ディレクトリで次のコマンドを実行します。

./tools/create-service-account --env non-prod --dir ./

このコマンドにより、非本番環境で使用する apigee-non-prod という名前の 1 つのサービスアカウントが作成され、ダウンロードしたキーファイルが ./ ディレクトリに配置されます。

注: 本番環境用に個別のサービスアカウントをすべて作成する場合は、次のコマンドを使用します。

./tools/create-service-account --env prod --dir ./

次に、各サービスアカウントを対応するチャートディレクトリに移動します。次の表に、各サービスアカウントと対応する Apigee ハイブリッド Helm チャートを示します。

サービスアカウント	Apigee Helm チャート
`apigee-cassandra`	`apigee-datastore`
`apigee-logger`	`apigee-telemetry`
`apigee-mart`	`apigee-org`
`apigee-metrics`	`apigee-telemetry`
`apigee-runtime`	`apigee-env`
`apigee-synchronizer`	`apigee-env`
`apigee-udca`	`apigee-org`
`apigee-watcher`	`apigee-org`

Google Cloud サービスアカウントの詳細については、サービスアカウントの作成と管理をご覧ください。

create-service-account コマンドにより、サービスアカウントの秘密鍵を含む JSON ファイルが保存されます。このファイルは、コマンドを実行したのと同じディレクトリに保存されます。以降のステップでこのファイルのパスが必要になります。
Cloud Storage バケットを作成します。バケットに適したデータ保持ポリシーを指定してください。15 日のデータ保持ポリシーを使用することをおすすめします。
overrides.yaml ファイルを開きます。

次の cassandra.backup プロパティを追加してバックアップを有効にします。すでに構成されているプロパティは削除しないでください。

パラメータ

cassandra:
    ...

    backup:
      enabled: true
      serviceAccountPath: SA_JSON_FILE_PATH
      dbStorageBucket: CLOUD_STORAGE_BUCKET_NAME
      schedule: BACKUP_SCHEDULE_CODE
      cloudProvider: "GCP"  # For remote server backup set this to HYBRID (all caps)

    ...

例

  ...

  cassandra:
    storage:
      type: gcepd
      capacity: 50Gi
      gcepd:
        replicationType: regional-pd
    auth:
      default:
        password: "abc123"
      admin:
        password: "abc234"
      ddl:
        password: "abc345"
      dml:
        password: "abc456"
    nodeSelector:
      key: cloud.google.com/gke-nodepool
      value: apigee-data
    backup:
      enabled: true
      serviceAccountPath: "/Users/myhome/.ssh/my-cassandra-backup-sa.json"
      dbStorageBucket: "myname-cassandra-backup"
      schedule: "45 23 * * 6"
      cloudProvider: "GCP"
      


    ...

プロパティ	説明
`backup:enabled`	バックアップはデフォルトでは無効になっています。このプロパティを `true` に設定する必要があります。
`backup:serviceAccountPath`	`SA_JSON_FILE_PATH` `./tools/create-service-account` コマンドを実行したときにダウンロードされたサービスアカウント JSON ファイルへのファイルシステム上のパス。相対ファイルパスを指定することもできます。このパスは、`hybrid-base-directory/hybrid-files` ディレクトリからの相対パスです。
`backup:dbStorageBucket`	`CLOUD_STORAGE_BUCKET_NAME` バックアップアーカイブの保存に使用する既存の Google Cloud Storage バケットの名前。バケットを作成する必要がある場合は、バケットの作成をご覧ください。注: Hybrid バージョン 1.13 以降では、バケット名に `gs://` を接頭辞として付ける必要はありません。この接頭辞のサポートは非推奨となりました。今後のリリースで削除される予定です。
`backup:cloudProvider`	`GCP/HYBRID` Cloud Storage バックアップの場合は、プロパティを `GCP` に設定します。例: `cloudProvider: "GCP"` リモートサーバーのバックアップの場合は、プロパティを `HYBRID` に設定します。例: `cloudProvider: "HYBRID"`
`backup:schedule`	`BACKUP_SCHEDULE_CODE` バックアップの開始時刻。標準の crontab 構文で指定します。デフォルト: `0 2 * * *` 注: バックアップ構成をクラスタに適用した後、すぐにバックアップを開始するようなスケジュールは設定しないでください。バックアップ構成を適用すると、Kubernetes によって Cassandra ノードが再作成されます。ノードが再起動する前にバックアップが開始されると、最初のバックアップは失敗し、後続のバックアップは成功します。

構成の変更を新しいクラスタに適用します。次に例を示します。
```
helm upgrade datastore apigee-datastore/ \
  --namespace APIGEE_NAMESPACE \
  --atomic \
  -f OVERRIDES_FILE.yaml
```
注:「Error: UPGRADE FAILED: "datastore" has no deployed releases」というエラーが表示された場合は、upgrade を install に置き換えて、コマンドを再度実行してみてください。
ここで、OVERRIDES_FILE は、先ほど編集したオーバーライドファイルのパスです。

バックアップジョブを確認します。次に例を示します。

kubectl get cronjob -n APIGEE_NAMESPACE

  NAME                      SCHEDULE     SUSPEND   ACTIVE   LAST SCHEDULE   AGE
  apigee-cassandra-backup   33 * * * *   False     0        <none>          94s