在 Red Hat Satellite 中使用 Puppet 集成管理配置

1. 启用 Puppet 集成。
2. 将 Puppet 代理软件包导入卫星。Puppet 代理软件包可以像使用 Satellite 的任何其他内容一样进行管理，方法是 启用红帽存储库 并使用 激活密钥 和 内容视图。
3. 在调配、注册、手动或通过 远程作业执行的主机上安装 Puppet 代理。

流程

1. 在服务器上启用 Puppet 集成并安装 Puppet 服务器：

   # satellite-installer --enable-foreman-plugin-puppet \
   --enable-foreman-cli-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --foreman-proxy-content-puppet true \
   --enable-puppet \
   --puppet-server true \
   --puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
   --puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
   --puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key

   Copy to Clipboard Toggle word wrap

2. 如果要在胶囊上使用 Puppet 集成，启用 Puppet 集成并在胶囊上安装 Puppet 服务器：

   # satellite-installer --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --foreman-proxy-content-puppet true \
   --enable-puppet \
   --puppet-server true \
   --puppet-server-foreman-ssl-ca /etc/pki/katello/puppet/puppet_client_ca.crt \
   --puppet-server-foreman-ssl-cert /etc/pki/katello/puppet/puppet_client.crt \
   --puppet-server-foreman-ssl-key /etc/pki/katello/puppet/puppet_client.key \
   --puppet-server-foreman-url "https://satellite.example.com"

   Copy to Clipboard Toggle word wrap

   输入您的 Satellite 服务器的 URL，作为 --puppet-server-foreman-url 参数的值。

流程

1. 导航到 Hosts > Provisioning Templates。
2. 根据您的主机置备方法选择置备模板。如需更多信息，请参阅置备主机 中的 Provisioning Templates 的 Kinds。

3. 确保包含 puppet_setup 代码片段，如下所示：

   <%= snippet 'puppet_setup' %>

   Copy to Clipboard Toggle word wrap

   请注意，这个片段已包含在 Satellite 附带的模板中，如 Kickstart 默认 或 Preseed 默认。

4. 使用全局参数、主机组或单个主机的 host 参数启用 Puppet 代理。添加名为 enable-puppet7 的主机参数，选择 布尔值 类型，然后将值设为 true。

5. 设置 Puppet 代理的配置。

   • 如果您使用集成的 Puppet 服务器，请确保在创建主机时选择 Puppet Capsule、Puppet CA Capsule 和 Puppet 环境。

   • 如果您使用非集成 Puppet 服务器，在全局参数或主机组中设置以下主机参数，或者在创建主机时：

     • 添加名为 puppet_server 的主机参数，选择字符串类型，并将值设为 Puppet 服务器的主机名，如 puppet.example.com。
     • 可选：添加名为 puppet_ca_server 的主机参数，选择字符串类型，并将值设为 Puppet CA 服务器的主机名，如 puppet-ca.example.com。如果没有设置 puppet_ca_server，则 Puppet 代理将使用与 puppet_server 相同的服务器。
     • 可选：添加名为 puppet_environment 的主机参数，选择字符串类型，并将值设置为您希望主机使用的 Puppet 环境。
6. 使用适当的激活码，确保您的主机可从 Satellite 服务器访问 Puppet 代理软件包。

流程

1. 在 Satellite Web UI 中，进入到 Configure > Global Parameters 以全局添加主机参数。或者，您可以导航到 Configure > Host Groups 并编辑或创建主机组，来仅将主机参数添加到主机组中。
2. 使用全局参数或主机组中的 host 参数启用 Puppet 代理。添加名为 enable-puppet7 的主机参数，选择 布尔值 类型，然后将值设为 true。

3. 在全局参数或主机组中使用以下主机参数为 Puppet 代理指定配置：

   • 添加名为 puppet_server 的主机参数，选择字符串类型，并将值设为 Puppet 服务器的主机名，如 puppet.example.com。
   • 可选：添加名为 puppet_ca_server 的主机参数，选择字符串类型，并将值设为 Puppet CA 服务器的主机名，如 puppet-ca.example.com。如果没有设置 puppet_ca_server，则 Puppet 代理将使用与 puppet_server 相同的服务器。
   • 可选：添加名为 puppet_environment 的主机参数，选择字符串类型，并将值设置为您希望主机使用的 Puppet 环境。

   在 BZ2177730 解析之前，您必须使用 host 参数来指定 Puppet 代理配置，即使 Puppet 服务器是 Capsule 服务器。

