流程

1. 在 Satellite Web UI 中，点 Hosts > Create Host。
2. 在 Host 选项卡中，输入所需详情。
3. 点 Ansible Roles 选项卡，从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理添加或删除的角色。
4. 在 Puppet Classes 选项卡中，选择您要包含的 Puppet 类。

5. 在 接口 标签页中：

   1. 对于每个接口，点 Actions 列中的 Edit，并根据需要配置以下设置：

      • 输入 InventoryService-jaxbFor a Bond 或 BMC 接口，使用 Type 列表并选择接口类型。
      • MAC 地址 时间为 the MAC 地址。
      • DNS 名称 the DNS name the DNS name is known to the DNS server.这用于 FQDN 的主机部分。
      • Domain — 选择置备网络的域名。这会使用特定的适当的子网自动更新 Subnet 列表。
      • IPv4 Subnet abrt-openmpi 从列表中为主机选择 IPv4 子网。
      • IPv6 Subnet abrt-abrt 从列表中为主机选择 IPv6 子网。
      • IPv4 address — 如果 IP address management (IPAM) 已为子网启用，IP 地址会被自动推荐。或者，您可以输入一个地址。如果启用了置备令牌，如果子网没有管理反向 DNS，或者子网没有管理 DHCP 保留，则地址可以被省略。
      • IPv6 address — 如果 IP address management (IPAM) 已为子网启用，IP 地址会被自动推荐。或者，您可以输入一个地址。
      • 受管 时间是选择此复选框，以在置备期间配置接口以使用提供的 DHCP 和 DNS 服务。
      • 主 InventoryService-latexSelect this 复选框，以使用此界面中的 DNS 名称作为 FQDN 的主机部分。
      • provision abrt-abrtSelect this 复选框，以将此接口用于置备。这意味着，TFTP 引导将使用此接口进行，或者在基于映像的调配时进行，整个置备将通过此界面执行。请注意，很多置备任务（如通过 anaconda 下载 RPM（在 %post 脚本中的 Puppet 设置）将使用主接口。

      • 如果这个接口不是物理设备，则 虚拟 NIC 会显示这个复选框。此设置有两个选项：

        • 标签 InventoryService-latexly 设置 VLAN 标签。如果未设置，则标签将是子网的 VLAN ID。
        • 将这个虚拟接口 附加到 的接口的设备名称已附加。
   2. 点 OK 保存接口配置。
   3. （可选）点击 Add Interface 来包括额外的网络接口。更多信息请参阅 第 5 章 添加网络接口。
   4. 点 Submit 以应用更改并退出。
6. 在 Operating System 选项卡中，输入所需详情。对于 Red Hat 操作系统，选择 Synced Content for Media Selection。如果要使用非红帽操作系统，请选择 All Media，然后从 Media Selection 列表中选择安装介质。您可以从列表中选择一个分区表，或者在 Custom partition table 字段中输入自定义分区表。您无法同时指定两者。

7. 在 Parameters 选项卡中，点 Add Parameter 添加您要在运行时传递给作业模板的任何参数变量。这包括您要与主机关联的所有 Puppet 类、Ansible playbook 参数和主机参数。要将参数变量与 Ansible 作业模板一起使用，您必须添加 Host Parameter。

   当您创建 Red Hat Enterprise Linux 8 主机时，您可以设置系统目的属性。System purpose 属性定义要在主机创建时自动附加哪些订阅。在 Host Parameters 区域，输入以下参数名以及对应的值。如需值列表，请参阅执行标准 RHEL 8 安装中的系统目的介绍。

   • syspurpose_role
   • syspurpose_sla
   • syspurpose_usage
   • syspurpose_addons

   如果要为远程作业执行创建带有 pull 模式的主机，请添加 enable-remote-execution-pull 参数，并将 type 布尔值 设为 true。更多信息请参阅 第 12.4 节 “远程执行的传输模式”。

8. 在 Additional Information 选项卡中，输入有关主机的附加信息。
9. 单击 Submit 以完成您的调配请求。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 在 Actions 菜单中，点 Clone。
3. 在 Host 选项卡中，确保提供与原始主机不同的名称。
4. 在 Interfaces 标签页上，确保 提供不同的 IP 地址。
5. 单击 Submit 以克隆主机。

流程

1. 在 Satellite Web UI 中，导航到 Infrastructure > Compute Resources。
2. 选择一个计算资源。
3. 在 Virtual Machines 选项卡中，从 Actions 菜单中选择 Associate VM。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 在 Overview 选项卡上，点 Edit on the System purpose 卡。
4. 为主机选择系统目的属性。
5. 点击 Save。

CLI 过程

1. 登录主机，再编辑所需的系统目的属性。例如，将使用类型设置为 Production，将角色设置为 Red Hat Enterprise Linux Server，并添加 addon 附加组件。如需值列表，请参阅执行标准 RHEL 8 安装中的系统目的介绍。

   # subscription-manager syspurpose set usage 'Production'
   # subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server'
   # subscription-manager syspurpose add addons 'your_addon'

2. 验证此主机的系统目的属性：

   # subscription-manager syspurpose

3. 自动将订阅附加到此主机：

   # subscription-manager attach --auto

4. 验证此主机的系统目的状态：

   # subscription-manager status

流程

1. 在 Satellite web UI 中，进入 Hosts > Content Hosts 并选择您要编辑的 Red Hat Enterprise Linux 8 主机。
2. 单击 Select Action 列表，再选择 Manage System Purpose。

3. 选择您要分配给所选主机的系统目的属性。您可以选择以下值之一：

   • 设置所有所选主机的特定属性。
   • 不要修改，以保留在所选主机上设置的属性。
   • none(Clear)，清除所选主机上的 属性。
4. 点 Assign。
5. 在 Satellite web UI 中，进入 Hosts > Content Hosts 并选择相同的 Red Hat Enterprise Linux 8 主机，以根据系统目的自动附加订阅。
6. 单击 Select Action 列表，再选择 Manage Subscriptions。
7. 点 Auto-Attach 以根据其系统角色自动将订阅附加到所有选择的主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 单击 内容选项卡，然后单击 模块流 选项卡。
4. 单击模块旁边的垂直省略，然后选择您要执行的操作。远程执行作业完成后，您将获得一个 REX 作业通知。

