怎样备份Puppet配置

备份 Puppet 配置通常包括主配置目录、证书、模块、清单文件、Hiera 数据以及 PuppetDB（如使用）。下面分场景说明。

一、核心备份内容

1. Puppet 主配置目录

最常见路径：

• /etc/puppetlabs/puppet/（Puppet 4+ / Puppet Enterprise）
• /etc/puppet/（Puppet 3 及旧版）

需要备份的关键文件：

• puppet.conf
• auth.conf
• fileserver.conf
• hiera.yaml
• environments/（若使用）

2. 证书和密钥（非常重要）

路径通常为：

/etc/puppetlabs/puppet/ssl/

包含：

• CA 证书
• 服务器证书
• 客户端证书
• 私钥

⚠️ 若丢失，需重新签发证书，代价很高。

3. 代码与数据

• Puppet 模块：/etc/puppetlabs/code/
• 环境目录（默认）：

  /etc/puppetlabs/code/environments/
  

• Hiera 数据：

  /etc/puppetlabs/puppet/hiera.yaml
  /etc/puppetlabs/code/environments/<env>/hieradata/
  

4. Puppet Master / Server 相关（如使用 Puppet Server）

• /etc/puppetserver/
• /etc/puppetlabs/puppetserver/

5. PuppetDB（如使用）

• 配置文件：/etc/puppetlabs/puppetdb/
• 数据库（PostgreSQL）：

  pg_dump puppetdb > puppetdb.sql
  

二、推荐备份方式

方式 1：直接打包（简单可靠）

tar czf puppet-backup-$(date +%F).tar.gz \
  /etc/puppetlabs/puppet \
  /etc/puppetlabs/code \
  /etc/puppetlabs/puppetserver \
  /etc/puppetlabs/puppetdb

方式 2：使用 Git（推荐用于代码和配置）

cd /etc/puppetlabs/code
git init
git add .
git commit -m "backup"

✅ 适合模块、Hiera、环境配置
❌ 不适合证书（私钥不应进 Git）

方式 3：rsync 到备份服务器

rsync -avz /etc/puppetlabs/ backup@backupserver:/backups/puppet/

三、Puppet Enterprise（PE）补充

如使用的是 PE：

• 使用 puppet-backup 工具（PE 2019+）：

  puppet-backup create
  

• 备份包含：
  • Puppet Server
  • PuppetDB
  • Console
  • 证书

四、恢复示例

tar xzf puppet-backup-2026-01-21.tar.gz -C /
systemctl restart puppetserver

五、最佳实践建议

• ✅ 定期备份（每日/每周）
• ✅ 证书单独加密备份
• ✅ 保留多份历史备份
• ✅ 演练恢复流程

如果你用的是 Puppet 3 / 4 / 5 / 7 / PE，或 Masterless 模式，可以告诉我具体环境，我可以给你更精确的备份脚本。