如何在Puppet类中传递哈希数组并正确遍历访问数据？

背景 #

此前已成功在Puppet中使用Hiera的数组与哈希：

mymods::keyvaultcerts::array::certNames: ['cert1','cert2','cert3']
mymods::chocopackages::hash::packages:
   dotnetfx   : 4.8
   urlrewrite : 2.1
   azure-cli  : 2.31
   vcredist   : 12.0

现在尝试传递哈希数组到Puppet类，用于生成模板化脚本，Hiera配置如下：

profile::octopus::worker::workerConfigurations:[
{
   Port: 10933,
   Pool: "General Worker Pool",
   User: "Dummy1",
   DisplaySuffix: "",
},
{
   Port: 10934,
   Pool: "General Dev Pool",
   User: "Dummy2",
   DisplaySuffix: "Dev",
},
{
   Port: 10935,
   Pool: "General QA Pool",
   User: "Dummy3",
   DisplaySuffix: "_QA",
}
]

编写的Puppet类遍历代码：

class profile::octopus::worker(
    Array $workerConfigurations
){
     $workerConfigurations.each | Integer $workerIndex, Hash $workerConfigurationData | {
         $workerConfigurationData.each | $workerPort, $workerPool, $workerUser, $workerDisplaySuffix | {
             notify{"\$workerPort ${$workerPort}" :}
         }
     }
}

预期输出端口的通知，但客户端报错：

Error while evaluating a Method Call, 'each' block expects between 1 and 2 arguments, got 4

请问该需求是否可行？若不可行，有何推荐方案实现向类中传递一个或多个对象？

解答 #

这个需求完全可行，报错是因为对Hash的each方法使用错误。

错误原因 #

Hash类型的each方法每次迭代仅支持1个或2个参数：

• 传1个参数时，接收的是包含键值对的数组（如['Port', 10933]）
• 传2个参数时，分别接收哈希的键（key）和对应的值（value）

你在遍历$workerConfigurationData时传入了4个参数，不符合方法的参数规范，因此触发报错。

正确的遍历实现 #

无需遍历哈希的所有键值对，直接通过键名访问哈希中的对应值即可，修改后的类代码如下：

class profile::octopus::worker(
    Array[Hash] $workerConfigurations  # 添加精确类型约束，提前校验数据格式
){
     $workerConfigurations.each | Integer $workerIndex, Hash $workerData | {
         # 直接通过键名获取端口值并输出通知
         notify{"Worker ${workerIndex} Port: ${workerData['Port']}":}
         # 若需使用其他字段，同样通过键名访问
         # notify{"Worker ${workerIndex} Pool: ${workerData['Pool']}":}
     }
}

推荐实现方案 #

1. 强化类型约束：在参数定义时使用Array[Hash]，甚至可以进一步约束哈希的键值类型，比如Array[Hash[String, Variant[String, Integer]]]，能提前发现Hiera中的数据格式错误，避免运行时异常。
2. 统一结构化数据规范：保持Hiera中哈希的键名格式统一（比如全部小写或统一驼峰），提升代码的可读性和维护性。
3. 模板化生成脚本/配置：如果目标是生成模板化脚本，可在循环中调用file资源，结合EPP模板批量生成配置文件。示例代码：

class profile::octopus::worker(
    Array[Hash] $workerConfigurations
){
     $workerConfigurations.each | Integer $workerIndex, Hash $workerData | {
         file { "/etc/octopus-worker-${workerIndex}.conf":
             ensure  => present,
             content => epp('profile/octopus/worker.conf.epp', {
                 port           => $workerData['Port'],
                 pool           => $workerData['Pool'],
                 user           => $workerData['User'],
                 display_suffix => $workerData['DisplaySuffix'],
             }),
         }
     }
}

对应的EPP模板（profile/octopus/worker.conf.epp）：

Port=<%= $port %>
Pool=<%= $pool %>
User=<%= $user %>
DisplaySuffix=<%= $display_suffix %>

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