Puppet传递参数给apache::mod::alias类时遇重复声明错误

你碰到的这个Evaluation Error: Duplicate declaration: Apache::Mod[alias] is already declared错误，核心原因是Puppet的资源唯一性规则——同一个资源不能被多次声明。具体到这个场景，大概率是下面两种情况之一：

1. apache主类已经自动包含了alias模块
   puppetlabs-apache的apache主类默认会启用一批基础模块，alias就是其中之一。所以当你声明了class { 'apache': ... }之后，Puppet已经自动帮你加载了apache::mod::alias，这时候如果你再手动声明一次class { 'apache::mod::alias': ... }或者include apache::mod::alias，就会触发重复声明错误。

2. 代码中多次重复声明了apache::mod::alias
   比如在不同的manifest文件里，或者同一个文件里多次写了include apache::mod::alias，也会导致这个问题。

解决方案 #

根据你的需求，分两种情况处理：

情况1：不需要自定义alias模块参数

直接移除代码中所有手动声明apache::mod::alias的语句，只保留apache主类的声明即可。你的代码可以改成这样：

class { 'apache':
  server_signature => 'off',
  trace_enable     => 'off',
  mpm_module       => 'prefork'
}
include apache::mod::headers
include apache::mod::rewrite
# 移除所有关于apache::mod::alias的声明

情况2：需要自定义alias模块的参数

不要重复声明类，而是通过类参数覆盖的方式来配置。你有两种选择：

• 直接在apache主类声明中传递alias相关参数：

  class { 'apache':
    server_signature => 'off',
    trace_enable     => 'off',
    mpm_module       => 'prefork',
    # 示例：配置alias映射
    alias_maps       => { '/docs' => '/var/www/html/docs' }
  }
  include apache::mod::headers
  include apache::mod::rewrite
  

• 或者用Hiera来管理参数（更适合大规模环境），在对应的Hiera YAML文件中添加：

  apache::mod_alias::alias_maps:
    '/docs': '/var/www/html/docs'
  

排查小技巧 #

• 先全局搜索你的Puppet代码库，看看有没有多处出现apache::mod::alias的声明，包括class { ... }和include两种形式。
• 可以查看puppetlabs-apache模块的默认配置，确认哪些模块是主类自动加载的，避免重复操作。

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