Puppet清单中类懒加载及多角色节点配置重复问题排查

问题背景梳理 #

你搭建了一个包含A、B、C三种角色的系统，用Puppet的concat模块生成统一配置文件。重构后将配置拆分为daemon::conf（全局配置）、daemon::conf::A（A角色导出配置）、daemon::conf::B（B角色本地配置），期望每个节点的/etc/daemon/config包含自身的[B]段+所有节点的[A]段，但实际运行后每个节点都出现了所有3台主机的[B]配置重复，同时还存在潜在的类重定义风险。

核心错误点分析 #

我帮你梳理出几个关键问题：

1. 路径不匹配：daemon::conf里的concat资源路径是/etc/daemon/conf，但所有concat::fragment的target都是/etc/daemon/config——这会导致片段无法关联到正确的concat资源，是最容易忽略的低级错误。
2. 收集逻辑过于宽泛：你用Concat::Fragment <<| target == '/etc/daemon/config' |>>收集所有导出的片段，如果B角色的片段被意外导出（比如误加了@@），就会被所有节点收集，导致重复。
3. 类声明方式易引发重定义：用include重复引入daemon::conf，在多角色节点上容易触发类重定义错误。

分步修复方案 #

1. 修复concat资源与片段的路径一致性 #

首先把daemon::conf里的concat资源路径改成和片段target一致：

class daemon::conf (...) {
  concat { '/etc/daemon/config':  # 与fragment的target统一
    owner => 'root',
    group => 'root',
    mode => '0664',
    require => Package['daemon'],
  }
  # 精准收集A角色的导出片段，避免误收集其他资源
  Concat::Fragment <<| tag == 'daemon.conf.a' and target == '/etc/daemon/config' |>>
  concat::fragment { 'daemon.conf.global':
    tag => "daemon.conf.global",
    target => '/etc/daemon/config',
    order => '01',
    content => template('daemon/daemon.conf.erb'),
  }
}

2. 确保A角色片段仅导出、B角色片段仅本地存在 #

给A角色的片段加专属标签，方便精准收集，同时确保B角色片段是本地资源（不带@@）：

修改daemon::conf::A（导出A角色配置）

define daemon::conf::A (...) {
  ensure_resource('class', '::daemon::conf', {})  # 避免重复声明daemon::conf
  @@concat::fragment { "${::hostname}.daemon.conf.a":
    tag => "daemon.conf.a",  # 专属标签，仅收集该类片段
    target => '/etc/daemon/config',
    order => '20',
    content => template('daemon/daemon.conf-A.erb'),
  }
}

修改daemon::conf::B（本地生成B角色配置）

class daemon::conf::B (...) {
  ensure_resource('class', '::daemon::conf', {})
  concat::fragment { "${::hostname}.daemon.conf.b":
    tag => "daemon.conf.b",  # 专属标签，不被全局收集
    target => '/etc/daemon/config',
    order => '10',
    content => template('daemon/daemon.conf-B.erb'),
  }
}

3. 优化角色类的声明方式 #

用ensure_resource替代include，避免daemon::conf被重复引入导致类重定义：

修改daemon::A类

class daemon::A ( $A_addr, $port, ) {
  ensure_resource('class', '::daemon::conf', {})
  daemon::conf::A { $::hostname:
    addr => $A_addr,
    port => $port,
  }
}

修改daemon::B类

class daemon::B ( $B_rack_loc, ) {
  ensure_resource('class', '::daemon::conf', {})
  class {'::daemon::conf::B':
    B_config => { B_rack_location => $B_rack_loc, }
  }
}

修复后的效果 #

• 每个节点的/etc/daemon/config会按顺序拼接：全局配置段（01）→ 自身节点的B角色配置段（10）→ 所有节点的A角色配置段（20）
• 彻底解决B配置重复的问题，因为B片段是本地资源，不会被其他节点收集
• 用ensure_resource避免了多角色节点上的类重定义错误

内容的提问来源于stack exchange，提问作者Theofilos Mouratidis