流程

1. 在 Satellite Web UI 中，进入 Configure > Host Groups，然后点击 Create Host Group。
2. 如果要从中继承属性的现有主机组，您可以从 Parent 列表中选择一个主机组。如果没有，请将此字段留空。
3. 输入新主机组的 Name。
4. 输入您希望将来主机继承的任何更多信息。
5. 点 Ansible Roles 选项卡，从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理添加或删除的角色。

6. 点附加标签页，并将您要属性的任何详情添加到主机组。

   注意

   在注册与生产环境中创建的 Puppet 环境关联的主机组时，Puppet 无法检索 Puppet CA 证书。

   要创建与主机组关联的适当 Puppet 环境，请手动创建目录：

   # mkdir /etc/puppetlabs/code/environments/example_environment

7. 单击 Submit 以保存该主机组。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 编辑按钮。
4. 从 Host Group 列表中选择主机组。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 编辑按钮。
4. 从 Host Group 列表中选择新的主机组。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 在 主机集合 卡中，点垂直的 ellipsis 并选择 Add host to collections。
4. 选择主机集合。
5. 点 Add。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 Edit 按钮旁边的垂直省略图标，然后选择 Change content source。
4. 从列表中选择 Environment、Content View 和 Content Source。
5. 点更改内容源。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点击要修改的主机的名称。
3. 点 Content view details 卡中的垂直 ellipsis，然后选择 Edit content view assignment。
4. 选择 环境。
5. 选择内容视图。
6. 点击 Save。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点击要修改的主机的名称。
3. 点 编辑按钮。
4. 单击 Manage host 或 Unmanage host 以更改主机的状态。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 Traces 选项卡，然后点 Enable Traces 按钮。
4. 从列表中选择要安装 katello-host-tools-tracer 的供应商。
5. 点 Enable Tracer 按钮。远程执行作业完成后，您将获得一个 REX 作业通知。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 选择 Traces 选项卡。
4. 选择您要重启的应用程序。
5. 从 Restart app 列表中选择 Restart via remote execution。远程执行作业完成后，您将得到 REX 作业通知。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选择您要更改的主机的复选框。
3. 在 Select Action 列表中，选择 Assign Organization。此时会打开一个新选项窗口。

4. 在 Select Organization 列表中，选择您要为其分配主机的机构。选中 Fix Organization on Mismatch 的复选框。

   注意

   如果有一个与主机关联的资源（如域或子网），且未与您要为其分配主机的组织相关联，则不匹配。选项 Fix Organization on Mismatch 会将这样的资源添加到机构中，因此建议选择。选项 Fail on Mismatch 将始终出现错误消息。例如，将主机从一个机构重新分配给另一个机构会失败，即使设置中没有实际不匹配。

5. 点 Submit。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 选择您要更改的主机的复选框。
3. 在 Select Action 列表中，选择 Assign Location。此时会打开一个新选项窗口。

4. 导航到 Select Location 列表，再选择您要用于您的主机的位置。选中 修复位置上的"修复位置 "。

   注意

   如果有一个与主机关联的资源（如域或子网），且与您要为其分配主机的位置没有关联，则不匹配。选项 Fix Location on Mismatch 会将这样的资源添加到位置，因此建议选择。选项 Fail on Mismatch 将始终出现错误消息。例如，将主机从一个位置重新分配给另一个位置将会失败，即使设置中没有实际不匹配。

5. 点 Submit。

流程

1. 在 Satellite web UI 中，导航到 Hosts > All hosts or Hosts > Content Hosts。请注意，您从 所有主机 或 内容主机 中删除主机的页面没有区别。在这两种情况下，Satellite 都彻底删除主机。
2. 选择您要删除的主机。
3. 在 Select Action 列表中，选择 Delete Hosts。
4. 单击 Submit 以从 Red Hat Satellite 永久删除主机。

1. 手动创建目录：

   # mkdir /etc/puppetlabs/code/environments/example_environment

2. 在 Satellite Web UI 中，导航到 Configure > Environments，再点击 Import environment from。按钮名称包括内部或外部胶囊的 FQDN。
3. 选择创建的目录，然后单击 更新。

流程

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

2. 下载脚本：

   # curl -O http://satellite.example.com/pub/bootstrap.py

3. 使脚本可执行：

   # chmod +x bootstrap.py

4. 通过查看 help 文本确认脚本可以执行：

   • On Red Hat Enterprise Linux 8:

     # /usr/libexec/platform-python bootstrap.py -h

   • 在其他 Red Hat Enterprise Linux 版本中：

     # ./bootstrap.py -h

5. 输入适合您环境的 bootstrap 命令。

   对于 --server 选项，指定卫星服务器的 FQDN 或胶囊服务器。对于 --location、--organization 和 --hostgroup 选项，请使用带引号名称（而非标签）作为选项的参数。有关高级用例，请参阅 第 3.4.2 节 “高级启动脚本配置”。

   • 在 Red Hat Enterprise Linux 8 中输入以下命令：

     # /usr/libexec/platform-python bootstrap.py \
     --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

   • 在 Red Hat Enterprise Linux 6 或 7 中，输入以下命令：

     # ./bootstrap.py --login=admin \
     --server satellite.example.com \
     --location="My_Location" \
     --organization="My_Organization" \
     --hostgroup="My_Host_Group" \
     --activationkey="My_Activation_Key"

6. 输入您使用 --login 选项指定的 Satellite 用户的密码。

   该脚本会向 stdout 发送进度通知。