4. 导航到 Hosts > Register Host，并使用适当的激活码注册您的主机。如需更多信息， 请参阅管理主机中的 注册主机。
5. 导航到 Infrastructure > Capsules。
6. 从所需胶囊服务器的 Actions 列中，选择 Certificates。
7. 单击所需主机右侧的 Sign，为 Puppet 代理签署 SSL 证书。

流程

1. 以 root 用户身份登录主机。

2. 安装 Puppet 代理软件包。

   • 在运行 Red Hat Enterprise Linux 8 及更高版本的主机上：

     # dnf install puppet-agent

     Copy to Clipboard Toggle word wrap

   • 在运行 Red Hat Enterprise Linux 7 并以下的主机上：

     # yum install puppet-agent

     Copy to Clipboard Toggle word wrap

3. 使用以下脚本，将 Puppet 代理添加到当前 shell 中的 PATH 中：

   . /etc/profile.d/puppet-agent.sh

   Copy to Clipboard Toggle word wrap

4. 配置 Puppet 代理。将 environment 参数设置为主机所属的 Puppet 环境的名称：

   # puppet config set server satellite.example.com --section agent
   # puppet config set environment My_Puppet_Environment --section agent

   Copy to Clipboard Toggle word wrap

5. 启动 Puppet 代理服务：

   # puppet resource service puppet ensure=running enable=true

   Copy to Clipboard Toggle word wrap

6. 为主机创建证书：

   # puppet ssl bootstrap

   Copy to Clipboard Toggle word wrap
7. 在 Satellite Web UI 中，导航到 Infrastructure > Capsules。
8. 从所需胶囊服务器的 Actions 列中，选择 Certificates。
9. 单击所需主机右侧的 Sign，为 Puppet 代理签署 SSL 证书。

10. 在主机上再次运行 Puppet 代理：

    # puppet ssl bootstrap

    Copy to Clipboard Toggle word wrap

1. 在 Puppet 服务器上管理 Puppet 模块，后者是安装和更新它们。
2. 将 Puppet 类和环境从 Puppet 模块导入到卫星。
3. 可选：从 Puppet 类创建配置组。
4. 在各种级别上配置智能类参数的覆盖。
5. 将 Puppet 类或配置组分配到主机组或单个主机。
6. 配置在主机上运行 Puppet 代理的间隔，以及 Puppet 服务器的配置实施运行。
7. 使用 Satellite Web UI 中的报告来监控配置管理。如需更多信息，请参阅管理 Red Hat Satellite 中的 监控资源。
8. 配置电子邮件通知.如需更多信息，请参阅管理 Red Hat Satellite 中的 配置电子邮件通知首选项。

流程

1. 如果您在任何 Capsule 上使用了 Puppet 服务器，请在所有 Capsule 上禁用 Puppet 服务器：

   # satellite-maintain plugin purge-puppet --remove-all-data

   Copy to Clipboard Toggle word wrap

2. 在管理门户中禁用 Puppet 服务器：

   # satellite-maintain plugin purge-puppet --remove-all-data

   Copy to Clipboard Toggle word wrap

流程

1. 导航到 forge.puppet.com，再搜索 ntp。第一个模块是 puppetlabs/ntp。

2. 使用 SSH 连接到您的 Satellite 服务器并安装 Puppet 模块：

   # puppet module install puppetlabs-ntp -i /etc/puppetlabs/code/environments/production/modules

   Copy to Clipboard Toggle word wrap

   使用 -i 参数指定路径和 Puppet 环境，如 production。

   安装完成后，输出类似如下：

   Notice: Preparing to install into /etc/puppetlabs/code/environments/production/modules ...
   Notice: Created target directory /etc/puppetlabs/code/environments/production/modules
   Notice: Downloading from https://forgeapi.puppet.com ...
   Notice: Installing -- do not interrupt ...
   /etc/puppetlabs/code/environments/production/modules
   |-| puppetlabs-ntp (v8.3.0)
     |-- puppetlabs-stdlib (v4.25.1) [/etc/puppetlabs/code/environments/production/modules]

   Copy to Clipboard Toggle word wrap

流程

1. 使用 SSH 连接到您的 Puppet 服务器，并找出 Puppet 模块所在的位置：

   # puppet config print modulepath

   Copy to Clipboard Toggle word wrap

   这会返回如下输出：

   /etc/puppetlabs/code/environments/production/modules:/etc/puppetlabs/code/environments/common:/etc/puppetlabs/code/modules:/opt/puppetlabs/puppet/modules:/usr/share/puppet/modules

   Copy to Clipboard Toggle word wrap

