Container Service for Kubernetes:kubectl を使用したアプリケーションのバックアップとリストア

バックアップクラスターに applicationbackup.yaml ファイルを作成します。

コンソールで作成されたバックアップジョブの場合、includeClusterResources のデフォルトは false です。

apiVersion: csdr.alibabacloud.com/v1beta1
kind: ApplicationBackup
metadata:
  annotations:
    # 必須。このバックアップを保存するバックアップリポジトリに関する情報。
    # 値はバックアップリポジトリの設定と一致する必要があります。
    csdr.alibabacloud.com/backuplocations: >-
      {"name":"<your-backup-repository-name>","region":"cn-beijing","bucket":"<cnfs-oss-your-bucket-name>","prefix":"<your-subdirectory-name>","provider":"alibabacloud"}
  name: <your-application-backup-name>   # 必須。オンデマンドバックアップの名前
  namespace: csdr
spec:
  includedNamespaces:
    - default                # 必須。バックアップに含める名前空間
  includedResources:
    - statefulset            # オプション。バックアップするリソースタイプ
  excludedResources:         # オプション。includedResources と一緒に設定すると
    - deployment             # 予期しない結果が生じます。いずれか一方のみを設定してください。
                             # 両方が空の場合、すべてのリソースタイプがバックアップされます。
  labelSelector:
    matchLabels:
      app: mysql-sts         # オプション。このラベルを持つリソースのみがバックアップされます
  includeClusterResources: false   # オプション。false：選択された名前空間のリソースから参照される
                                   # クラスターレベルのリソースのみがバックアップされます
                                   # (ClusterRole や CRD など)
                                   # true：すべてのクラスターレベルのリソースがバックアップされます
  pvBackup:
    defaultPvBackup: false   # 必須。PV をバックアップするかどうか、つまり
                             # データバックアップを有効にするかどうか：
                             # false：アプリケーションリソースのみをバックアップ
                             # true：アプリケーションリソースと PV をバックアップ
  storageLocation: <your-backup-repository-name>
                             # 必須。バックアップリポジトリの名前。
                             # 注意：クラスターがすでに Velero を使用している場合は、
                             # DingTalk ユーザーグループ (グループ番号：35532895) にご参加ください。
  ttl: 720h0m0s              # 必須。保持期間。範囲：24h0m0s から 1572864h0m0s。
                             # 保持期間が経過すると、バックアップデータは
                             # リストアできなくなります。

その他のパラメーターは設定不要です。デフォルト値のままにしてください。

バックアップクラスターにマニフェストを適用します。

kubectl apply -f applicationbackup.yaml

バックアップステータスを確認します。

kubectl describe applicationbackup <your-application-backup-name> -n csdr

Phase が Inprogress から Completed に変わると、バックアップは完了です。

...
Status:
  Completion Timestamp:  2022-12-05T15:02:35Z
  Expiration:            2023-01-04T15:02:25Z
  Message:               success
  Phase:                 Completed

バックアップクラスターに backupschedule.yaml ファイルを作成します。

apiVersion: csdr.alibabacloud.com/v1beta1
kind: BackupSchedule
metadata:
  annotations:
    # 必須。このバックアップを保存するバックアップリポジトリに関する情報。
    # 値はバックアップリポジトリの設定と一致する必要があります。
    csdr.alibabacloud.com/backuplocations: >-
      {"name":"<your-backup-repository-name>","region":"cn-beijing","bucket":"<cnfs-oss-your-bucket-name>","prefix":"<your-subdirectory-name>","provider":"alibabacloud"}
  name: <your-backup-schedule-name>   # 必須。スケジュールバックアップ計画の名前
  namespace: csdr
spec:
  schedule: 1 4 * * *   # 必須。Cron 式：
                         # ┌── 分 (0–59)
                         # │ ┌── 時 (0–23)
                         # │ │ ┌── 日 (1–31)
                         # │ │ │ ┌── 月 (1–12)
                         # │ │ │ │ ┌── 曜日 (0–6、日曜日=0)
                         # │ │ │ │ │
                         # 1 4 * * *  → 毎日 04:01 に実行
                         # その他の Cron 式の例については、「バックアップスケジュールの指定方法」をご参照ください。
  template:
    includedNamespaces:
      - default              # 必須。バックアップに含める名前空間
    includedResources:
      - statefulset          # オプション。バックアップするリソースタイプ
    excludedResources:       # オプション。includedResources と一緒に設定すると
      - deployment           # 予期しない結果が生じます。いずれか一方のみを設定してください。
                             # 両方が空の場合、すべてのリソースタイプがバックアップされます。
    labelSelector:
      matchLabels:
        app: mysql-sts       # オプション。このラベルを持つリソースのみがバックアップされます
    includeClusterResources: false   # オプション
    pvBackup:
      defaultPvBackup: true   # 必須。PV をバックアップするかどうか、つまり
                              # データバックアップを有効にするかどうか：
                              # true：アプリケーションリソースと PV をバックアップ
                              # false：アプリケーションリソースのみをバックアップ
    storageLocation: <your-backup-repository-name>
                               # 必須。バックアップリポジトリの名前。
                               # 注意：クラスターがすでに Velero を使用している場合は、
                               # DingTalk ユーザーグループ (グループ番号：35532895) にご参加ください。
    ttl: 720h0m0s              # 必須。保持期間。範囲：24h0m0s から 1572864h0m0s。
                               # 保持期間が経過すると、バックアップデータは
                               # リストアできなくなります。

その他のパラメーターは設定不要です。デフォルト値のままにしてください。

