millispeed/gcloud-data-utilities

Google Cloud Storage 备份恢复工具镜像

镜像概述

该Docker镜像集成了用于文件和数据库备份、恢复的实用工具，专门设计用于与Google Cloud Storage (GCS) 交互，提供便捷的数据备份与灾难恢复解决方案。

核心功能与特性

• 文件备份：支持指定目录或文件的增量/全量备份至GCS存储桶
• 数据库备份：兼容主流数据库（MySQL、PostgreSQL等）的逻辑备份与恢复
• GCS集成：内置Google Cloud SDK工具（gsutil），支持GCS认证与文件操作
• 灵活配置：通过环境变量自定义备份路径、存储桶、数据库连接等参数
• 自动化支持：可配置定时备份任务，实现无人值守的周期性数据保护

使用场景

• 服务器数据定期备份与归档
• 数据库灾难恢复与数据迁移
• 跨环境（开发/测试/生产）数据同步
• 云存储数据备份策略实施

使用方法与配置说明

前提条件

• 拥有Google Cloud Platform账号及GCS存储桶
• 已创建GCP服务账号并下载JSON格式密钥文件（需具备GCS读写权限）

环境变量配置

Docker Run 部署示例

bash
docker run -d \
  --name gcs-backup \
  -v /local/credentials:/credentials \
  -v /data/to/backup:/data \
  -e GOOGLE_APPLICATION_CREDENTIALS=/credentials/gcs-key.json \
  -e GCS_BUCKET=my-backups \
  -e BACKUP_PATH=/data \
  -e DB_TYPE=mysql \
  -e DB_HOST=192.168.1.100 \
  -e DB_PORT=3306 \
  -e DB_USER=root \
  -e DB_PASSWORD=password \
  -e DB_NAME=appdb \
  -e BACKUP_SCHEDULE="0 3 * * *" \
  [镜像名称]

Docker Compose 配置示例

yaml
version: '3.8'
services:
  gcs-backup:
    image: [镜像名称]
    container_name: gcs-backup
    volumes:
      - ./credentials:/credentials
      - ./data:/data
    environment:
      - GOOGLE_APPLICATION_CREDENTIALS=/credentials/gcs-key.json
      - GCS_BUCKET=my-backups
      - BACKUP_PATH=/data
      - DB_TYPE=postgresql
      - DB_HOST=postgres
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=postgres
      - DB_NAME=appdb
      - BACKUP_SCHEDULE="0 */6 * * *"  # 每6小时备份一次
    depends_on:
      - postgres

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=appdb
    volumes:
      - postgres-data:/var/lib/postgresql/data

volumes:
  postgres-data:

手动执行备份/恢复

• 立即执行备份：

  bash
  docker exec gcs-backup /scripts/backup.sh
  

• 执行恢复操作：

  bash
  docker exec gcs-backup /scripts/restore.sh [备份文件名]
  

注：备份文件默认存储路径为 gs://<GCS_BUCKET>/backups/，文件名格式包含时间戳与数据类型标识