7. 在脚本提示时，批准主机的 Puppet 证书。在 Satellite Web UI 中，导航到 Infrastructure > Capsules，并找到您使用 --server 选项指定的 Satellite 或 Capsule Server。
8. 从 Actions 列的列表中，选择 Certificates。
9. 在 Actions 列中，单击 Sign 以批准主机的 Puppet 证书。
10. 返回主机以查看 bootstrap 过程的剩余部分。
11. 在 Satellite Web UI 中，导航到 Hosts > All hosts，并确保主机连接到正确的主机组。

12. 可选：在主机注册完成后，删除脚本：

    # rm bootstrap.py

流程

1. 安装 katello-agent 软件包：

   # dnf install katello-agent

2. 启动 goferd 服务：

   # systemctl start goferd

流程

1. 在内容主机上，安装 katello-host-tools-tracer RPM 软件包：

   # yum install katello-host-tools-tracer

2. 使用以下命令：

   # katello-tracer-upload

3. 在 Satellite Web UI 中，导航到 Hosts > All hosts，然后单击所需的主机名。
4. 点 Traces 选项卡来查看 Traces。如果没有安装，启用 Traces 按钮会启动安装软件包的远程执行作业。

流程

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. 从所需胶囊服务器 的操作 列中的列表中，选择 证书。
7. 单击所需主机右侧的 Sign to，以签署 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. 从所需胶囊服务器 的操作 列中的列表中，选择 证书。
9. 单击所需主机右侧的 Sign to，以签署 Puppet 代理的 SSL 证书。

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

    # puppet ssl bootstrap

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 接口 选项卡中，点 添加接口。
4. 保留在 Type 列表中选择的 Interface 选项。
5. 指定 MAC 地址。此设置是必需的。
6. 指定 设备标识符， 如 eth0。标识符用于在创建绑定接口、VLAN 和别名时指定此物理接口。
7. 指定与主机的 IP 地址关联的 DNS 名称。Satellite 将此名称保存在与所选域（DNS A"字段）关联的胶囊服务器中，以及与所选子网（"DNS PTR"字段）关联的胶囊服务器。因此单个主机可以有多个 DNS 条目。
8. 从 Domain 列表中选择一个域。要创建并管理域，请导航到 Infrastructure > Domains。
9. 从 Subnet 列表中选择一个子网。要创建和管理子网，请导航到 Infrastructure > Subnets。
10. 指定 IP 地址。具有分配的 DHCP 胶囊服务器的受管接口需要此设置来创建 DHCP 租期。启用 DHCP 的托管接口会自动提供推荐的 IP 地址。
11. 选择接口是否被 管理。如果接口被管理，则在置备过程中从关联的胶囊服务器中拉取配置，并且创建 DNS 和 DHCP 条目。如果使用 kickstart 调配，会自动为接口创建一个配置文件。
12. 选择是否是 主机的 主接口。主接口中的 DNS 名称用作 FQDN 的主机部分。
13. 选择这是否是主机的 Provision 接口。TFTP 引导通过置备接口进行。对于基于镜像的调配，通过置备接口执行要完成调配的脚本。
14. 选择是否将接口用于远程执行。
15. 清除 虚拟 NIC 复选框。
16. 点 OK 保存接口配置。
17. 单击 Submit，将更改应用到主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 接口 选项卡中，点 添加接口。
4. 保留在 Type 列表中选择的 Interface 选项。

5. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

   指定受管虚拟接口的 MAC 地址，以便正确生成用于调配的配置文件。但是，不管理的虚拟接口不需要 MAC 地址。

   如果创建 VLAN，在 Device Identifier 字段中以 eth1.10 的形式指定 ID。如果创建别名，请以 eth1:10 的形式使用 ID。

6. 选择 Virtual NIC 复选框。特定于虚拟接口的其他配置选项会附加到表单中：

   • 标签 ：（可选）将 VLAN 标签设置为通过 向虚拟接口将物理网络中的网络段中继到虚拟接口。如果没有指定标签，受管接口会继承关联子网的 VLAN 标签。此字段中的用户指定条目不适用于别名接口。
   • 附加到 ：指定虚拟接口所属的物理接口的标识符，如 eth1。此设置是必需的。
7. 点 OK 保存接口配置。
8. 单击 Submit，将更改应用到主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
2. 点您要编辑的主机旁的 Edit。
3. 在 接口 选项卡中，点 添加接口。
4. 从 Type 列表选择 Bond。其他特定于类型的配置选项会附加到表单中。

5. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

   绑定接口在 Device Identifier 字段中使用 bond0 的形式。

   单个 MAC 地址 已经足够。

   如果要添加二级接口，请选择 Managed。否则，Satellite 不会应用配置。

6. 指定特定于绑定接口的配置选项：

   • 模式 ：选择定义容错和负载均衡的策略的绑定模式。有关每个绑定模式的详情，请参考 第 5.4 节 “Satellite 中可用的绑定模式”。
   • 附加设备 ：指定一个以逗号分隔的附加设备的标识符列表。这些可以是物理接口或 VLAN。
   • bond 选项 ：指定一个以空格分隔的配置选项列表，例如 miimon=100。有关绑定接口的配置选项的更多信息，请参阅 Red Hat Enterprise Linux 配置和管理网络 指南中的 配置网络绑定。
7. 点 OK 保存接口配置。
8. 单击 Submit，将更改应用到主机。

流程

1. 如果还没有启用，在胶囊服务器上启用 BMC：

   1. 使用以下选项运行 satellite-installer 脚本，在 Capsule 服务器上配置 BMC 电源管理：

      # satellite-installer --foreman-proxy-bmc=true \
      --foreman-proxy-bmc-default-provider=ipmitool

   2. 在 Satellite Web UI 中，导航到 Infrastructure > Capsules。
   3. 从 Actions 列中的列表，单击 Refresh。Features 列中的列表现在应包含 BMC。
2. 在 Satellite Web UI 中，导航到 Hosts > All hosts。
3. 点您要编辑的主机旁的 Edit。
4. 在 接口 选项卡中，点 添加接口。
5. 从 Type 列表中选择 BMC。特定于类型的配置选项会附加到表单中。
6. 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。

