A.5. 模板 Macros

使用 输入 宏，您可以自定义模板可以使用的输入数据。您可以定义输入名称、类型和可供用户使用的选项。对于报告模板，您只能使用用户输入。当您定义新输入并保存模板时，您可以在模板正文的 ERB 语法中引用输入。

<%= input('cpus') %>

这会从用户输入 cpus 加载值。

使用 load_hosts 宏，您可以生成主机的完整列表。

<%- load_hosts().each_record do |host| -%>
<%=     host.name %>

使用带有 each_record 宏的 load_hosts 宏来批量加载 1000 个记录，以减少内存消耗。

如果要过滤报告的主机列表，您可以添加选项 search: input ('Example_Host') ：

<% load_hosts(search: input('Example_Host')).each_record do |host| -%>
<%=  host.name %>
<% end -%>

在本例中，您首先创建一个输入，然后用来重新定义 load_hosts 宏检索的搜索条件。

使用 report_row 宏，您可以创建一个格式化的报告来简化分析。report_row 宏需要 report_render 宏来生成输出。

<%- load_hosts(search: input('Example_Host')).each_record do |host| -%>
<%-   report_row(
        'Server FQDN': host.name
      ) -%>
<%- end -%>
<%= report_render -%>

Server FQDN
host1.example.com
host2.example.com
host3.example.com
host4.example.com
host5.example.com
host6.example.com

您可以通过添加另一个标头来向报告添加额外的列。以下示例在报告中添加 IP 地址：

<%- load_hosts(search: input('host')).each_record do |host| -%>
<%-   report_row(
      'Server FQDN': host.name,
           'IP': host.ip
      ) -%>
<%- end -%>
<%= report_render -%>

Server FQDN,IP
host1.example.com,10.8.30.228
host2.example.com,10.8.30.227
host3.example.com,10.8.30.226
host4.example.com,10.8.30.225
host5.example.com,10.8.30.224
host6.example.com,10.8.30.223

此宏仅适用于报告模板。

使用 report_render 宏，您可以为报告创建输出。在模板渲染过程中，您可以选择报告的格式。支持 YAML、JSON、HTML 和 CSV 格式。

<%= report_render -%>

此宏仅适用于作业模板。

使用这个宏，您可以呈现特定模板。您还可以启用和定义要传递给模板的参数。