steveliedtke/simple_backup_dir

simple_backup_dir

该镜像通过复制目录创建简单的目录备份。备份目录生成在源目录旁边，并自动添加日期戳；若当前日期的备份目录已存在，则依次添加计数器（如_1、_2等）。

假设当前日期为2024年5月25日，预期结果如下：

• /data/my_directory 会备份到 /data/my_directory_backup_2024-05-25（当日无其他备份目录时）
• 若备份目录 /data/my_directory_backup_2024-05-25 已存在，则 /data/my_directory 会备份到 /data/my_directory_backup_2024-05-25_1
• 若备份目录 /data/my_directory_backup_2024-05-25_1 已存在，则 /data/my_directory 会备份到 /data/my_directory_backup_2024-05-25_2
• 依此类推

使用方法

使用命令参数

docker run 
        -v /data:/app/data 
        steveliedtke/simple_backup_dir:0.7.1 /app/backup.sh data/my_directory

使用环境变量

docker run 
        -v /data:/app/data 
        -e BACKUP_DIR=data/my_directory 
        steveliedtke/simple_backup_dir:0.7.1

使用Kubernetes任务

可将备份作为Kubernetes任务运行，以下是示例清单：

yaml
apiVersion: batch/v1
kind: Job
metadata:
  name: directory-backup-job
spec:
  template:
    spec:
      containers:
      - name: backup
        image: steveliedtke/simple_backup_dir:0.7.1
        env:
        - name: BACKUP_DIR
          value: "data/my_directory"
        volumeMounts:
        - name: data-volume
          mountPath: /app/data
      volumes:
      - name: data-volume
        persistentVolumeClaim:
          claimName: your-pvc-name
      restartPolicy: Never

该任务将：

1. 使用指定环境变量运行备份容器
2. 将持久卷挂载到 /app/data
3. 根据设置创建备份

若配合ArgoCD使用，可修改元数据以使用generateName和hook注解：

yaml
metadata:
  generateName: directory-backup-
  annotations:
    argocd.argoproj.io/hook: PreSync

清理选项

备份脚本支持通过两个可选环境变量自动清理旧备份。两个变量均无默认值，即若不设置，则不执行清理：

CLEANUP_MORE_THAN

该选项允许保留指定数量的最新备份并删除旧备份。

docker run 
        [..] 
        -e CLEANUP_MORE_THAN=5 
        steveliedtke/simple_backup_dir:0.7.1

在此示例中，将仅保留5个最新备份。创建新备份后，超出此限制的所有旧备份将被自动删除。

CLEANUP_OLDER_THAN_DAYS

该选项允许删除早于指定天数的备份。

docker run 
        [..] 
        -e CLEANUP_OLDER_THAN_DAYS=30 
        steveliedtke/simple_backup_dir:0.7.1

在此示例中，早于30天的所有备份将在创建新备份后被自动删除。

组合清理

可同时使用两个清理选项：

docker run 
        [..] 
        -e CLEANUP_MORE_THAN=5 
        -e CLEANUP_OLDER_THAN_DAYS=30 
        steveliedtke/simple_backup_dir:0.7.1

这将确保：

1. 仅保留5个最新备份
2. 不保留早于30天的备份

注意，两个清理操作独立运行，满足任一条件即触发备份删除。

其他变量

帮助标志

可使用 -h 或 --help 显示脚本帮助信息：

docker run steveliedtke/simple_backup_dir:0.7.1 /app/backup.sh --help

这将显示所有可用参数和环境变量及其描述。

ALPINE_REGEX

该环境变量控制用于查找备份目录的正则表达式语法，特别适用于不同环境。

docker run 
        [..] 
        -e ALPINE_REGEX=false 
        steveliedtke/simple_backup_dir:0.7.1

• 当 ALPINE_REGEX=true 时：使用Alpine Linux兼容的正则表达式语法（使用docker镜像时默认）
• 当 ALPINE_REGEX=false 时：使用标准Perl兼容模式的正则表达式语法

若在不同环境中遇到备份目录检测问题，可能需要调整此设置。Alpine版本特别适用于在基于Alpine的镜像上运行容器。