7. 指定特定于 BMC 接口的配置选项：

   • Username 和 Password ：指定 BMC 所需的任何身份验证凭证。
   • Provider: 指定 BMC 供应商。
8. 点 OK 保存接口配置。
9. 单击 Submit，将更改应用到主机。

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts，再选择您要使用 RHEL web 控制台管理和监控的主机。
2. 在主机窗口右上角，单击 Web Console。

流程

1. 运行这个 satellite-installer 命令：

   satellite-installer --no-enable-foreman-plugin-remote-execution-cockpit

2. 在 Satellite Web UI 中，进入到 Administer > Settings 并点 Remote execution 选项卡。
3. 在 Cockpit URL 行中，清除 Value 下的设置，然后点 Submit。这会从 Satellite Web UI 中删除 Web 控制台按钮。

4. 从 Satellite 卸载 RHEL web 控制台软件包：

   dnf remove rubygem-foreman_remote_execution-cockpit

1. 将 RedHatInsights.insights-client 角色添加到主机。

   对于新主机，请参阅 第 2.1 节 “在 Red Hat Satellite 中创建主机”。

   对于已存在的主机，请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的使用 Ansible 角色自动化客户端中重复的任务。

2. 要在主机上运行 RedHatInsights.insights-client 角色，请导航到 Hosts > All Hosts，再单击要使用的主机的名称。
3. 单击 Run Ansible roles 按钮。

1. 在 Satellite web UI 中，进入 Configure > Insights。
2. 单击 Start Recommendations Sync 按钮。

流程

1. 在 Satellite web UI 中，进入 Configure > Insights。

2. 在 Red Hat Insights 页面中，选择您要包含在 Insights 计划中的建议数量。

   您只能选择具有关联 playbook 的建议。

3. 点 Remediate。
4. 在 Remediation Summary 窗口中，您可以选择要应用的解决方案。使用 Filter 字段搜索特定关键字。
5. 点 Remediate。
6. 在 Job Invocation 页面中，不要更改 precompleted 字段的内容。
7. 可选。有关 Remote Execution Job 的更多高级配置，请单击 Show Advanced Fields。
8. 选择您需要 的查询的类型。
9. 选择您需要的 Schedule。
10. 点 Submit。

1. 在 Satellite Web UI 中，导航到 Hosts &gt ; All Hosts。
2. 选择主机。
3. 在 Host 详情页面上，点 Recommendations。
4. 在 Red Hat Insights 页面中，选择您要包括在 Insights 计划中的推荐数量，然后继续操作。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 在要使用的报告模板右侧点击 Generate。
3. 可选： 要将报告调度到 Generate at 字段的右侧，请点击图标来选择您要在其中生成报告的日期和时间。
4. 可选：要将报告发送到电子邮件地址，请选中 通过电子邮件发送报告 复选框，并在 Deliver to email-mail address 字段中输入所需的电子邮件地址。
5. 可选：应用搜索查询过滤器。要查看所有可用结果，请不要使用任何值填充过滤器字段。
6. 点 Submit。包含报告的 CSV 文件会被下载。如果您选择了 通过电子邮件发送报告 复选框，则主机监控报告将发送到您的电子邮件地址。

CLI 过程

1. 列出所有可用的报告模板：

   # hammer report-template list

2. 生成一个报告：

   # hammer report-template generate --id My_Template_ID

   此命令会等待报告在完成前完全生成。如果您想将报告生成为后台任务，您可以使用 hammer report-template schedule 命令。

   注意

   如果要生成订阅权利报告，您必须使用 现在选项中的 Days 指定授权订阅的最新过期时间。您可以使用 no limit 值显示所有权利。

   显示所有权利

   # hammer report-template generate \
   --inputs "Days from Now=no limit" \
   --name "Subscription - Entitlement Report"

   显示所有将在 60 天后过期的权利

   # hammer report-template generate \
   --inputs "Days from Now=60" \
   --name "Subscription - Entitlement Report"

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates，然后点 Create Template。
2. 在 Name 字段中输入报告模板的唯一名称。
3. 如果您希望模板可用于所有位置和组织，请选择 Default。
4. 直接在模板编辑器中创建模板，或通过单击 Import 来从文本文件导入模板。有关导入模板的更多信息，请参阅 第 10.5 节 “导入报告模板”。
5. 可选： 在 Audit Comment 字段中，您可以添加有关此模板的任何有用信息。
6. 单击 输入 选项卡，在 Name 字段中输入一个可以以下格式在模板中引用的输入名称： 输入('name')。请注意，您必须保存模板，然后才能在模板正文中引用此输入值。
7. 选择是否需要输入值。如果输入值是必需的，请选择 所需 复选框。
8. 在 Value Type 列表中，选择用户必须输入的输入值类型。
9. 可选：如果要将事实用于模板输入，请选择 Advanced 复选框。
10. 可选：在 Options 字段中，定义用户可从中选择的选项。如果此字段没有定义，用户会收到可以在其中输入所需值的自由文本字段。
11. 可选：在 Default 字段中输入值，如主机名，您想要设置为默认模板输入。
12. 可选：在 Description 字段中输入您要在生成报告时作为内联帮助显示的信息。
13. 可选：点击 Type 选项卡，然后选择此模板是否包含在其他模板中。
14. 单击 Location 选项卡，再添加您要使用模板的位置。
15. 单击 Organizations 选项卡，再添加您要使用模板的组织。
16. 点 Submit 保存您的更改。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 找到您要导出的模板，并从 Actions 列中的列表中选择 Export。
3. 对您要下载的每个报告模板重复此操作。

CLI 过程

1. 要查看可用于导出的报告模板，请输入以下命令：

   # hammer report-template list

   请注意在此命令输出中要导出的模板模板 ID。

2. 要导出报告模板，请输入以下命令：

   # hammer report-template dump --id My_Template_ID > example_export.erb

流程

