使用 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

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

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

流程

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

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

   <%= snippet 'puppet_setup' %>

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

4. 使用全局参数、主机组或单个主机中的 host 参数启用 Puppet 代理。添加名为 enable-puppet7 的主机参数，选择 boolean 类型，然后将值设为 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. 确保您的主机可以使用适当的激活密钥从卫星服务器访问 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，为 Puppet 代理签署 SSL 证书。

流程

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

2. 安装 Puppet 代理软件包。

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

     # dnf install puppet-agent

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

     # yum install puppet-agent

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

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

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

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

5. 启动 Puppet 代理服务：

   # puppet resource service puppet ensure=running enable=true

6. 为主机创建证书：

   # puppet ssl bootstrap

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

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

    # puppet ssl bootstrap

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

2. 在 Satellite 服务器上禁用 Puppet 服务器：

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

流程

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

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

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

   使用 -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]

流程

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

   # puppet config print modulepath

   这会返回如下输出：

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

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

   # puppet module upgrade module name

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

流程

1. 在 Satellite Web UI 中，进入到 Configure > Puppet ENC > Classes。
2. 选择 ntp Puppet 类以更改其配置。
3. 选择 Smart Class Parameter 选项卡并搜索 服务器。
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"]

   描述阵列的替代方法是 yaml 语法：

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

7. 单击 Submit 以更改 Puppet 模块 ntp 的默认配置。

流程

1. 在 Satellite Web UI 中，进入到 Configure > Puppet ENC > Classes。
2. 点类名称来选择类。
3. 在 Smart Class Parameter 选项卡上，选择一个参数。
4. 使用 Order 列表定义 Puppet 参数的层次结构。单个主机(fqdn)将大多数和组织上下文（组织 ）标记为最不相关的内容。
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. 在 Smart Class Parameter 选项卡上，选择一个参数。
4. 使用 Order 列表定义 Puppet 参数的层次结构。单个主机(fqdn)标记与最相关的位置上下文（位置）。
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 选项卡中，编辑 不同步间隔。设置持续时间（以分钟为单位），之后主机被视为不同步。

   您还可以通过添加 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。