leen15/check-last-s3-file

检查S3最新文件

该镜像包含一个实用脚本，用于查找S3存储桶中的最新文件，并验证其大小和最后修改时间戳是否符合预设条件，常用于监控备份的更新状态。

核心功能

• 查找指定S3存储桶及路径下的最新文件
• 检查文件大小是否满足最小要求
• 检查文件修改时间是否在允许的时间范围内
• 输出详细的检查结果及错误信息（若不符合条件）

使用场景

• 数据库备份状态监控：验证备份文件是否按时生成且大小正常
• 关键数据文件更新检查：确保S3存储中的重要文件定期更新
• 自动化运维：通过定时任务（如cron）实现无人值守的文件状态检查

配置说明

需设置以下必填环境变量：

TIMEZONE=                  // 示例：Europe/Rome（时区设置）
AWS_ACCESS_KEY_ID=         // AWS访问密钥ID
AWS_SECRET_ACCESS_KEY=     // AWS秘密访问密钥
AWS_REGION=                // 示例：eu-west-1（S3存储桶所在区域）
BUCKET=                    // 存储桶名称（如Backups）
PATH_PREFIX=               // 子路径及文件前缀（如/databases/my-database）
OLDER_THAN_MINUTES=        // 允许的最大过期时间（分钟，如60表示1小时）
SMALLER_THAN_MEGABYTES=    // 允许的最小文件大小（MB，如100表示100MB）

使用示例

1. 创建.env文件并填写上述环境变量
2. 运行镜像：

bash
docker run --env-file .env leen15/check-last-s3-file

典型输出示例

Check last file in:
Bucket:          backups
Prefix:          databases/my-database
Older than:      60 minutes
Smaller than:    100 MB
Files in bucket: 4

Most recent file is:
Name:          my-database.2019-11-22-00-10-09.native.dump.bz2
modified at:   2019-11-22 01:10:11 +0100 CET
Size:          50 MB

[ERROR] The file is older than max allowed. ( 13h57m23.59s ago )
[ERROR] The file is smaller than min allowed. ( 50 vs 100 MB )

许可证

本项目基于MIT许可证发布。