1. 使用以下请求检索可用报告模板列表：

   请求示例：

   $ curl --insecure --user admin:redhat \
   --request GET \
   --config https://satellite.example.com/api/report_templates \
   | json_reformat

   在本例中，json_reformat 工具用于格式化 JSON 输出。

   响应示例：

   {
       "total": 6,
       "subtotal": 6,
       "page": 1,
       "per_page": 20,
       "search": null,
       "sort": {
           "by": null,
           "order": null
       },
       "results": [
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applicable errata",
               "id": 112
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Applied Errata",
               "id": 113
           },
           {
               "created_at": "2019-11-30 16:15:24 UTC",
               "updated_at": "2019-11-30 16:15:24 UTC",
               "name": "Hosts - complete list",
               "id": 158
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Host statuses",
               "id": 114
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Registered hosts",
               "id": 115
           },
           {
               "created_at": "2019-11-20 17:49:52 UTC",
               "updated_at": "2019-11-20 17:49:52 UTC",
               "name": "Subscriptions",
               "id": 116
           }
       ]
   }

2. 请注意您要导出的模板的 id，并使用以下请求导出模板：

   请求示例：

   $ curl --insecure --output /tmp/_Example_Export_Template.erb_ \
   --user admin:password --request GET --config \
   https://satellite.example.com/api/report_templates/My_Template_ID/export

   请注意，158 是要导出的模板的示例 ID。

   在本例中，导出的模板重定向到 host_complete_list.erb。

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates。
2. 在 Report Templates 窗口右上角的 Create Template。
3. 在 Editor 选项卡的右上角，单击文件夹图标，然后选择要导入的 .erb 文件。
4. 编辑模板以符合您的要求。
5. 点 Submit。

流程

1. 使用以下示例格式化您要导入到 .json 文件的模板：

   # cat Example_Template.json
   {
       "name": "Example Template Name",
       "template": "
       Enter ERB Code Here
   "
   }

   使用 ERB 模板的 JSON 文件示例：

   {
       "name": "Hosts - complete list",
       "template": "
   <%#
   name: Hosts - complete list
   snippet: false
   template_inputs:
   - name: host
     required: false
     input_type: user
     advanced: false
     value_type: plain
     resource_type: Katello::ActivationKey
   model: ReportTemplate
   -%>
   <% load_hosts(search: input('host')).each_record do |host| -%>
   <%
         report_row(
             'Server FQDN': host.name
         )
   -%>
   <%  end -%>
   <%= report_render %>
   "
   }

2. 使用以下请求导入模板：

   $ curl --insecure --user admin:redhat \
   --data @Example_Template.json --header "Content-Type:application/json" \
   --request POST --config https://satellite.example.com/api/report_templates/import

3. 使用以下请求检索报告模板列表，并验证您可以在 Satellite 中查看模板：

   $ curl --insecure --user admin:redhat \
    --request GET --config https://satellite.example.com/api/report_templates | json_reformat

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Report Templates，然后点 Create Template。

2. 可选：在 Editor 字段中，使用 <%# > 标签添加带有稍后引用信息的注释。例如：

   <%#
   name: Entitlements
   snippet: false
   model: ReportTemplate
   require:
   - plugin: katello
     version: 3.14.0
   -%>

3. 使用 load_hosts（） 宏添加一行，并使用以下方法和变量填充宏：

   <%- load_hosts(includes: [:lifecycle_environment, :operatingsystem, :architecture, :content_view, :organization, :reported_data, :subscription_facet, :pools => [:subscription]]).each_record do |host| -%>

   要查看您可以使用的变量列表，点 Help 选项卡并在 Safe 模式方法和变量 表中找到 Host::Managed 行。

4. 使用 每个 方法添加 host.pools 变量的行，例如：

   <%- host.pools.each do |pool| -%>

   注意

   池 只适用于非简单内容访问(SCA)组织。

5. 使用 report_row（） 方法添加一行，以创建报告并添加您要作为报告一部分的变量：

   <%-     report_row(
             'Name': host.name,
             'Organization': host.organization,
             'Lifecycle Environment': host.lifecycle_environment,
             'Content View': host.content_view,
             'Host Collections': host.host_collections,
             'Virtual': host.virtual,
             'Guest of Host': host.hypervisor_host,
             'OS': host.operatingsystem,
             'Arch': host.architecture,
             'Sockets': host.sockets,
             'RAM': host.ram,
             'Cores': host.cores,
             'SLA': host_sla(host),
             'Products': host_products(host),
             'Subscription Name': sub_name(pool),
             'Subscription Type': pool.type,
             'Subscription Quantity': pool.quantity,
             'Subscription SKU': sub_sku(pool),
             'Subscription Contract': pool.contract_number,
             'Subscription Account': pool.account_number,
             'Subscription Start': pool.start_date,
             'Subscription End': pool.end_date,
             'Subscription Guest': registered_through(host)
             ) -%>

6. 在模板中添加最终语句：

   <%-   end -%>
   <%- end -%>

7. 要生成报告，您必须添加 <% = report_render -%> 宏：

   <%= report_render -%>

8. 单击 Submit 以保存模板。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 单击 New Host Collection。
3. 添加 主机集合的名称。
4. 清除 Unlimited Content Hosts，在 Limit 自动中输入期望的最多的主机数量。
5. 添加主机集合的 Description。
6. 点击 Save。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 在左侧面板中，点击您要克隆的主机集合。
3. 点 Copy Collection。
4. 指定克隆的集合的名称。
5. 点 Create。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择要删除的主机集合。

3. 单击 Remove。此时会出现警报框：

   Are you sure you want to remove host collection Host Collection Name?

4. 单击 Remove。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择应添加主机的主机集合。
3. 在 "主机 "选项卡上，选择" 添加 "子选项卡。
4. 从表中选择要添加的主机，然后单击添加所选项。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Host Collections。
2. 选择所需的主机集合。
3. 在" 主机 "选项卡上，选择" 列出/删除 "子选项卡。
4. 从主机集合中选择您要删除的主机，然后单击 Remove Selected。

