Ir al contenido

DOC-05:运营与维护(日常运营)

定期维护手册,无凭证暴露的备份自动化和Redmine基础设施的灾难恢复计划。

0阅读

企业环境的弹性完全取决于其灾难恢复能力。为确保稳健的备份策略,我们实施数据隔离原则和消除系统终端中暴露的明文密码。

[!CAUTION] 凭据暴露风险: 切勿在终端中以交互方式传递 MySQL 密码(例如 -p"mi_contraseña")。这样做会以明文形式将密码记录在 bash 命令历史(~/.bash_history)以及系统进程表中,任何本地用户都可以通过 ps aux 查看。

为解决此安全漏洞,我们在容器内部或通过挂载卷的方式实现一个安全的 MySQL 客户端配置文件(.my.cnf)。

在主机服务器的受保护配置目录中创建MySQL客户端的选项文件:

Ventana de terminal
mkdir -p ~/redmine/config/secrets
nano ~/redmine/config/secrets/mysql_backup.cnf

以结构化方式添加数据库管理凭证:

[client]
user=redmine
password=contrasena_secreta_portelcore
host=redmine_db

只有基础设施自动化服务账户(portel_user)和 Docker 守护进程才能读取此文件:

Ventana de terminal
chmod 600 ~/redmine/config/secrets/mysql_backup.cnf

确保 mysql_backup.cnf 文件以只读模式(:ro)挂载到 docker-compose.yml 文件的 redmine_db 服务中:

services:
redmine_db:
# ... otras configuraciones
volumes:
- ./config/secrets/mysql_backup.cnf:/etc/mysql/conf.d/mysql_backup.cnf:ro

映射后,从计划任务脚本(CRON)中执行数据库转储,而不会在日志或系统历史记录中暴露任何密码:

Ventana de terminal
# Ejecución segura mediante el uso del archivo de configuración interno
docker exec -i redmine_db mysqldump --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine > ~/redmine/backups/redmine_backup_$(date +%F).sql

Redmine将门户附件、高级视觉主题和集成插件存储在主机目录中。为了备份它们,我们创建一个高性能压缩存档:

Ventana de terminal
# Compresión recursiva preservando metadatos y permisos originales de Linux
tar -czpf ~/redmine/backups/redmine_assets_$(date +%F).tar.gz -C ~/redmine files themes plugins config

在发生完全数据丢失或物理主机损坏的情况下,按照以下分步程序在新节点上恢复操作性:

  1. < strong >部署:按照< strong >DOC-01、< strong >DOC-02和< strong >DOC-03指南安装操作系统并启动空基础设施。
  2. 临时停止: 停止应用容器,以避免在恢复数据期间出现写入不一致:
    Ventana de terminal
    cd ~/redmine
    docker compose stop redmine
  3. 数据库恢复: 使用已配置的安全连接导入 SQL 转储:
    Ventana de terminal
    docker exec -i redmine_db mysql --defaults-extra-file=/etc/mysql/conf.d/mysql_backup.cnf redmine < ~/redmine/backups/redmine_backup_2026-05-22.sql
  4. 文件恢复: 将文件和插件解压到主机上的相应位置,确保覆盖空的持久化目录:
    Ventana de terminal
    tar -xzpf ~/redmine/backups/redmine_assets_2026-05-22.tar.gz -C ~/redmine
  5. 权限重新配置: 将生产隔离用户(999)的所有权重新应用到文件系统:
    Ventana de terminal
    sudo chown -R 999:999 ~/redmine/files ~/redmine/themes ~/redmine/plugins ~/redmine/config
  6. 完全启动: 重新启动应用:
    Ventana de terminal
    docker compose start redmine

为了保护Redmine实例免受Ruby on Rails框架漏洞的影响,并利用最新的性能改进:

  1. < strong >备份:手动备份数据库和附件(第1部分)。
  2. 更新注册表镜像: 下载官方最新稳定版标签:
    Ventana de terminal
    docker compose pull redmine
  3. 停止与重建: 在后台停止并启动整个栈。Docker 将基于新的基础镜像以不可变方式重新创建容器:
    Ventana de terminal
    docker compose down
    Ventana de terminal
    docker compose up -d
  4. 数据库与插件迁移: 如果版本升级引入了 Redmine 关系数据库模式或插件的更改,请直接调用 Rake 编译任务:
    Ventana de terminal
    docker compose run --rm redmine bundle exec rake redmine:plugins:migrate RAILS_ENV=production

实施此每周清单以确保系统保持健康并严格遵循维护策略:

  • ✓ 备份状态: 检查每日 SQL 转储是否正确生成在 ~/redmine/backups/,且大小不为零。
  • ✓ 所有者验证(UID 999): 确认用户通过附件门户上传的文件没有破坏本地服务器的权限层级。
  • ✓ 磁盘空间清理:清除Docker引擎中的孤儿镜像和卷,以防止Proxmox虚拟化平台的虚拟硬盘空间耗尽。
  • ✓ 实验室 DNS 一致性: 验证 *.portelcore.com 扩展下域名的内部解析是否正确。