texastribune/pg-tools

texastribune/pg-tools

镜像概述和主要用途

texastribune/pg-tools是一个Docker化的工具集，专注于PostgreSQL数据库的数据导入与导出操作。该镜像封装了便捷的脚本工具，支持从多种数据源（如Amazon S3存储、网络URL）导入数据到PostgreSQL数据库，适用于数据库备份恢复、跨环境数据迁移等场景，提供一致且便捷的操作体验。

核心功能和特性

• 多源数据导入：支持从Amazon S3存储和网络URL导入PostgreSQL备份数据
• Docker容器化：无需本地配置依赖，通过容器化方式运行，确保环境一致性
• 环境变量配置：通过环境变量灵活配置数据库连接信息和数据源参数
• 轻量高效：专注核心功能，镜像体积小，运行效率高，易于集成到自动化流程

使用场景和适用范围

• PostgreSQL数据库的备份恢复操作
• 跨环境（如开发、测试、生产）的数据库数据迁移
• 从外部存储（S3）或网络位置批量导入数据库备份
• 集成到CI/CD管道实现自动化数据导入流程

使用方法和配置说明

环境变量说明

从S3导入数据

通过以下命令从Amazon S3存储导入PostgreSQL数据备份：

bash
docker run -it --rm \
  --link=db:db \
  --env=AWS_ACCESS_KEY_ID=<aws_access_key_id> \
  --env=AWS_SECRET_ACCESS_KEY=<aws_secret_access_key> \
  --env=DATABASE_URL=<database-url> \
  --env=S3_SOURCE=<s3-source> \
  texastribune/pg-tools /app/import-from-s3.sh

参数说明：

• --link=db:db：链接到目标PostgreSQL容器（假设容器名为db）
• <aws_access_key_id>：AWS访问密钥ID
• <aws_secret_access_key>：AWS密钥
• <database-url>：目标PostgreSQL数据库连接URL
• <s3-source>：S3中备份文件的完整路径

从URL导入数据

通过以下命令从指定URL导入PostgreSQL数据备份：

bash
docker run -it --rm \
  --link=db:db \
  --env=DATABASE_URL=<database-url> \
  --env=DATABASE_BACKUP_URL=<url-to-postgres-dump> \
  texastribune/pg-tools /app/import-from-url.sh

参数说明：

• --link=db:db：链接到目标PostgreSQL容器（假设容器名为db）
• <database-url>：目标PostgreSQL数据库连接URL
• <url-to-postgres-dump>：数据库备份文件的URL（如https://example.com/backup.sql）