詳細については、「バックアップスケジュールの指定方法」をご参照ください。

バックアップクラスターにマニフェストを適用します。

kubectl apply -f backupschedule.yaml

スケジュールがアクティブであることを確認します。

kubectl describe backupschedule <your-backup-schedule-name> -n csdr

Phase が Enabled を示している場合、スケジュールは実行中です。

...
Status:
  Last Backup:          2022-12-07T20:01:11Z
  Last Processed Time:  2022-12-08T13:05:37Z
  Phase:                Enabled

スケジュールによって作成されたポイントインタイムバックアップを一覧表示します。

kubectl get applicationbackup -n csdr | grep <your-backup-schedule-name>

スケジュールされた各実行により、タイムスタンプ付きの ApplicationBackup リソースが作成されます。

<your-backup-schedule-name>-20221205225845   2d22h
<your-backup-schedule-name>-20221206040104   2d17h
<your-backup-schedule-name>-20221207040137   41h
<your-backup-schedule-name>-20221208040111   17h

これらの名前を記録してください。リストアタスクを作成する際に必要になります。

バックアップクラスターに applicationbackup.yaml ファイルを作成します。

apiVersion: csdr.alibabacloud.com/v1beta1
kind: ApplicationBackup
metadata:
  annotations:
    # 必須。このバックアップを保存するバックアップリポジトリに関する情報。
    # 値はバックアップリポジトリの設定と一致する必要があります。
    csdr.alibabacloud.com/backuplocations: >-
      {"name":"<your-backup-repository-name>","region":"cn-beijing","bucket":"<cnfs-oss-your-bucket-name>","prefix":"<your-subdirectory-name>","provider":"alibabacloud"}
  name: <your-application-backup-name>   # 必須。オンデマンドバックアップの名前
  namespace: csdr
spec:
  backupType: PvBackup   # 必須。データ保護の固定値
  includedNamespaces:
    - default      # 必須。バックアップに含める名前空間
  pvBackup:
    # オプション。オプション 1：PVC 名で PV を指定します。storageClassList も指定した場合、
    # storageClassList は無視されます。いずれか一方のみを設定してください。
    pvcList:
      - name: essd-pvc-0
        namespace: default
      - name: essd-pvc-1
        namespace: default
    # オプション。オプション 2：StorageClass で PV を指定します。pvcList も指定した場合、
    # このパラメーターは無視されます。いずれか一方のみを設定してください。
    storageClassList:
      - disk-essd
      - disk-ssd
    # pvcList も storageClassList も設定されていない場合、名前空間内のすべての PV がバックアップされます。
  storageLocation: <your-backup-repository-name>
                   # 必須。バックアップリポジトリの名前。
                   # 注意：クラスターがすでに Velero を使用している場合は、
                   # DingTalk ユーザーグループ (グループ番号：35532895) にご参加ください。
  ttl: 720h0m0s    # 必須。保持期間。範囲：24h0m0s から 1572864h0m0s。
                   # 保持期間が経過すると、バックアップデータは
                   # リストアできなくなります。

バックアップクラスターにマニフェストを適用します。

kubectl apply -f applicationbackup.yaml

バックアップステータスを確認します。

kubectl describe applicationbackup <your-application-backup-name> -n csdr

完了時の出力例：

...
Status:
  Completion Timestamp:  2025-03-25T08:20:24Z
  Expiration:            2025-04-24T08:18:03Z
  Message:               success
  Phase:                 Completed

バックアップクラスターに backupschedule.yaml ファイルを作成します。

apiVersion: csdr.alibabacloud.com/v1beta1
kind: BackupSchedule
metadata:
  annotations:
    # 必須。このバックアップを保存するバックアップリポジトリに関する情報。
    # 値はバックアップリポジトリの設定と一致する必要があります。
    csdr.alibabacloud.com/backuplocations: >-
      {"name":"<your-backup-repository-name>","region":"cn-beijing","bucket":"<cnfs-oss-your-bucket-name>","prefix":"<your-subdirectory-name>","provider":"alibabacloud"}
  name: <your-backup-schedule-name>   # 必須。スケジュールバックアップ計画の名前
  namespace: csdr
spec:
  schedule: 1 4 * * *      # 必須。Cron 形式のバックアップ間隔
  template:
    backupType: PvBackup   # 必須。データ保護の固定値
    includedNamespaces:
      - default            # 必須。バックアップに含める名前空間
    pvBackup:
      # オプション。PVC 名で PV を指定します。storageClassList も指定した場合、
      # storageClassList は無視されます。いずれか一方のみを設定してください。
      pvcList:
        - name: essd-pvc-0
          namespace: default
        - name: essd-pvc-1
          namespace: default
      # オプション。StorageClass で PV を指定します。pvcList も指定した場合、
      # このパラメーターは無視されます。いずれか一方のみを設定してください。
      storageClassList:
        - disk-essd
        - disk-ssd
    storageLocation: <your-backup-repository-name>   # 必須。バックアップリポジトリ名
    ttl: 720h0m0s          # 必須。保持期間。範囲：24h0m0s から 1572864h0m0s。
                           # 保持期間が経過すると、バックアップデータは
                           # リストアできなくなります。

バックアップクラスターにマニフェストを適用します。

kubectl apply -f backupschedule.yaml

スケジュールがアクティブであることを確認します。

kubectl describe backupschedule <your-backup-schedule-name> -n csdr

アクティブな場合の出力例：

...
Status:
  Last Backup:  2025-03-25T09:24:38Z
  Phase:        Enabled