Sprint 3 Implementation - Cloud URI Support: New Features: ✅ Cloud URI parser (s3://bucket/path) ✅ Backup command with --cloud URI flag ✅ Restore from cloud URIs ✅ Verify cloud backups ✅ Cleanup cloud storage with retention policy New Files: - internal/cloud/uri.go - Cloud URI parser - internal/restore/ - Cloud download module - internal/restore/cloud_download.go - Download & verify helper Modified Commands: - cmd/backup.go - Added --cloud s3://bucket/path flag - cmd/restore.go - Auto-detect & download from cloud URIs - cmd/verify.go - Verify backups from cloud storage - cmd/cleanup.go - Apply retention policy to cloud storage URI Support: - s3://bucket/path/file.dump - AWS S3 - minio://bucket/path/file.dump - MinIO - b2://bucket/path/file.dump - Backblaze B2 - gs://bucket/path/file.dump - Google Cloud Storage Examples: # Backup with cloud URI dbbackup backup single mydb --cloud s3://my-bucket/backups/ # Restore from cloud dbbackup restore single s3://my-bucket/backups/mydb.dump --confirm # Verify cloud backup dbbackup verify-backup s3://my-bucket/backups/mydb.dump # Cleanup old cloud backups dbbackup cleanup s3://my-bucket/backups/ --retention-days 30 Features: - Automatic download to temp directory - SHA-256 verification after download - Automatic temp file cleanup - Progress tracking for downloads - Metadata synchronization - Retention policy for cloud storage Sprint 3 Part 1 COMPLETE!
225 lines
6.9 KiB
Go
Executable File
225 lines
6.9 KiB
Go
Executable File
package cmd
|
|
|
|
import (
|
|
"fmt"
|
|
|
|
"dbbackup/internal/cloud"
|
|
"github.com/spf13/cobra"
|
|
)
|
|
|
|
// backupCmd represents the backup command
|
|
var backupCmd = &cobra.Command{
|
|
Use: "backup",
|
|
Short: "Create database backups",
|
|
Long: `Create database backups with support for various modes:
|
|
|
|
Backup Modes:
|
|
cluster - Full cluster backup (all databases + globals) [PostgreSQL only]
|
|
single - Single database backup
|
|
sample - Sample database backup (reduced dataset)
|
|
|
|
Examples:
|
|
# Full cluster backup (PostgreSQL)
|
|
dbbackup backup cluster --db-type postgres
|
|
|
|
# Single database backup
|
|
dbbackup backup single mydb --db-type postgres
|
|
dbbackup backup single mydb --db-type mysql
|
|
|
|
# Sample database backup
|
|
dbbackup backup sample mydb --sample-ratio 10 --db-type postgres`,
|
|
}
|
|
|
|
var clusterCmd = &cobra.Command{
|
|
Use: "cluster",
|
|
Short: "Create full cluster backup (PostgreSQL only)",
|
|
Long: `Create a complete backup of the entire PostgreSQL cluster including all databases and global objects (roles, tablespaces, etc.)`,
|
|
Args: cobra.NoArgs,
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
return runClusterBackup(cmd.Context())
|
|
},
|
|
}
|
|
|
|
var singleCmd = &cobra.Command{
|
|
Use: "single [database]",
|
|
Short: "Create single database backup",
|
|
Long: `Create a backup of a single database with all its data and schema`,
|
|
Args: cobra.MaximumNArgs(1),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
dbName := ""
|
|
if len(args) > 0 {
|
|
dbName = args[0]
|
|
} else if cfg.SingleDBName != "" {
|
|
dbName = cfg.SingleDBName
|
|
} else {
|
|
return fmt.Errorf("database name required (provide as argument or set SINGLE_DB_NAME)")
|
|
}
|
|
|
|
return runSingleBackup(cmd.Context(), dbName)
|
|
},
|
|
}
|
|
|
|
var sampleCmd = &cobra.Command{
|
|
Use: "sample [database]",
|
|
Short: "Create sample database backup",
|
|
Long: `Create a sample database backup with reduced dataset for testing/development.
|
|
|
|
Sampling Strategies:
|
|
--sample-ratio N - Take every Nth record (e.g., 10 = every 10th record)
|
|
--sample-percent N - Take N% of records (e.g., 20 = 20% of data)
|
|
--sample-count N - Take first N records from each table
|
|
|
|
Warning: Sample backups may break referential integrity due to sampling!`,
|
|
Args: cobra.MaximumNArgs(1),
|
|
RunE: func(cmd *cobra.Command, args []string) error {
|
|
dbName := ""
|
|
if len(args) > 0 {
|
|
dbName = args[0]
|
|
} else if cfg.SingleDBName != "" {
|
|
dbName = cfg.SingleDBName
|
|
} else {
|
|
return fmt.Errorf("database name required (provide as argument or set SAMPLE_DB_NAME)")
|
|
}
|
|
|
|
return runSampleBackup(cmd.Context(), dbName)
|
|
},
|
|
}
|
|
|
|
func init() {
|
|
// Add backup subcommands
|
|
backupCmd.AddCommand(clusterCmd)
|
|
backupCmd.AddCommand(singleCmd)
|
|
backupCmd.AddCommand(sampleCmd)
|
|
|
|
// Cloud storage flags for all backup commands
|
|
for _, cmd := range []*cobra.Command{clusterCmd, singleCmd, sampleCmd} {
|
|
cmd.Flags().String("cloud", "", "Cloud storage URI (e.g., s3://bucket/path) - takes precedence over individual flags")
|
|
cmd.Flags().Bool("cloud-auto-upload", false, "Automatically upload backup to cloud after completion")
|
|
cmd.Flags().String("cloud-provider", "", "Cloud provider (s3, minio, b2)")
|
|
cmd.Flags().String("cloud-bucket", "", "Cloud bucket name")
|
|
cmd.Flags().String("cloud-region", "us-east-1", "Cloud region")
|
|
cmd.Flags().String("cloud-endpoint", "", "Cloud endpoint (for MinIO/B2)")
|
|
cmd.Flags().String("cloud-prefix", "", "Cloud key prefix")
|
|
|
|
// Add PreRunE to update config from flags
|
|
originalPreRun := cmd.PreRunE
|
|
cmd.PreRunE = func(c *cobra.Command, args []string) error {
|
|
// Call original PreRunE if exists
|
|
if originalPreRun != nil {
|
|
if err := originalPreRun(c, args); err != nil {
|
|
return err
|
|
}
|
|
}
|
|
|
|
// Check if --cloud URI flag is provided (takes precedence)
|
|
if c.Flags().Changed("cloud") {
|
|
if err := parseCloudURIFlag(c); err != nil {
|
|
return err
|
|
}
|
|
} else {
|
|
// Update cloud config from individual flags
|
|
if c.Flags().Changed("cloud-auto-upload") {
|
|
if autoUpload, _ := c.Flags().GetBool("cloud-auto-upload"); autoUpload {
|
|
cfg.CloudEnabled = true
|
|
cfg.CloudAutoUpload = true
|
|
}
|
|
}
|
|
|
|
if c.Flags().Changed("cloud-provider") {
|
|
cfg.CloudProvider, _ = c.Flags().GetString("cloud-provider")
|
|
}
|
|
|
|
if c.Flags().Changed("cloud-bucket") {
|
|
cfg.CloudBucket, _ = c.Flags().GetString("cloud-bucket")
|
|
}
|
|
|
|
if c.Flags().Changed("cloud-region") {
|
|
cfg.CloudRegion, _ = c.Flags().GetString("cloud-region")
|
|
}
|
|
|
|
if c.Flags().Changed("cloud-endpoint") {
|
|
cfg.CloudEndpoint, _ = c.Flags().GetString("cloud-endpoint")
|
|
}
|
|
|
|
if c.Flags().Changed("cloud-prefix") {
|
|
cfg.CloudPrefix, _ = c.Flags().GetString("cloud-prefix")
|
|
}
|
|
}
|
|
|
|
return nil
|
|
}
|
|
}
|
|
|
|
// Sample backup flags - use local variables to avoid cfg access during init
|
|
var sampleStrategy string
|
|
var sampleValue int
|
|
var sampleRatio int
|
|
var samplePercent int
|
|
var sampleCount int
|
|
|
|
sampleCmd.Flags().StringVar(&sampleStrategy, "sample-strategy", "ratio", "Sampling strategy (ratio|percent|count)")
|
|
sampleCmd.Flags().IntVar(&sampleValue, "sample-value", 10, "Sampling value")
|
|
sampleCmd.Flags().IntVar(&sampleRatio, "sample-ratio", 0, "Take every Nth record")
|
|
sampleCmd.Flags().IntVar(&samplePercent, "sample-percent", 0, "Take N% of records")
|
|
sampleCmd.Flags().IntVar(&sampleCount, "sample-count", 0, "Take first N records")
|
|
|
|
// Set up pre-run hook to handle convenience flags and update cfg
|
|
sampleCmd.PreRunE = func(cmd *cobra.Command, args []string) error {
|
|
// Update cfg with flag values
|
|
if cmd.Flags().Changed("sample-ratio") && sampleRatio > 0 {
|
|
cfg.SampleStrategy = "ratio"
|
|
cfg.SampleValue = sampleRatio
|
|
} else if cmd.Flags().Changed("sample-percent") && samplePercent > 0 {
|
|
cfg.SampleStrategy = "percent"
|
|
cfg.SampleValue = samplePercent
|
|
} else if cmd.Flags().Changed("sample-count") && sampleCount > 0 {
|
|
cfg.SampleStrategy = "count"
|
|
cfg.SampleValue = sampleCount
|
|
} else if cmd.Flags().Changed("sample-strategy") {
|
|
cfg.SampleStrategy = sampleStrategy
|
|
}
|
|
if cmd.Flags().Changed("sample-value") {
|
|
cfg.SampleValue = sampleValue
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// Mark the strategy flags as mutually exclusive
|
|
sampleCmd.MarkFlagsMutuallyExclusive("sample-ratio", "sample-percent", "sample-count")
|
|
}
|
|
|
|
// parseCloudURIFlag parses the --cloud URI flag and updates config
|
|
func parseCloudURIFlag(cmd *cobra.Command) error {
|
|
cloudURI, _ := cmd.Flags().GetString("cloud")
|
|
if cloudURI == "" {
|
|
return nil
|
|
}
|
|
|
|
// Parse cloud URI
|
|
uri, err := cloud.ParseCloudURI(cloudURI)
|
|
if err != nil {
|
|
return fmt.Errorf("invalid cloud URI: %w", err)
|
|
}
|
|
|
|
// Enable cloud and auto-upload
|
|
cfg.CloudEnabled = true
|
|
cfg.CloudAutoUpload = true
|
|
|
|
// Update config from URI
|
|
cfg.CloudProvider = uri.Provider
|
|
cfg.CloudBucket = uri.Bucket
|
|
|
|
if uri.Region != "" {
|
|
cfg.CloudRegion = uri.Region
|
|
}
|
|
|
|
if uri.Endpoint != "" {
|
|
cfg.CloudEndpoint = uri.Endpoint
|
|
}
|
|
|
|
if uri.Path != "" {
|
|
cfg.CloudPrefix = uri.Dir()
|
|
}
|
|
|
|
return nil
|
|
} |