[CLOUDGA-26749] [CLOUDGA-26752] [CLOUDGA-26753] Enable/Update/Disable GCP Backup Replication

[pranbansal02]

Overview

This PR adds CLI commands for enabling and updating GCP backup replication configuration.

• Added Unit tests for the enable command
• Added documentation for all commands
• Feature Flag: Command is gated behind YBM_FF_BACKUP_REPLICATION_GCP_TARGET feature flag

Commands Added

1. Action Command: enable

Command: ybm cluster backup-replication gcp enable

Help Output:

Enable GCP backup replication for all backup regions in the cluster

Usage:
  ybm cluster backup-replication gcp enable [flags]

Flags:
  -h, --help                        help for enable
      --region-target stringArray   [REQUIRED] Specify region and bucket pairs for backup replication. Format: region=<region-name>,bucket-name=<bucket-name>. Must be specified for each backup region in the cluster.

Global Flags:
  -c, --cluster-name string   [REQUIRED] The name of the cluster.
  -o, --output string         Select the desired output format (table, json, pretty). Default to table
      --wait                  Wait until the task is completed, otherwise it will exit immediately, default to false

Usage Example:

$ ./ybm cluster backup-replication gcp enable \
  --cluster-name gp-vpc \
  --region-target region=asia-southeast1,bucket-name=backup-bucket-1 \
  --region-target region=asia-south1,bucket-name=backup-bucket-2

Output (without --wait):

GCP backup replication for cluster gp-vpc is being enabled

Overall State: ENABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 ENABLED        backup-bucket-1          SUCCESS                   2024-01-15,09:30   2024-01-15,10:00
asia-south1     ENABLED        backup-bucket-2          IN_PROGRESS               N/A                2024-01-15,11:00

Output (with --wait):

GCP backup replication for cluster gp-vpc is being enabled: SUCCEEDED

GCP backup replication has been enabled for cluster gp-vpc

Overall State: ENABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 ENABLED        backup-bucket-1          SUCCESS                   2024-01-15,09:30   2024-01-15,10:00
asia-south1     ENABLED        backup-bucket-2          IN_PROGRESS               N/A                2024-01-15,11:00

---

2. Action Command: update

Command: ybm cluster backup-replication gcp update

Help Output:

Update GCP backup replication configuration for all backup regions in the cluster

Usage:
  ybm cluster backup-replication gcp update [flags]

Flags:
  -h, --help                        help for update
      --region-target stringArray   [REQUIRED] Specify region and bucket pairs for backup replication. Format: region=<region-name>,bucket-name=<bucket-name>. Must be specified for each backup region in the cluster.

Global Flags:
  -c, --cluster-name string   [REQUIRED] The name of the cluster.
  -o, --output string         Select the desired output format (table, json, pretty). Default to table
      --wait                  Wait until the task is completed, otherwise it will exit immediately, default to false

Usage Example:

$ ./ybm cluster backup-replication gcp update \
  --cluster-name gp-vpc \
  --region-target region=asia-southeast1,bucket-name=new-backup-bucket-1 \
  --region-target region=asia-south1,bucket-name=new-backup-bucket-2

Output (without --wait):

GCP backup replication for cluster gp-vpc is being updated

Overall State: ENABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 ENABLED        new-backup-bucket-1       SUCCESS                   2024-01-15,09:30   2024-01-15,10:00
asia-south1     ENABLED        new-backup-bucket-2      IN_PROGRESS               N/A                2024-01-15,11:00

Output (with --wait):

GCP backup replication for cluster gp-vpc is being updated: SUCCEEDED

GCP backup replication has been updated for cluster gp-vpc

Overall State: ENABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 ENABLED        new-backup-bucket-1       SUCCESS                   2024-01-15,09:30   2024-01-15,10:00
asia-south1     ENABLED        new-backup-bucket-2       IN_PROGRESS               N/A                2024-01-15,11:00

Validation for enable and update:

• Requires --region-target for each backup region in the cluster
• Validates region format: region=<region-name>,bucket-name=<bucket-name>
• Validates that all specified regions are backup regions of the cluster
• Validates no duplicate regions are provided
• Validates that all backup regions have corresponding --region-target entries

---

3. Action Command: disable

Command: ybm cluster backup-replication gcp disable

Help Output:

Disable GCP backup replication for all backup regions in the cluster

Usage:
  ybm cluster backup-replication gcp disable [flags]

Flags:
  -f, --force   Bypass the confirmation prompt for non-interactive usage
  -h, --help    help for disable

Global Flags:
  -c, --cluster-name string   [REQUIRED] The name of the cluster.
  -o, --output string         Select the desired output format (table, json, pretty). Default to table
      --wait                  Wait until the task is completed, otherwise it will exit immediately, default to false

Usage Example:

$ ./ybm cluster backup-replication gcp disable \
  --cluster-name gp-vpc \
  --force

Output (without --wait):

GCP backup replication for cluster gp-vpc is being disabled

Overall State: DISABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 DISABLED        backup-bucket-1          SUCCESS                   2024-01-15,09:30   N/A
asia-south1     DISABLED        backup-bucket-2          IN_PROGRESS               N/A                N/A

Output (with --wait):

GCP backup replication for cluster gp-vpc is being disabled: SUCCEEDED

GCP backup replication has been disabled for cluster gp-vpc

Overall State: DISABLED
Region          Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
asia-southeast1 DISABLED        backup-bucket-1          SUCCESS                   2024-01-15,09:30   N/A
asia-south1     DISABLED        backup-bucket-2          IN_PROGRESS               N/A                N/A

[posriniv]

Looks okay to me. Let's wait for Siddharth's review too.