1. 卫星找到了选中了 远程执行 复选框的主机接口。
2. 卫星找到这些接口的子网。
3. 卫星找到分配给这些子网的远程执行胶囊。
4. 从这一组胶囊中，Satellite 选择具有最少数量的运行作业的胶囊。这样，卫星可确保作业负载在远程执行胶囊之间平衡。

流程

1. 在主机上安装 katello-pull-transport-migrate 软件包：

   • 在 Red Hat Enterprise Linux 8 和 Red Hat Enterprise Linux 9 主机上：

     # dnf install katello-pull-transport-migrate

   • On Red Hat Enterprise Linux 7 hosts:

     # yum install katello-pull-transport-migrate

   该软件包将 foreman_ygg_worker 和 yggdrasil 作为依赖项安装，并在主机上启用拉取模式。主机的 subscription-manager 配置和使用者证书用于配置主机上的 yggdrasil 客户端，并启动了 pull 模式客户端 worker。

2. 可选： 要验证 pull 客户端是否正在运行并正确配置，请检查 yggdrasild 服务的状态：

   # systemctl status yggdrasild

3. 可选：在安装软件包后，您可以从主机中删除 katello-agent。

   警告

   如果您的主机安装在 Red Hat Virtualization 版本 4.4 或较低版本中，请不要删除 katello-agent 软件包，因为删除的依赖关系会破坏主机。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Job templates。
2. 单击 New Job Template。
3. 单击 Template 选项卡，并在 Name 字段中输入作业模板的唯一名称。
4. 选择 Default 使模板可用于所有组织和位置。
5. 直接在模板编辑器中创建模板，或通过单击 Import 从文本文件上传。
6. 可选：在 Audit Comment 字段中添加有关更改的信息。
7. 点 Job 选项卡，并在 Job category 字段中输入您自己的类别，或者从管理主机的默认作业模板类别的默认类别中进行选择。
8. 可选：在 Description Format 字段中输入描述模板。例如，安装软件包 %{package_name}.您还可以在模板中使用 %{template_name} 和 %{job_category}。
9. 在 Provider Type 列表中，为 shell 脚本选择 SSH，为 Ansible 任务或 playbook 选择 Ansible。
10. 可选：在 Timeout to kill 字段中，输入超时值来终止作业（如果未完成）。
11. 可选：点 Add Input 来定义输入参数。执行作业时，不需要在模板中定义参数。例如，请参阅 帮助 选项卡。
12. 可选：点击 Foreign 输入集 来在此作业中包含其他模板。
13. 可选： 在 Effective 用户 区域中，如果命令无法使用默认的 remote_execution_effective_user 设置，则配置用户。
14. 可选：如果此模板是要包含在其他模板的代码片段，点 Type 选项卡并选择 Snippet。
15. 单击 Location 选项卡，再添加您要使用模板的位置。
16. 单击 Organizations 选项卡，再添加您要使用模板的组织。
17. 点 Submit 保存您的更改。

流程

1. 使用以下 API 请求获取可用的 Ansible playbook：

   # curl -X GET -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/fetch?proxy_id=My_capsule_ID

2. 选择您要导入的 Ansible playbook 并记下其名称。

3. 使用名称导入 Ansible playbook：

   # curl -X PUT -H 'Content-Type: application/json' -d '{ "playbook_names": ["My_Playbook_Name"] }' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My_capsule_ID

   导入完成后，您可以在卫星 Web UI 中获得通知。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。
2. 点 Remote Execution。
3. 将 Fallback 配置为 Any Capsule 设置。

流程

1. 在 Satellite Web UI 中，导航到 Administer > Settings。
2. 点 Remote Execution。
3. 配置 Enable Global Capsule 设置。

流程

1. 在主机上，创建一个新目录：

   # mkdir /My_Remote_Working_Directory

2. 从默认的 /var/tmp 目录中复制 SELinux 上下文：

   # chcon --reference=/var/tmp /My_Remote_Working_Directory

3. 将您的 Satellite 服务器或 Capsule 服务器配置为使用新目录：

   # satellite-installer \
   --foreman-proxy-plugin-remote-execution-script-remote-working-dir /My_Remote_Working_Directory

1. 创建新目录：

   # mkdir /My_Remote_Working_Directory

2. 访问 yggdrasild 服务配置：

   # systemctl edit yggdrasild

3. 通过在配置中添加以下行来指定替代目录：

   Environment=FOREMAN_YGG_WORKER_WORKDIR=/My_Remote_Working_Directory

4. 重启 yggdrasild 服务：

   # systemctl restart yggdrasild

流程

1. 导航到 Administer > Settings。
2. 选择 Remote Execution 选项卡。
3. 点 Effective User Method 设置的值。
4. 选择新值。
5. 点 Submit。

1. 第 12.15 节 “手动将 SSH 密钥分发到远程执行”.
2. 第 12.17 节 “使用 Satellite API Obtain SSH Keys for Remote Execution”.
3. 第 12.18 节 “在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥”.
4. 对于新的 Satellite 主机，您可以使用全局注册模板在注册过程中将 SSH 密钥部署到卫星主机。如需更多信息，请参阅管理主机中的使用全局注册模板将主机注册到 Red Hat Satellite。

流程

1. 在目标主机上，创建 ~/.ssh 目录来存储 SSH 密钥：

   # mkdir ~/.ssh

2. 从 Capsule 下载 SSH 密钥：

   # curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys

3. 为 ~/.ssh 目录配置权限：

   # chmod 700 ~/.ssh

4. 为 authorized_keys 文件配置权限：

   # chmod 600 ~/.ssh/authorized_keys

流程

1. 查找 foreman-proxy 用户的 ID：

   # id -u foreman-proxy

2. 修改 umask 值，使新文件的权限为 600 ：

   # umask 077

3. 为 keytab 创建目录：

   # mkdir -p "/var/kerberos/krb5/user/My_User_ID"

4. 创建 keytab 或将现有 keytab 复制到目录中：

   # cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytab

5. 将目录所有者更改为 foreman-proxy 用户：

   # chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"

6. 确保 keytab 文件为只读：

   # chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"

