tomdale55/dbs-snapper

Snapper容器（DBS专用）技术文档

镜像概述和主要用途

Snapper容器是专为DBS（数据库系统）设计的工具容器，集成了Snapper工具，旨在提供便捷的数据库快照创建、管理、备份及恢复功能。该容器通过标准化部署流程，帮助用户简化数据库数据保护操作，确保数据安全性和可恢复性，适用于各类基于DBS的应用场景。

核心功能和特性

• 快照管理：支持一键创建DBS数据库快照，记录数据库特定时间点的状态
• 备份自动化：可配置定时快照任务，实现数据库备份自动化
• 快照存储：提供快照文件的集中存储与管理，支持自定义存储路径
• 快速恢复：支持从快照快速恢复数据库至指定时间点状态
• DBS集成：针对DBS数据库系统特性优化，确保快照操作与数据库一致性
• 轻量级设计：容器体积小，资源占用低，易于部署和维护

使用场景和适用范围

使用场景

• 数据库日常备份：定期为生产环境DBS数据库创建快照，防止数据丢失
• 数据迁移：通过快照快速复制数据库数据至其他环境（如测试、开发环境）
• 版本控制：为数据库变更（如 schema 修改、数据更新）创建快照，便于版本回溯
• 故障恢复演练：在非生产环境使用快照模拟数据恢复流程，验证恢复策略有效性

适用范围

• 使用DBS数据库系统的企业或个人用户
• 需要对数据库进行定期备份和数据保护的场景
• 追求自动化、标准化数据库管理流程的团队
• 需频繁进行数据库环境复制或版本控制的开发/测试场景

使用方法和配置说明

前提条件

• 已安装Docker引擎（推荐版本20.10+）
• 可访问DBS数据库实例（网络可达，权限足够）
• 宿主机已配置用于存储快照的目录（需持久化存储）

镜像获取

bash
docker pull [镜像仓库地址]/snapper-dbs:latest

（注：请将[镜像仓库地址]替换为实际的容器镜像仓库地址）

基本运行命令

bash
docker run -d \
  --name snapper-dbs \
  -e DBS_HOST=your-dbs-host \       # DBS数据库主机地址
  -e DBS_PORT=5432 \                # DBS数据库端口（默认5432）
  -e DBS_USER=dbadmin \             # DBS数据库用户名
  -e DBS_PASSWORD=your-password \   # DBS数据库密码
  -e SNAPSHOT_DIR=/snapshots \      # 容器内快照存储路径（默认/snapshots）
  -v /host/snapshots:/snapshots \   # 挂载宿主机目录用于持久化快照
  -v /host/dbs/config:/dbs/config \ # （可选）挂载DBS配置文件目录
  [镜像仓库地址]/snapper-dbs:latest

Docker Compose配置示例

yaml
version: '3'
services:
  snapper-dbs:
    image: [镜像仓库地址]/snapper-dbs:latest
    container_name: snapper-dbs
    environment:
      - DBS_HOST=your-dbs-host
      - DBS_PORT=5432
      - DBS_USER=dbadmin
      - DBS_PASSWORD=your-password
      - SNAPSHOT_DIR=/snapshots
      - BACKUP_RETENTION_DAYS=7  # 快照保留天数（默认7天）
    volumes:
      - /host/snapshots:/snapshots
      - /host/dbs/config:/dbs/config
    restart: unless-stopped

主要配置参数（环境变量）

常用操作示例

1. 创建手动快照

bash
docker exec snapper-dbs snapper create --name manual-snapshot-$(date +%Y%m%d)

2. 列出所有快照

bash
docker exec snapper-dbs snapper list

3. 从快照恢复数据库

bash
docker exec snapper-dbs snapper restore --name manual-snapshot-20240101

4. 查看容器日志

bash
docker logs -f snapper-dbs

注意事项

• 确保DBS_USER拥有足够权限执行数据库快照操作（如CREATE SNAPSHOT、SELECT等权限）
• 快照存储目录需配置足够存储空间，避免因空间不足导致快照失败
• 生产环境建议通过docker-compose或容器编排工具（如Kubernetes）管理，确保容器高可用
• 定期验证快照可用性，建议每月执行一次恢复测试以确保数据可恢复性