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

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

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

次の create-service-account コマンドを実行して、標準の roles/storage.objectAdmin ロールを持つ Google Cloud サービスアカウント（SA）を作成します。この SA ロールを使用すると、バックアップデータを Cloud Storage に書き込むことができます。管理ツールに適したディレクトリで次のコマンドを実行します。
- Helm チャート: $APIGEE_HELM_CHARTS_HOME/apigee-operator/etc/
- apigeectl: HYBRID_BASE_DIRECTORY/hybrid-files/
```
./tools/create-service-account --env non-prod --dir ./service-accounts
```
このコマンドにより、非本番環境で使用する apigee-non-prod という名前の 1 つのサービスアカウントが作成され、ダウンロードしたキーファイルが ./service-accounts ディレクトリに配置されます。
注: 本番環境用に個別のサービスアカウントをすべて作成する場合は、次のコマンドを使用します。
```
./tools/create-service-account --env prod --dir ./service-accounts
```
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_PATH
      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: "gs://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_PATH` Cloud Storage バケットのパス。形式は `gs://BUCKET_NAME` です。必ず `gs://` を付ける必要があります。
`backup:cloudProvider`	`GCP/HYBRID` Cloud Storage バックアップの場合は、プロパティを `GCP` に設定します。例: `cloudProvider: "GCP"` リモートサーバーのバックアップの場合は、プロパティを `HYBRID` に設定します。例: `cloudProvider: "HYBRID"`
`backup:schedule`	`BACKUP_SCHEDULE_CODE` バックアップの開始時刻。標準の crontab 構文で指定します。デフォルト: `0 2 * * *` 注: バックアップ構成をクラスタに適用した後、すぐにバックアップを開始するようなスケジュールは設定しないでください。バックアップ構成を適用すると、Kubernetes によって Cassandra ノードが再作成されます。ノードが再起動する前にバックアップが開始されると、最初のバックアップは失敗し、後続のバックアップは成功します。

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

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

kubectl get cronjob -n apigee

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

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

パラメータ

例

Helm

apigeectl

`apigeectl`