[CLOUDGA-26754] Describe GCP Backup Replication

[pranbansal02]

Overview

This PR adds CLI commands for managing GCP backup replication configuration. The implementation follows a cloud-first, action-second structure to support multiple cloud providers (GCP, AWS, Azure) in the future.

• Added Unit tests for the describe command
• Added documentation for all commands

Feature Flag: Command is gated behind YBM_FF_BACKUP_REPLICATION_GCP_TARGET feature flag

Commands Added

Command Structure

ybm cluster backup-replication
  └── gcp
      ├── describe
      ├── enable (later)
      ├── disable (later)
      ├── update (later)
      └── sync (later)

1. Parent Command: backup-replication

Command: ybm cluster backup-replication

Help Output:

Manage backup replication configuration for a cluster. Supports multiple cloud providers (GCP, AWS, Azure).

Usage:
  ybm cluster backup-replication [flags]
  ybm cluster backup-replication [command]

Available Commands:
  gcp         Manage GCP backup replication configuration

Flags:
  -h, --help   help for backup-replication

2. Cloud Subcommand: gcp

Command: ybm cluster backup-replication gcp

Help Output:

Manage GCP backup replication configuration for a cluster

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

Available Commands:
  describe    Describe the current GCP backup replication configuration

Flags:
  -c, --cluster-name string   [REQUIRED] The name of the cluster.
  -h, --help                  help for gcp

3. Action Command: describe

Command: ybm cluster backup-replication gcp describe

Help Output:

Describe the current GCP backup replication configuration for the specified cluster

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

Flags:
  -h, --help       help for describe
      --show-all   Show all configurations including scheduled for expiry and removed regions

Table Output

• Default view

$ ./ybm cluster backup-replication gcp describe --cluster-name gp-vpc
Overall State: ENABLED

Region     Config State   Bucket Name              Latest Operation Status   Last Run           Next Run
us-west1   ENABLED        backup-bucket-us-west1   SUCCESS                   2024-01-15,09:30   2024-01-15,10:00
us-east1   ENABLED        backup-bucket-us-east1   IN_PROGRESS               N/A                2024-01-15,11:00

• Show all view

Columns:

• Region: Cluster region GCP code (from spec.regional_targets)
• Config State: State of the backup replication config (ENABLED/DISABLED)
• Bucket Name: Target GCS bucket name (from spec.regional_targets[].target)
• Latest Operation Status: Status of the latest transfer operation (SUCCESS/IN_PROGRESS/FAILED/N/A)
• Last Run: End time of the last transfer operation (formatted as "YYYY-MM-DD,HH:MM" in local timezone, or "N/A")
• Next Run: Next scheduled transfer operation time (formatted as "YYYY-MM-DD,HH:MM" in local timezone, or "N/A")
• Expiry Time: Scheduled expiry time of the replication config (formatted as "YYYY-MM-DD,HH:MM" in local timezone, or "N/A") [Only Present for Configurations Set for Expiry]

[posriniv]

Looks good to me!