7. 恢复 SELinux 上下文：

   # restorecon -RvF /var/kerberos/krb5

流程

1. 要为远程执行安装并启用 Kerberos 验证，请输入以下命令：

   # satellite-installer --scenario satellite \
   --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth true

2. 要编辑用于远程执行的默认用户，请在 Satellite Web UI 中进入到 Administer > Settings 并点 Remote Execution 选项卡。在 SSH User 行中，编辑第二列并添加 Kerberos 帐户的用户名。
3. 导航到 remote_execution_effective_user，再编辑第二列来添加 Kerberos 帐户的用户名。

流程

1. 要克隆模板（在 Actions 列中），请选择 Clone。
2. 输入克隆的唯一名称，然后点 Submit 以保存更改。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts 并选择您要在其上执行远程作业的目标主机。您可以使用搜索字段来过滤主机列表。
2. 从 Select Action 列表中，选择 Schedule a Job。
3. 在 Job invocation 页面中，定义主作业设置：
4. 选择要使用的 Job category 和 Job 模板。
5. 可选：在 Bookmark 列表中选择一个存储的搜索字符串来指定目标主机。
6. 可选：通过输入搜索查询来限制目标主机。连续到 行显示受您的查询影响的主机数。使用刷新按钮重新计算更改查询后的数字。preview 图标列出了目标主机。
7. 剩余的设置取决于所选的作业模板。如需有关在模板中添加自定义参数的信息，请参阅创建作业模板。

8. 可选：要为作业配置高级设置，请点击 Display advanced fields。一些高级设置取决于作业模板，以下设置是常规的：

   • 有效的用户 定义了执行作业的用户，默认为 SSH 用户。
   • 并发级别 定义了一次执行的最大作业数，这可在大量主机上执行作业时防止超载系统资源。
   • 超时（以 以秒为单位为单位）定义作业应该被终止的时间间隔（如果作业尚未完成）。在定义的时间间隔期间无法启动的任务（例如，如果上一任务需要很长时间才能完成），则会取消。
   • 查询类型定义了搜索查询 何时被评估。这有助于使查询保持最新状态以进行调度任务。

   • 执行顺序 决定了在主机上执行该作业的顺序：字母顺序或随机。

     通过 并发级别 和超时 以中断设置，您可以定制作业执行，以适应基础架构硬件和需求。

9. 要立即运行作业，请确保 Schedule 设置为 Execute now。您还可以定义一个一次性作业，或者设置周期性作业。对于周期性任务，您可以定义开始和结束日期、运行次数和频率。您还可以使用 cron 语法来定义重复性。有关 cron 的更多信息，请参阅使用 cron 自动执行 Linux 系统任务。
10. 点 Submit。您可以在同一页面上的 Recent Jobs 部分中查看作业的状态。

CLI 过程

1. 在 Satellite 中输入以下命令：

   # hammer settings set \
   --name=remote_execution_global_proxy \
   --value=false

2. 查找您要使用的作业模板 ID：

   # hammer job-template list

3. 显示模板详情以查看模板所需的参数：

   # hammer job-template info --id My_Template_ID

4. 使用自定义参数执行远程作业：

   # hammer job-invocation create \
   --inputs My_Key_1="My_Value_1",My_Key_2="My_Value_2",... \
   --job-template "My_Template_Name" \
   --search-query "My_Search_Query"

   将 My_Search_Query 替换为定义主机的过滤器表达式，如 "name ~ My_Pattern"。有关使用 hammer 执行远程命令的更多信息，请输入 hammer job-template --help 和 hammer job-invocation --help。

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts 并选择您要在其上执行远程作业的目标主机。
2. 在 Ansible 标签页中，选择 Jobs。
3. 单击 Schedule 周期性作业。
4. 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
5. 点 Submit。
6. 可选：在主机概述中查看调度的 Ansible 作业，或导航到 Ansible > Jobs。

流程

1. 在 Satellite Web UI 中，进入 Configure > Host groups。
2. 在 Actions 列中，为您要调度运行 Ansible 角色的主机组选择 Configure Ansible Job。
3. 单击 Schedule 周期性作业。
4. 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
5. 点 Submit。

流程

1. 在 Satellite Web UI 中，进入 Monitor > Jobs。如果您使用 Execute now 设置触发作业，则会自动显示此页面。要监控调度的作业，请导航到 Monitor > Jobs 并选择您要检查的作业运行。
2. 在 Job 页面上，单击 Hosts 选项卡。这将显示运行作业的主机列表。
3. 在 Host 列中，单击您要检查的主机的名称。这将显示 Commands 页面的详细信息，您可以在其中实时监控作业执行。
4. 随时单击 Back to Job，以返回到 Job Details 页面。

CLI 过程

1. 查找作业的 ID：

   # hammer job-invocation list

2. 监控作业输出：

   # hammer job-invocation output \
   --host "My_Host_Name" \
   --id My_Job_ID

3. 可选： 要取消作业，请输入以下命令：

   # hammer job-invocation cancel \
   --id My_Job_ID

流程

1. 要在 Satellite 服务器中启用插件，请输入以下命令：

   # satellite-installer --enable-foreman-plugin-templates

2. 要验证插件是否已正确安装，请确保 Administer > Settings 包含 TemplateSync 菜单。

流程

1. 使用 Satellite 安装程序禁用插件：

   # satellite-installer --no-enable-foreman-plugin-templates

2. 清理插件的自定义数据。该命令不会影响您创建的任何模板。

   # foreman-rake templates:cleanup

3. 卸载插件：

   # satellite-maintain packages remove foreman-plugin-templates

流程

1. 在 Satellite Web UI 中，进入到 Hosts > All Hosts 并选择您要安装的软件包的主机。
2. 在 Content 选项卡中，选择 Packages 选项卡。
3. 在升级按钮旁边的垂直 ellipsis 图标上，点 Install Packages。
4. 在 Install packages 窗口中，选择要在主机上安装的软件包或软件包。
5. 点 Install。

API 流程