2. 如果该模块位于上面显示的路径中，以下命令会更新模块：

   # puppet module upgrade module name

   Copy to Clipboard Toggle word wrap

1. 全局参数
2. 机构参数
3. 位置参数
4. 主机组参数
5. 主机参数

流程

1. 在 Satellite Web UI 中，导航到 Configure > Classes。
2. 选择 ntp Puppet 类以更改其配置。
3. 选择 智能类参数 选项卡并搜索 服务器。
4. 确保选中了 Override 复选框。
5. 将 Parameter Type 下拉菜单设置为 数组。

6. 将 ntp 服务器列表插入 为默认值 ：

   ["0.de.pool.ntp.org","1.de.pool.ntp.org","2.de.pool.ntp.org","3.de.pool.ntp.org"]

   Copy to Clipboard Toggle word wrap

   描述数组的另一种方法是 yaml 语法：

   - 0.de.pool.ntp.org
   - 1.de.pool.ntp.org
   - 2.de.pool.ntp.org
   - 3.de.pool.ntp.org

   Copy to Clipboard Toggle word wrap
7. 添加值后，单击 Submit 按钮。这将更改 Puppet 模块 ntp 的默认配置。

流程

1. 在 Satellite Web UI 中，导航到 Configure > Classes。
2. 点类名称来选择类。
3. 在 Smart Class Parameter 选项卡中，选择一个参数。
4. 使用 Order 列表定义 Puppet 参数的层次结构。单个主机(fqdn)标记最大的组织上下文(组织)最小相关。
5. 如果要在找到第一个匹配项后添加所有进一步匹配的参数，请检查 Merge Overrides。
6. 如果您还想包含默认值，请检查 Merge Default，即使定义了更具体的值。
7. 如果要为所选参数创建唯一值列表，请检查 Avoid Duplicates。
8. matcher 字段需要 顺序列表中的属性类型。
9. 使用 添加匹配 按钮添加更多匹配器。
10. 单击 Submit 以保存更改。

流程

1. 在 Satellite Web UI 中，导航到 Configure > Classes。
2. 点类名称来选择类。
3. 在 Smart Class Parameter 选项卡中，选择一个参数。
4. 使用 Order 列表定义 Puppet 参数的层次结构。单个主机(fqdn)标记最大的位置上下文(位置)最小相关。
5. 如果要在找到第一个匹配项后添加所有进一步匹配的参数，请检查 Merge Overrides。
6. 如果您还想包含默认值，请检查 Merge Default，即使定义了更具体的值。
7. 如果要为所选参数创建唯一值列表，请检查 Avoid Duplicates。
8. matcher 字段需要 顺序列表中的属性类型。例如，您可以选择 Paris 作为 位置上下文，并将值设为法语 ntp 服务器。
9. 使用 添加匹配 按钮添加更多匹配器。
10. 单击 Submit 以保存更改。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 单击主机名以选择主机。
3. 点 Edit。
4. 在 Host 选项卡上，选择 Puppet Environment。
5. 选择 Puppet ENC 选项卡。
6. 单击 覆盖 按钮，以编辑 Puppet 参数。
7. 单击 Submit 以保存更改。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Remote Execution Features。
2. 选择 puppet_run_host 远程执行功能。
3. 分配 Run Puppet Once - SSH Default 作业模板。

流程

1. 使用 SSH 连接到您的受管主机。
2. 将 Puppet 代理运行间隔添加到 /etc/puppetlabs/puppet/puppet.conf，如 runinterval = 1h。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。

2. 在 General 选项卡中，编辑 Out of sync interval。设置一个持续时间（以分钟为单位），之后主机被视为不同步。

   您还可以通过添加 outofsync_interval 参数，在主机组或 单个主机上覆盖此间隔。???

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings，然后点击 Config Management 选项卡。
2. 在 Puppet interval 字段中，将值设为持续时间（以分钟为单位），之后使用 Puppet 的主机报告被视为不同步。

流程

1. 在 Satellite Web UI 中，导航到 Configure > Host Groups。
2. 选择主机组。
3. 在 Parameters 选项卡上，单击 Add Parameter。
4. 在 Name 字段中输入 outofsync_interval。
5. 从 类型下拉菜单中，选择 整数。
6. 在 Value 字段中输入新间隔（以分钟为单位）。
7. 单击 Submit 按钮。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点 Edit for a selected host。
3. 在 Parameters 选项卡上，单击 Add Parameter。
4. 在 Name 字段中输入 outofsync_interval。
5. 从 类型下拉菜单中，选择 整数。
6. 在 Value 字段中输入新间隔（以分钟为单位）。
7. 单击 Submit 按钮。