如何通过Puppet在Apache HTTPd的虚拟主机外部添加自定义配置

我之前在使用这个模块时也碰到过一模一样的需求，说实话官方文档里有些细节确实藏得比较深，给你几个实用的解决方案：

方案1：使用apache::custom_config资源（官方推荐） #

这是模块专门为添加全局自定义配置设计的方式，它会在Apache的配置包含目录（比如/etc/httpd/conf.d/或/etc/apache2/conf-available/，会根据操作系统自动适配）生成独立的.conf文件，这些文件会被主配置自动加载，完全属于全局服务器上下文。

比如要添加自定义的KeepAlive规则和全局日志配置，示例代码如下：

apache::custom_config { 'global-custom-settings':
  content => '# 全局自定义配置
KeepAlive On
MaxKeepAliveRequests 150
CustomLog /var/log/apache2/global_access.log "%h %l %u %t \"%r\" %>s %b"',
}

这种方法的优势在于不会修改模块管理的主配置文件，避免配置冲突，而且独立的配置文件也更便于维护和排查问题。

方案2：通过file_line修改主配置文件（谨慎使用） #

如果你的自定义配置必须直接插入到主配置文件（比如httpd.conf或apache2.conf）中，可以用Puppet内置的file_line资源，但要注意：官方模块会管控主配置文件的核心内容，频繁修改可能导致配置覆盖或冲突，所以只建议在特殊场景下使用。

示例代码：

file_line { 'add-global-timeout-directive':
  path   => $apache::params::conf_file, # 自动适配不同系统的主配置路径
  line   => 'Timeout 120',
  after  => '^KeepAliveTimeout', # 指定插入到目标行之后，确保配置位置合理
  notify => Class['apache::service'], # 修改后触发Apache服务重启
}

方案3：覆盖apache类的内置参数（针对已有封装的配置） #

如果你的需求是修改Apache原生的全局参数（比如超时时间、KeepAlive状态、日志级别等），可以直接通过apache类的参数来设置，完全不需要自定义配置。比如：

class { 'apache':
  keepalive               => 'On',
  max_keepalive_requests  => 100,
  timeout                 => 120,
}

这种方式最符合模块的设计思路，优先用它处理模块已经封装好的参数。

总结一下，优先选择方案1来添加自定义全局配置，既安全又符合模块规范；如果是模块已经支持的参数，用方案3；只有特殊场景才考虑方案2。

内容的提问来源于stack exchange，提问作者Erik Melkersson