1. 创建 "job_invocation" 对象，并将其余正文放在此对象内。
2. 使用字符串类型的 "package" 字段创建 "inputs" 对象，指定您要安装的软件包。如果您要指定多个软件包，请使用空格分开它们。
3. 为字符串类型创建一个 "feature" 字段，其值为 "katello_package_install "。
4. 为字符串类型创建一个 "search_query" 字段，并输入与您要安装软件包的主机匹配的搜索查询。

5. 可选：如果要以特定用户身份安装软件包，请使用字符串类型的以下字段创建一个 ssh 对象：

   • 使用 ssh 用户名称的 "effective_user"
   • 如果需要此密码，使用 ssh 用户的密码 "effective_user_password"

6. 可选： 如果要稍后安装软件包，请创建 "scheduling" 对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段，包括日期、时间和时区：

   • "start_at"- 设置安装软件包的时间
   • "start_before" - 设置安装软件包的最新时间。如果此时无法安装软件包，则会取消这个操作。

   如果省略了时间，则默认为 00:00:00。如果省略了时区，则默认为 UTC。

7. 可选： 如果要限制同时运行作业的主机数量，请使用整数类型的 "concurrency_level" 字段创建 "concurrency_control" 对象。将主机数量分配为字段值。
8. 可选： 如果要稍后安装软件包，并且您希望在运行作业时评估主机搜索查询，请使用 "dynamic_query" 值创建字符串类型的 "targeting_type" 字段。如果您预期搜索查询的结果在运行作业时不同，因为主机状态改变，则这非常有用。如果省略此字段，则默认为 "static_query "。

9. 使用创建的正文发送 POST 请求到 Satellite 服务器的 /api/job_invocations 端点，并使用 python 等工具来查看格式化的响应。

   API 请求示例：

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 Content 选项卡，然后点 Packages 选项卡。
4. 从 Status 列表中选择 Upgradable。
5. 选择您要升级的软件包。
6. 点 Upgrade 按钮。远程执行作业完成后，您将获得一个 REX 作业通知。

API 流程

1. 创建 "job_invocation" 对象，并将其余正文放在此对象内。
2. 使用字符串类型的 "package" 字段创建 "inputs" 对象，指定您要更新的软件包。如果您要指定多个软件包，请使用空格分开它们。
3. 为字符串类型创建一个 "feature" 字段，其值为 "katello_package_update "。
4. 为字符串类型创建一个 "search_query" 字段，并输入与要更新软件包的主机匹配的搜索查询。

5. 可选： 如果要以特定用户身份更新软件包，请使用字符串类型的以下字段创建一个 ssh 对象：

   • 使用 ssh 用户名称的 "effective_user"
   • 如果需要此密码，使用 ssh 用户的密码 "effective_user_password"

6. 可选： 如果要稍后更新软件包，请创建 "scheduling" 对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段，包括日期、时间和时区：

   • "start_at"- 设置更新软件包的时间
   • "start_before" - 设置更新软件包的最新时间。如果此时无法更新软件包，则会取消这个操作。

   如果省略了时间，则默认为 00:00:00。如果省略了时区，则默认为 UTC。

7. 可选： 如果要限制同时运行作业的主机数量，请使用整数类型的 "concurrency_level" 字段创建 "concurrency_control" 对象。将主机数量分配为字段值。
8. 可选： 如果要稍后更新软件包，并且您希望在运行作业时评估主机搜索查询，请使用 "dynamic_query" 值创建字符串类型的 "targeting_type" 字段。如果您预期搜索查询的结果在运行作业时不同，因为主机状态改变，则这非常有用。如果省略此字段，则默认为 "static_query "。

9. 使用创建的正文发送 POST 请求到 Satellite 服务器的 /api/job_invocations 端点，并使用 python 等工具来查看格式化的响应。

   API 请求示例：

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 点击要修改的主机的名称。
3. 点 Content 选项卡，然后点 Packages 选项卡。
4. 点要删除的软件包的垂直 ellipsis，然后选择 Remove。远程执行作业完成后，您将获得一个 REX 作业通知。

API 流程

1. 创建 "job_invocation" 对象，并将其余正文放在此对象内。
2. 使用字符串类型的 "package" 字段创建 "inputs" 对象，指定您要删除的软件包。如果您要指定多个软件包，请使用空格分开它们。
3. 为字符串类型创建一个 "feature" 字段，其值为 "katello_package_remove "。
4. 为字符串类型创建一个 "search_query" 字段，并输入与您要删除软件包的主机匹配的搜索查询。

5. 可选：如果要以特定用户身份删除软件包，请使用字符串类型的以下字段创建一个 ssh 对象：

   • 使用 ssh 用户名称的 "effective_user"
   • 如果需要此密码，使用 ssh 用户的密码 "effective_user_password"

6. 可选： 如果要稍后删除软件包，请创建 "scheduling" 对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段，包括日期、时间和时区：

   • "start_at"- 设置删除软件包的时间
   • "start_before" - 设置删除软件包的最新时间。如果此时无法删除软件包，则会取消这个操作。

   如果省略了时间，则默认为 00:00:00。如果省略了时区，则默认为 UTC。

7. 可选： 如果要限制同时运行作业的主机数量，请使用整数类型的 "concurrency_level" 字段创建 "concurrency_control" 对象。将主机数量分配为字段值。
8. 可选： 如果要稍后删除软件包，并且您希望在运行作业时评估主机搜索查询，请使用 "dynamic_query" 值创建字符串类型的 "targeting_type" 字段。如果您预期搜索查询的结果在运行作业时不同，因为主机状态改变，则这非常有用。如果省略此字段，则默认为 "static_query "。

9. 使用创建的正文发送 POST 请求到 Satellite 服务器的 /api/job_invocations 端点，并使用 python 等工具来查看格式化的响应。

   API 请求示例：

   curl https://satellite.example.com/api/job_invocations \
   -H "content-type: application/json" \
   -X POST \
   -d @Path_To_My_API_Request_Body \
   -u My_Username:My_Password | python3 -m json.tool