使用 Puppet 集成管理配置

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

流程

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

   # satellite-installer \
   --enable-foreman-cli-puppet \
   --enable-foreman-plugin-puppet \
   --enable-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --puppet-server true

   Copy to Clipboard Toggle word wrap

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

   # satellite-installer \
   --enable-puppet \
   --foreman-proxy-puppet true \
   --foreman-proxy-puppetca true \
   --puppet-server true

   Copy to Clipboard Toggle word wrap

流程

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

3. 确保 puppet_setup 片断包含如下：

   <%= snippet 'puppet_setup' %>

   Copy to Clipboard Toggle word wrap

   请注意，此片段已包含在 Satellite 附带的模板中，如 Kickstart default 或 Preseed default。

4. 使用全局参数、主机组或单个主机中的 host 参数启用 Puppet 代理。要使用 Puppet 8，请添加名为 enable-puppet8 的主机参数，选择 布尔值 类型，然后将值设为 true。要使用 Puppet 7，请添加名为 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 的主机参数，选择 boolean 类型，然后将值设为 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 to，为 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 to，为 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. 如果您在任何 Capsules 上使用了 Puppet 服务器，请在所有 Capsules 上禁用 Puppet 服务器：

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

   Copy to Clipboard Toggle word wrap

2. 在 Satellite 服务器上禁用 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 > Puppet ENC > Classes。
2. 选择 ntp Puppet 类来更改其配置。
3. 选择 智能类参数 选项卡并搜索 服务器。
4. 确保已选中 Override 复选框。
5. 将 参数类型 下拉菜单设置为 数组。

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 > Puppet ENC > Classes。
2. 单击类名称以选择一个类。
3. 在 智能类参数 选项卡上，选择一个参数。
4. 使用 Order 列表定义 Puppet 参数的层次结构。单个主机(fqdn)将大部分和组织上下文(organization)标记为最不相关的。
5. 如果要在找到第一个匹配项后添加所有进一步匹配的参数，请选择 Merge Overrides。
6. 如果要同时包含默认值，请检查 Merge Default，即使定义了更具体的值。
7. 如果要为所选参数创建唯一值列表，请选择 Avoid Duplicates。
8. matcher 字段需要来自 订购列表中的属性类型。
9. 可选：点 Add Matcher 来添加更多匹配器。
10. 点 Submit 以保存更改。

流程

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

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts。
2. 单击主机名以选择主机。
3. 点 Edit。
4. 在 Host 选项卡中，选择 Puppet Environment。
5. 选择 Puppet ENC 选项卡。
6. 单击 Override 以编辑 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。
3. 在 Parameters 选项卡上，单击 Add Parameter。
4. 在 Name 字段中输入 outofsync_interval。
5. 从 类型下拉菜单中，选择 整数。
6. 在 Value 字段中，以分钟为单位输入新间隔。
7. 点 Submit。