管理主机
将主机注册到 Satellite,配置主机组和集合、设置远程执行、管理主机上的软件包、监控主机等
摘要
向红帽文档提供反馈 复制链接链接已复制到粘贴板!
我们感谢您对我们文档的反馈。让我们了解如何改进它。
使用 Red Hat JIRA 中的 Create Issue 表单提供您的反馈。JIRA 问题在 Red Hat Satellite Jira 项目中创建,您可以在其中跟踪其进度。
先决条件
- 确保您已注册了 红帽帐户。
流程
- 单击以下链接: 创建问题。如果 Jira 显示登录错误,则登录并在您重定向到表单后继续。
- 完成 Summary 和 Description 字段。在 Description 字段中,包含文档 URL、章节号以及问题的详细描述。不要修改表单中的任何其他字段。
- 点 Create。
第 1 章 Satellite 中的主机概述 复制链接链接已复制到粘贴板!
主机是 Red Hat Satellite 管理的任何 Linux 客户端。主机可以是物理或虚拟的。虚拟主机可以部署到 Red Hat Satellite 支持的任何平台上,如 Amazon EC2、Google Compute Engine、KVM、libvirt、Microsoft Azure、OpenStack、Red Hat Virtualization、Rackspace Cloud Services 或 VMware vSphere。
Red Hat Satellite 可大规模启用主机管理,包括监控、配置、远程执行、配置管理、软件管理和订阅管理。您可以从 Satellite Web UI 或命令行管理主机。
在 Satellite Web UI 中,您可以浏览 Satellite 服务器可识别的所有主机,按类型分组:
- 所有主机 - Satellite 服务器可识别的所有主机的列表。
- 发现的主机 - 通过 Discovery 插件在 provisioning 网络中检测到的裸机主机列表。
- 内容主机 - 管理与内容和订阅相关的任务的主机列表。
- Host Collections - 用于批量操作(如勘误安装)的用户定义的主机集合列表。
要搜索主机,请在 Search 字段中输入,并使用星号 packagemanifests 来执行部分字符串搜索。例如,如果搜索名为 dev-node.example.com 的内容主机,点 Content Hosts 页面并在 Search 字段中输入 dev-node*。另外,*node* 也会找到内容主机 dev-node.example.com。
Satellite 服务器被列为主机本身,即使它没有自我注册。不要从主机列表中删除 Satellite 服务器。
第 2 章 管理主机 复制链接链接已复制到粘贴板!
本章论述了创建、注册、管理和删除主机。
2.1. 在 Red Hat Satellite 中创建主机 复制链接链接已复制到粘贴板!
使用这个流程在 Red Hat Satellite 中创建主机。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,点 Hosts > Create Host。
- 在 Host 选项卡中,输入所需的详情。
- 单击 Ansible Roles 选项卡,然后从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理您添加或删除的角色。
- 在 Puppet Classes 选项卡上,选择您要包含的 Puppet 类。
在 Interfaces 选项卡中:
对于每个接口,点 Actions 列中的 Edit,并根据需要配置以下设置:
- Type — 对于一个 Bond 或 BMC 接口,使用 Type 列表并选择接口类型。
- MAC 地址 criu-wagonEnter MAC 地址。
- DNS 名称 mvapich-wagonEnter DNS 名称对 DNS 服务器已知的 DNS 名称。这用于 FQDN 的主机部分。
- Domain — 选择置备网络的域名。这会使用选择合适的 子网 自动更新子网列表。
- 从列表中,IPv4 子网 criu- iwlSelect 主机有一个 IPv4 子网。
- 从列表中 ,IPv6 子网为主机选择 IPv6 子网。
- IPv4 address — 如果 IP address management (IPAM) 已为子网启用,IP 地址会被自动推荐。或者,您可以输入地址。如果启用了置备令牌,则可以省略地址;如果域不管理 DNS,如果子网不管理反向 DNS,或者子网没有管理 DHCP 保留。
- IPv6 address — 如果 IP address management (IPAM) 已为子网启用,IP 地址会被自动推荐。或者,您可以输入地址。
- 在置备过程中,受管 criu- iwlSelect 此复选框将接口配置为使用胶囊提供的 DHCP 和 DNS 服务。
- primary criu- iwlSelect this 复选框,将这个接口的 DNS 名称用作 FQDN 的主机部分。
-
置备 iwl- iwlSelect this 复选框,以使用此接口进行置备。这意味着,TFTP 引导将使用这个接口进行;或者,如果基于镜像的调配,则完成调配的脚本将通过此接口来执行。请注意,许多调配任务(如在
%post脚本中通过 anaconda 或 Puppet 设置下载软件包)将使用主接口。 如果此接口不是物理设备,则 虚拟 NIC criu-wagonSelect此复选框。此设置有两个选项:
- 标签 criu-wagon 可选设置 VLAN 标签。如果未设置,则标签将是子网的 VLAN ID。
- Attached to — 输入这个虚拟机要附加到的接口名称。
- 单击 OK 以保存接口配置。
- (可选)点 Add Interface 来包含一个额外的网络接口。更多信息请参阅 第 5 章 添加网络接口。
- 点 Submit 以应用更改并退出。
- 在 Operating System 选项卡中,输入所需的详情。对于红帽操作系统,请选择 Synced Content for Media Selection。如果要使用非红帽操作系统,请选择 All Media,然后从 Media Selection 列表中选择安装介质。您可以从列表中选择一个分区表,或者在 Custom 分区表字段中输入自定义分区表。您不能同时指定。
在 Parameters 选项卡上,单击 Add Parameter,以添加您要在运行时传递给作业模板的任何参数变量。这包括您要与主机关联的所有 Puppet 类、Ansible playbook 参数和主机参数。要将参数变量与 Ansible 作业模板搭配使用,您必须添加一个 Host 参数。
创建 Red Hat Enterprise Linux 8 主机时,您可以设置系统目的属性。系统目的属性定义了在主机创建时自动附加哪些订阅。在 Host Parameters 区域中,输入具有对应值的以下参数名称。有关值列表,请参阅 自动安装 RHEL 8 中的 使用 subscription-manager 命令行工具配置系统目的。
-
syspurpose_role -
syspurpose_sla -
syspurpose_usage -
syspurpose_addons
如果要使用 pull 模式为远程作业执行创建主机,请添加
enable-remote-execution-pull参数,并将 typeboolean设置为true。更多信息请参阅 第 12.4 节 “远程执行的传输模式”。-
- 在 Additional Information 选项卡中,输入有关主机的附加信息。
- 点 Submit 以完成您的置备请求。
CLI 过程
要创建与主机组关联的主机,请输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 这个命令会提示您输入 root 密码。必须指定主机的 IP 和 MAC 地址。主网络接口的其他属性可以从主机组继承,也可以使用
--subnet和--domain参数设置。您可以使用--interface选项设置附加接口,该选项接受键值对列表。如需可用接口设置列表,请输入hammer host create --help命令。
2.2. 克隆主机 复制链接链接已复制到粘贴板!
您可以克隆现有主机。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 在 Actions 菜单中,单击 Clone。
- 在 Host 选项卡中,确保提供与原始主机不同的名称。
- 在 Interfaces 选项卡中,确保提供不同的 IP 地址。
- 单击 Submit 以克隆主机。
更多信息请参阅 第 2.1 节 “在 Red Hat Satellite 中创建主机”。
2.3. 从 Hypervisor 将虚拟机与 Satellite 相关联 复制链接链接已复制到粘贴板!
流程
- 在 Satellite Web UI 中,进入到 Infrastructure > Compute Resources。
- 选择计算资源。
- 在 Virtual Machines 选项卡上,从 Actions 菜单中选择 Associate VM。
2.4. 编辑主机的系统目的 复制链接链接已复制到粘贴板!
您可以为 Red Hat Enterprise Linux 主机编辑系统目的属性。通过系统目的,您可以对网络设置系统的预期使用,并提高了 Red Hat Hybrid Cloud Console 订阅服务中的报告准确性。有关系统目的的更多信息,请参阅 自动安装 RHEL 8 中的 使用 subscription-manager 命令行工具配置系统目的。
先决条件
- 要编辑的主机必须使用 subscription-manager 注册。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 在 Overview 选项卡中,点 System purpose 卡上的 Edit。
- 为您的主机选择系统目的属性。
- 点击 Save。
CLI 过程
登录主机并编辑所需的系统目的属性。例如,将使用类型设置为
Production,将角色设置为Red Hat Enterprise Linux Server,并添加addon附加组件。有关值列表,请参阅 自动安装 RHEL 8 中的 使用 subscription-manager 命令行工具配置系统目的。subscription-manager syspurpose set usage 'Production' subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server' subscription-manager syspurpose add addons 'your_addon'
# subscription-manager syspurpose set usage 'Production' # subscription-manager syspurpose set role 'Red Hat Enterprise Linux Server' # subscription-manager syspurpose add addons 'your_addon'Copy to Clipboard Copied! Toggle word wrap Toggle overflow 验证此主机的系统目的属性:
subscription-manager syspurpose
# subscription-manager syspurposeCopy to Clipboard Copied! Toggle word wrap Toggle overflow 自动将订阅附加到此主机:
subscription-manager attach --auto
# subscription-manager attach --autoCopy to Clipboard Copied! Toggle word wrap Toggle overflow 验证此主机的系统目的状态:
subscription-manager status
# subscription-manager statusCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.5. 编辑多个主机的系统目的 复制链接链接已复制到粘贴板!
您可以编辑 Red Hat Enterprise Linux 主机的系统目的属性。系统目的属性定义要自动将哪些订阅附加到主机。有关系统目的的更多信息,请参阅 自动安装 RHEL 8 中的 使用 subscription-manager 命令行工具配置系统目的。
先决条件
- 要编辑的主机必须使用 subscription-manager 注册。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Content Hosts 并选择您要编辑的 Red Hat Enterprise Linux 8 主机。
- 单击 Select Action 列表,再选择 Manage System Purpose。
选择您要分配给所选主机的系统目的属性。您可以选择以下值之一:
- 用于设置所有所选主机的特定属性。
- 没有更改 来保留所选主机上设置的属性。
- none (Clear) 清除所选主机上的属性。
- 单击 Assign。
- 在 Satellite Web UI 中,进入到 Hosts > Content Hosts 并选择相同的 Red Hat Enterprise Linux 8 主机,以根据系统目的自动附加订阅。
- 单击 Select Action 列表,再选择 Manage Subscriptions。
- 点 Auto-Attach 以根据其系统角色自动将订阅附加到所有选择的主机。
2.6. 更改主机的模块流 复制链接链接已复制到粘贴板!
如果您有一个运行 Red Hat Enterprise Linux 8 的主机,您可以修改您安装的仓库的模块流。
您可以在 Satellite Web UI 中启用、禁用、安装、更新和删除模块流。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 单击 Content 选项卡,然后单击 Module streams 选项卡。
- 点模块旁边的垂直 ellipsis,然后选择您要执行的操作。完成远程执行作业后,您会收到 REX 作业通知。
2.7. 在内容主机上启用自定义存储库 复制链接链接已复制到粘贴板!
作为简单内容访问(SCA)用户,您可以使用 Satellite Web UI 在内容主机上启用所有自定义存储库。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 并选择主机。
- 选择 Content 选项卡,然后选择 Repository set。
- 从下拉菜单中,您可以将 Repository type 列过滤到 Custom。
- 选择所需存储库数量,或者点击 Select All 复选框来选择所有存储库,然后单击垂直 ellipsis,然后选择 Override to Enabled。
2.8. 创建主机组 复制链接链接已复制到粘贴板!
如果您创建了大量主机,则很多主机都有通用设置和属性。为每个新主机添加这些设置和属性非常耗时。如果使用主机组,您可以将通用属性应用到您创建的主机。
主机组作为常见主机设置的模板,包含提供给主机的许多相同详细信息。使用主机组创建主机时,主机将继承主机组中的定义的设置。然后,您可以为单个主机提供附加详情。
要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
主机组层次结构
您可以创建主机组的层次结构。旨在具有一个代表您机构中所有主机的基本级别主机组,并提供常规设置,然后嵌套组以提供特定的设置。例如,您可以有一个定义操作系统的基本级别的主机组,以及继承基本级别主机组的两个嵌套主机组:
hostgroup:
Base(Red Hat Enterprise Linux 8.8)Hostgroup:
Webserver(应用nginxPuppet 类)-
主机:
webserver1.example.com(Web 服务器) -
主机:
webserver2.example.com(Web 服务器)
-
主机:
hostgroup:
Storage(应用nfsPuppet 类)-
主机:
storage1.example.com(存储服务器) -
主机:
storage2.example.com(存储服务器)
-
主机:
-
主机:
custom.example.com(自定义主机)
在本例中,所有主机都使用 Red Hat Enterprise Linux 7.6 作为其操作系统,因为它们继承了 Base 主机组。两个 Web 服务器主机从 Webserver 主机组继承设置,其中包括 nginx Puppet 类以及来自 Base 主机组中的设置。两个存储服务器从 Storage 主机组继承设置,其中包括 nfs Puppet 类以及 Base 主机组中的设置。自定义主机仅继承 Base 主机组的设置。
流程
- 在 Satellite Web UI 中,进入到 Configure > Host Groups 并点 Create Host Group。
- 如果您有一个要从中继承属性的现有主机组,您可以从 Parent 列表中选择主机组。如果没有,请将此字段留空。
- 输入新主机组的 Name。
- 输入您希望将来的主机继承的任何更多信息。
- 单击 Ansible Roles 选项卡,然后从 Ansible Roles 列表中选择您要添加到主机的一个或多个角色。使用 箭头图标 管理您添加或删除的角色。
点附加选项卡,并将您要属性的任何详情添加到主机组中。
注意在注册与
生产环境中创建的 Puppet 环境关联的主机组时,Puppet 无法检索 Puppet CA 证书。要创建与主机组关联的适当 Puppet 环境,请手动创建目录:
mkdir /etc/puppetlabs/code/environments/example_environment
# mkdir /etc/puppetlabs/code/environments/example_environmentCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 点 Submit 以保存主机组。
CLI 过程
使用
hammer hostgroup create命令创建主机组。例如:Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.9. 为每个生命周期环境创建主机组 复制链接链接已复制到粘贴板!
使用这个流程为 Library 生命周期环境创建主机组,并为其他生命周期环境添加嵌套式主机组。
流程
要为每个生命周期环境创建主机组,请运行以下 Bash 脚本:
2.10. 将主机添加到主机组 复制链接链接已复制到粘贴板!
您可以在 Satellite Web UI 中将主机添加到主机组。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Edit。
- 从 Host Group 列表中选择主机组。
- 点 Submit。
验证
- Overview 选项卡下的 Details 卡现在显示您的主机所属的主机组。
2.11. 更改主机的主机组 复制链接链接已复制到粘贴板!
使用这个流程更改主机的主机组。
如果在更改主机组后重新置备主机,则会应用主机从主机组继承的新值。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Edit。
- 从 Host Group 列表中选择新的主机组。
- 点 Submit。
验证
- Overview 选项卡下的 Details 卡现在显示您的主机所属的主机组。
2.12. 将主机添加到主机集合 复制链接链接已复制到粘贴板!
您可以在 Satellite Web UI 中将主机添加到主机集合。
先决条件
主机必须注册到 Red Hat Satellite,才能将其添加到主机集合中。有关注册主机的详情,请参考 第 3.3 节 “使用全局注册注册主机”。
请注意,如果您将主机添加到主机集合,Satellite 审计系统不会记录更改。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 在 Host collections 卡中,点垂直 ellipsis 并选择 Add host to collections。
- 选择主机集合。
- 点 Add。
CLI 过程
要将主机添加到主机集合,请输入以下命令:
hammer host-collection add-host \ --host-ids My_Host_ID_1 \ --id My_Host_Collection_ID
# hammer host-collection add-host \ --host-ids My_Host_ID_1 \ --id My_Host_Collection_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.13. 更改主机的内容源 复制链接链接已复制到粘贴板!
内容源是主机从中消耗内容的胶囊。使用这个流程更改主机的内容源。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Edit 按钮旁边的垂直 ellipsis 图标,然后选择 Change content source。
- 从列表中选择 Content Source,Lifecycle Content View, 和 Content Source。
点更改内容源。
注意如果一些生命周期环境没有在所选内容源上同步,则无法选择它们。有关更多信息,请参阅管理内容中的将生命周期环境添加到胶囊服务器。
您可以使用远程执行或手动完成内容源更改。要使用远程执行更新主机上的配置,请点 Run job invocation。有关运行远程执行作业的更多信息,请参阅 配置和设置远程作业。要手动更新内容源,请从主机上的 更改内容源 执行自动生成的命令。
2.14. 更改主机的环境 复制链接链接已复制到粘贴板!
使用这个流程更改主机的环境。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Content view details 卡中的垂直 ellipsis,然后选择 Edit content view assignment。
- 选择环境。
- 选择内容视图。
- 点击 Save。
2.15. 更改主机的受管状态 复制链接链接已复制到粘贴板!
Satellite 置备的主机默认为 Managed。当主机设置为 Managed 时,您可以从 Satellite 服务器配置额外的主机参数。这些附加参数在 Operating System 标签页中列出。如果您更改了 Operating System 选项卡上的任何设置,则在将主机设置为构建并重新引导它后才会生效。
如果您需要使用 Satellite 不支持的操作系统获取系统的配置管理报告,请将主机设置为 Unmanaged。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Edit。
- 点 Manage host 或 Unmanage host 来更改主机的状态。
- 点 Submit。
2.16. 在主机上启用 Tracer 复制链接链接已复制到粘贴板!
使用这个流程在 Satellite 上启用 Tracer 并访问 Traces。tracer 显示需要重启的服务和应用程序列表。trace 是 Satellite Web UI 中 tracer 生成的输出。
先决条件
- 用于主机的操作系统的 Red Hat Satellite Client 6 存储库已同步到 Satellite 服务器上,可在内容视图和主机的生命周期环境中同步,并为主机启用。如需更多信息,请参阅管理内容 中的更改 Satellite 中的主机存储库设置 状态 。
- 远程执行已启用。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 在 Traces 选项卡上,点 Enable Traces。
-
从列表中选择
katello-host-tools-tracer。 - 点 Enable Tracer。在远程执行作业完成后,您会收到 REX 作业通知。
2.17. 在主机上重启应用程序 复制链接链接已复制到粘贴板!
使用这个流程从 Satellite Web UI 重启应用程序。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 选择 Traces 选项卡。
- 选择您要重启的应用程序。
- 从 Restart app 列表中选择 Restart via remote execution。完成远程执行作业后,您将收到 REX 作业通知。
2.18. 将主机分配给特定机构 复制链接链接已复制到粘贴板!
使用这个流程将主机分配给特定的机构。有关机构的一般信息以及如何配置它们,请参阅管理 Red Hat Satellite 中的管理机构。
如果您的主机已经注册到不同的机构,您必须首先取消注册该主机,然后才能将其分配给新机构。要取消主机注册,请在主机上运行 subscription-manager unregister。将主机分配给新机构后,您可以重新注册主机。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选中您要更改的主机的复选框。
- 在 Select Action 列表中,选择 Assign Organization。此时会打开一个新选项窗口。
在 Select Organization 列表中,选择要将主机分配到的组织。选中 Mismatch 上修复组织的复选框。
注意如果存在与主机关联的资源(如域或子网),并且同时没有与您要为其分配主机的机构关联,则会出现不匹配。Mismatch 上的选项 Fix Organization 将向机构添加此类资源,因此是推荐的选择。Mismatch 选项 Fail 将始终产生 错误消息。例如,将主机从一个机构重新分配给另一个机构将失败,即使设置中没有实际不匹配。
- 点 Submit。
2.19. 将主机分配到特定位置 复制链接链接已复制到粘贴板!
使用这个流程将主机分配给特定位置。有关位置以及如何配置它们的常规信息,请参阅 管理内容 中的 创建位置。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选中您要更改的主机的复选框。
- 从 Select Action 列表中,选择 Assign Location。此时会打开一个新选项窗口。
导航到 Select Location 列表,再选择您要用于您的主机的位置。选中 Fix Location on Mismatch 的复选框。
注意如果存在与主机关联的资源(如域或子网),并且同时没有与要为其分配主机的位置关联,则会出现不匹配。选项 Fix Location on Mismatch 将添加此类资源到位置,因此是推荐的选择。Mismatch 选项 Fail 将始终产生 错误消息。例如,将主机从一个位置重新分配给另一个位置将失败,即使设置中没有实际不匹配。
- 点 Submit。
2.20. 在主机间切换 复制链接链接已复制到粘贴板!
当您在 Satellite Web UI 中的特定主机上时,您可以使用主机切换器在主机之间导航,而无需离开该页面。点 主机名旁边的 criu。这会按字母顺序显示主机列表,以及分页箭头和搜索栏来查找您要查找的主机。
2.21. 从内容主机查看主机详情 复制链接链接已复制到粘贴板!
使用这个流程查看内容主机中的主机详情页面。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Content Hosts
- 单击您要查看的内容主机。
- 选择 Details 选项卡来查看主机详情页面。
Details 选项卡中的卡显示 系统属性、BIOS、网络接口、操作系统、配置模板 和置备 的详细信息。注册的内容主机显示用于注册 详情、安装产品和 HW 属性 的其他卡,提供有关 模型、CPU 数、 插槽、每个插槽和 RAM 的信息。
2.22. 选择主机列 复制链接链接已复制到粘贴板!
您可以在 Hosts > All Hosts 页面上的主机表中选择要看到哪些列。报告的数据类别下 的列 (如 Disk Space、BIOS vendor 和 RAM )会根据主机配置管理或系统库存工具中的可用事实填充。订阅管理器不报告磁盘空间。要填充此数据,主机必须配置为通过包含此信息的工具来报告事实,如 Ansible 或 Puppet。有关主机列的完整列表,请参阅 附录 D, 主机列概述。
无法取消选择 Name 列。Name 列充当主机的主要标识方法。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 点 Manage 列。
选择您要显示的列。您可以选择单独的列或列类别。选择或取消选择类别选择或取消选择该类别中的所有列。
注意有些列包含在多个类别中,但您可以只显示一次特定类型的列。通过选择或取消选择特定列,您可以选择或取消选择该列的所有实例。
验证
- 现在,您可以在主机表中看到所选列。
2.23. 从 Satellite 中删除主机 复制链接链接已复制到粘贴板!
使用这个流程从 Satellite 中删除主机。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 或 Hosts > Content Hosts。请注意,从 All Hosts 或 Content Hosts 中删除主机的页面没有区别。在这两种情况下,Satellite 都会完全删除主机。
- 选择您要删除的主机。
- 在 Select Action 列表中,选择 Delete Hosts。
- 单击 Submit,以从 Satellite 永久删除主机。
默认情况下,主机删除设置上的 Destroy 关联的虚拟机被设置为 no。如果删除了与虚拟机关联的主机记录,虚拟机将保留在计算资源中。
要删除计算资源上的虚拟机,请进入到 Administer > Settings 并选择 Provisioning 选项卡。如果删除了与虚拟机关联的主机记录,将 host delete 上的 Destroy 关联的 VM 设置为 yes 会删除虚拟机。为了避免在这种情况下删除虚拟机,请将虚拟机从 Satellite 解除关联,而无需将其从计算资源中删除或更改设置。
CLI 过程
从 Satellite 中删除您的主机:
hammer host delete \ --id My_Host_ID \ --location-id My_Location_ID \ --organization-id My_Organization_ID
$ hammer host delete \ --id My_Host_ID \ --location-id My_Location_ID \ --organization-id My_Organization_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 或者,您可以使用
--name My_Host_Name而不是--id My_Host_ID。
2.23.1. 将虚拟机与 Satellite 解除关联,而无需将其从 Hypervisor 中删除 复制链接链接已复制到粘贴板!
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选中您要解除关联的主机左侧的复选框。
- 在 Select Action 列表中,单击 Disassociate Hosts。
- 可选:选择复选框以保持主机进行将来的操作。
- 点 Submit。
第 3 章 注册主机和设置主机集成 复制链接链接已复制到粘贴板!
您必须注册尚未通过 Satellite 置备的主机,以便使用 Satellite 管理它们。您可以通过 Satellite 服务器或 Capsule 服务器注册主机。
请注意,基于权利的订阅模型已弃用,并将在以后的发行版本中删除。红帽建议您改用简单内容访问的基于访问的订阅服务。
您还必须在主机上安装和配置工具,具体取决于您要使用的集成功能。使用以下步骤安装和配置主机工具:
3.1. 注册中支持的客户端 复制链接链接已复制到粘贴板!
Satellite 支持以下用于注册的操作系统和架构:
- 支持的主机操作系统
主机可以使用以下操作系统:
- Red Hat Enterprise Linux 9, 8, 7
- 带有 ELS 附加组件的 Red Hat Enterprise Linux 6
您可以注册以下主机以转换为 RHEL:
- CentOS Linux 7
- Oracle Linux 7 和 8
- 支持的主机架构
主机可以使用以下架构:
- i386
- x86_64
- s390x
- ppc_64
3.2. 注册方法 复制链接链接已复制到粘贴板!
您可以使用以下方法将主机注册到 Satellite:
- 全局注册
您可以从 Satellite 生成
curl命令,并从无限数量的主机运行这个命令,以通过 Satellite API 使用置备模板注册它们。如需更多信息,请参阅 第 3.3 节 “使用全局注册注册主机”。通过使用此方法,您还可以在注册到 Satellite 的过程中将 Satellite SSH 密钥部署到主机,以便为远程执行作业启用主机。如需更多信息,请参阅 第 12 章 配置和设置远程作业。
通过使用此方法,您还可以在注册到 Satellite 的过程中使用 Red Hat Insights 配置主机。如需更多信息,请参阅 第 9 章 使用 Red Hat Insights 监控主机。
- (已弃用) Katello CA Consumer
-
您可以从
satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm下载并安装使用者 RPM,然后运行subscription-manager。 - (已弃用) Bootstrap 脚本
-
您可以从主机上的
satellite.example.com/pub/bootstrap.py下载 bootstrap 脚本,然后运行该脚本。如需更多信息,请参阅 第 3.4 节 “使用启动脚本注册主机”。
3.3. 使用全局注册注册主机 复制链接链接已复制到粘贴板!
您可以通过在 Satellite 上生成 curl 命令并在主机上运行此命令,将主机注册到 Satellite。此方法使用两个置备模板: Global Registration template 和 Linux host_init_config 默认模板。这样,您可以完全控制主机注册过程。
如果需要更大的灵活性,您还可以自定义默认模板。如需更多信息,请参阅 第 3.3.3 节 “自定义注册模板”。
3.3.1. 用于注册的全局参数 复制链接链接已复制到粘贴板!
您可以通过进入到 Configure > Global Parameters 来配置以下全局参数:
-
host_registration_insights参数在insights代码段中使用。如果参数设为true,则注册会在主机上安装并启用 Red Hat Insights 客户端。如果 参数设置为false,它会防止 Satellite 和 Red Hat Insights 客户端将清单报告上传到 Red Hat Hybrid Cloud Console。默认值为true。在覆盖参数值时,将参数类型设置为布尔值。 -
host_packages参数用于在主机上安装软件包。 -
host_registration_remote_execution参数在remote_execution_ssh_keys代码段中使用。如果设置为true,则注册会在主机上启用远程执行。默认值为true。 -
remote_execution_ssh_keys,remote_execution_ssh_user,remote_execution_create_user, 和remote_execution_effective_user_method参数在remote_execution_ssh_keys代码片段中使用。如需了解更多详细信息,请参阅代码片段。
您可以通过 Hosts > Templates > Provisioning Templates 进入 Satellite web UI 中的代码片段。
3.3.2. 注册主机 复制链接链接已复制到粘贴板!
您可以使用注册模板注册主机,并在注册过程中设置各种集成功能和主机工具。
先决条件
- 您的 Satellite 帐户已分配有 Register hosts 角色,或者分配有等效权限的角色。
- 您必须在要注册的主机上具有 root 权限。
- Satellite 服务器、任何胶囊服务器和所有主机都必须与相同的 NTP 服务器同步,并且启用和运行时间同步工具。
- 主机必须使用激活码。如需更多信息,请参阅管理内容中的管理激活码。
-
可选:如果要将主机注册到 Red Hat Insights,您必须同步
rhel-8-for-x86_64-baseos-rpms和rhel-8-for-x86_64-appstream-rpms存储库,并在您使用的激活码中提供它们。这是在主机上安装insights-client软件包所必需的。 - 用于主机的操作系统的 Red Hat Satellite Client 6 存储库在 Satellite 服务器上同步,并在您使用的激活码中启用。如需更多信息,请参阅 管理内容 中的 导入内容。远程执行拉取客户端、Puppet 代理、跟踪器和其他工具需要此存储库。
- 如果要使用 Capsule 服务器而不是 Satellite 服务器,请确保已相应地配置了 Capsule 服务器。如需更多信息,请参阅 安装 Capsule 服务器 中的 为主机注册配置 Capsule 和置备。
- 如果您的 Satellite 服务器或 Capsule 服务器位于 HTTP 代理后面,请将主机上的订阅管理器配置为使用 HTTP 代理进行连接。如需更多信息,请参阅红帽知识库中的 如何通过防火墙或代理访问 Red Hat Subscription Manager (RHSM)。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Register Host。
- 可选:选择不同的 机构。
- 可选: 选择不同的位置。
可选:在 Host Group 列表中选择要关联主机的主机组。从 Host group 继承值的字段:操作系统、激活码 和 生命周期环境。
如果您的主机组分配了任何 Ansible 角色,则 Ansible 角色将在注册后在主机上运行。
- 可选: 在 Operating system 列表中,选择您要注册的主机的操作系统。
可选:在 Capsule 列表中,选择 Capsule 来注册主机。
注意负载平衡器后面的胶囊优先于 Satellite Web UI 中选择的胶囊作为主机的内容源。
- 在 Activation Keys 字段中,输入一个或多个要分配给主机的激活码。
可选:如果要使第一个调用不安全,请选择 Insecure 选项。在此第一次调用期间,主机从 Satellite 下载 CA 文件。主机将使用此 CA 文件与以后进行安全的所有调用连接到 Satellite。
红帽建议您避免不安全的调用。
如果攻击者位于 Satellite 和主机之间的网络中,从第一个不安全的调用中获取 CA 文件,攻击者可以从注册的主机和 JSON Web 令牌(JWT)访问 API 调用的内容。因此,如果您选择在注册过程中部署 SSH 密钥,攻击者可以使用 SSH 密钥访问主机。
相反,您可以在注册主机前手动复制并安装 CA 文件。
要做到这一点,找到 Satellite 在哪里通过进入到 Administer > Settings > Authentication 并查找 SSL CA file 设置的值来保存 CA 文件。
将 CA 文件复制到主机上的
/etc/pki/ca-trust/source/anchors/目录中,并输入以下命令:update-ca-trust enable update-ca-trust
# update-ca-trust enable # update-ca-trustCopy to Clipboard Copied! Toggle word wrap Toggle overflow 然后,使用安全
curl命令注册主机,例如:curl -sS https://satellite.example.com/register ...
# curl -sS https://satellite.example.com/register ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下是带有
--insecure选项的curl命令示例:curl -sS --insecure https://satellite.example.com/register ...
# curl -sS --insecure https://satellite.example.com/register ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 选择 Advanced 选项卡。
可选:在 Setup REX 列表中,选择是否要将 Satellite SSH 密钥部署到主机。
如果设置为
Yes,则将在注册的主机上安装公共 SSH 密钥。继承的值基于host_registration_remote_execution参数。它可以继承,例如从主机组、操作系统或组织继承。覆盖后,所选值将存储在主机参数级别上。可选:在 Setup Insights 列表中,选择是否要安装
insights-client并将主机注册到 Insights。Insights 工具仅适用于 Red Hat Enterprise Linux。它对其他操作系统没有影响。
您必须在注册的机器上启用以下软件仓库:
-
Red Hat Enterprise Linux 6:
rhel-6-server-rpms -
Red Hat Enterprise Linux 7:
rhel-7-server-rpms Red Hat Enterprise Linux 8:
rhel-8-for-x86_64-appstream-rpmsinsights-client软件包默认安装在 Red Hat Enterprise Linux 8 上,除非使用 "Minimal Install" 选项部署 Red Hat Enterprise Linux 8 的环境中。
-
Red Hat Enterprise Linux 6:
-
可选:在 Install packages 字段中,列出您要在注册时在主机上安装的软件包(与空格分开)。这可以通过
host_packages参数设置。 -
可选: 选择 Update packages 选项,在注册时更新主机上的所有软件包。这可以通过
host_update_packages参数设置。 -
可选:在 Repository 字段中,输入要在执行注册前添加的存储库。例如,使
subscription-manager软件包可供注册使用。对于红帽系列分发,请输入存储库的 URL,例如http://rpm.example.com/。 - 可选:在 Repository GPG key URL 字段中,指定验证 GPG 签名软件包签名的公钥。它需要在 ASCII 表单中使用 GPG 公钥标头指定。
可选:在 Token 生命周期(小时) 字段中,更改 Satellite 用于身份验证的 JSON Web Token (JWT)的有效性持续时间。此令牌的持续时间定义生成的
curl命令的工作方式。您可以将持续时间设置为 0 – 999 999 小时,或没有限制。请注意,Satellite 应用生成
curl命令授权的用户的权限。如果用户丢失或获得额外权限,则 JWT 的权限也会改变。因此,不要在令牌期间删除、阻止或更改用户的权限。JWT 的范围仅限于注册端点,不能在任何其他地方使用。
- 可选:在 Remote Execution Interface 字段中输入主机必须用于 SSH 连接的网络接口的标识符。如果将此字段留空,Satellite 将使用默认网络接口。
可选:从 REX pull 模式 列表中,选择是否要部署 Satellite 远程执行 pull 客户端。
如果设置为
Yes,则将在注册的主机上安装远程执行 pull 客户端。继承的值基于host_registration_remote_execution_pull参数。它可以继承,例如从主机组、操作系统或组织继承。覆盖后,所选值存储在主机参数级别上。注册的主机必须有权访问 Red Hat Satellite Client 6 存储库。
有关 pull 模式的更多信息,请参阅 第 12.4 节 “远程执行的传输模式”。
- 可选:选择 Lifecycle 环境。
- 可选:如果要忽略订阅管理器 错误,请选择 Ignore 错误。
-
可选:如果要在注册前删除任何
katello-ca-consumerrpms,选择 Force 选项,并运行带有--force参数的subscription-manager。 - 点 Generate。
-
复制生成的
curl命令。 -
在您要注册的主机上,以
root用户身份运行curl命令。
CLI 过程
-
使用
hammer host-registration generate-command生成curl命令以注册主机。 -
在您要注册的主机上,以
root用户身份运行curl命令。
如需更多信息,请参阅使用 hammer host-registration generate-command --help 的 Hammer CLI 帮助。
Ansible 流程
-
使用
redhat.satellite.registration_command模块。
如需更多信息,请参阅 ansible-doc redhat.satellite.registration_command 的 Ansible 模块文档。
API 流程
-
使用
POST /api/registration_commands资源。
如需更多信息,请参阅 https://satellite.example.com/apidoc/v2.html 的完整 API 参考。
3.3.3. 自定义注册模板 复制链接链接已复制到粘贴板!
您可以通过编辑置备模板来自定义注册过程。请注意,Satellite 中的所有默认模板都会被锁定。如果要自定义注册模板,您必须克隆默认模板并编辑克隆。
红帽只提供对原始未编辑的模板的支持。自定义模板不会收到红帽发布的更新。
注册过程使用以下置备模板:
-
Global Registration 模板包含将主机注册到 Satellite 的步骤。此模板会在主机访问
/registerSatellite API 端点时呈现。 - Linux host_init_config 默认模板 包含主机注册后初始配置的步骤。
流程
- 导航到 Hosts > Templates > Provisioning Templates。
- 搜索您要编辑的模板。
- 在所需模板的行中,单击 Clone。
- 根据需要编辑模板。如需更多信息,请参阅 附录 B, 模板编写参考。
- 点 Submit。
- 导航到 Administer > Settings > Provisioning。
根据需要更改以下设置:
- 将 Default Global registration template 设置指向您的自定义全局注册模板,
- 将 Default 'Host initial configuration' 模板 设置为您的自定义初始配置模板。
3.4. 使用启动脚本注册主机 复制链接链接已复制到粘贴板!
您可以使用 bootstrap 脚本自动执行内容注册和 Puppet 配置。
bootstrap 脚本是一个已弃用的功能。弃用的功能仍然包含在 Satellite 中,并被支持。但是,它将在以后的发行版本中删除,且不建议在新的部署中使用。
使用 第 3.3 节 “使用全局注册注册主机” 替代。
有关 Satellite 中已弃用或删除的主要功能的最新列表,请参阅 Satellite 发行注记中的已弃用功能 部分。
您可以使用 bootstrap 脚本注册新主机,或者从 RHN、SAM、XXX 或其他 Red Hat Satellite 实例迁移现有主机。
katello-client-bootstrap 软件包默认安装在 Satellite 服务器的基本操作系统上。bootstrap.py 脚本安装在 /var/www/html/pub/ 目录中,使其可用于 satellite.example.com/pub/bootstrap.py 上的主机。该脚本包含 /usr/share/doc/katello-client-bootstrap-版本/README.md 文件中的文档。
要使用 bootstrap 脚本,您必须在主机上安装它。由于脚本只需要一次,而仅适用于 root 用户,您可以将其放在 /root 或 /usr/local/sbin 中,并在使用后将其删除。这个过程使用 /root。
先决条件
-
您有一个 Satellite 用户,具有运行 bootstrap 脚本所需的权限。此流程中的示例指定
admin用户。如果您的安全策略无法接受,请创建一个具有最低权限的新角色,并将其添加到将运行脚本的用户。更多信息请参阅 第 3.4.1 节 “为启动脚本设置权限”。 - 您有启用了 Red Hat Satellite Client 6 存储库的主机的激活码。有关配置激活码的详情,请参考 管理内容 中的 管理 激活码。
- 您已创建了主机组。有关创建主机组的详情请参考 第 2.8 节 “创建主机组”。
Puppet 注意事项
如果主机组与一个生产环境中创建的 Puppet 环境关联,则 Puppet 在从该主机组注册主机时无法检索 Puppet CA 证书。
要创建与主机组关联的适当 Puppet 环境,请按照以下步骤操作:
手动创建目录:
mkdir /etc/puppetlabs/code/environments/example_environment
# mkdir /etc/puppetlabs/code/environments/example_environmentCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Configure > Environments,再点 Import environment from。按钮名称包括内部或外部胶囊的 FQDN。
- 选择创建的目录,再单击 更新。
流程
-
以
root用户身份登录主机。 下载脚本:
curl -O http://satellite.example.com/pub/bootstrap.py
# curl -O http://satellite.example.com/pub/bootstrap.pyCopy to Clipboard Copied! Toggle word wrap Toggle overflow 使脚本可执行:
chmod +x bootstrap.py
# chmod +x bootstrap.pyCopy to Clipboard Copied! Toggle word wrap Toggle overflow 通过查看帮助文本确认脚本可以执行:
在 Red Hat Enterprise Linux 8 中:
/usr/libexec/platform-python bootstrap.py -h
# /usr/libexec/platform-python bootstrap.py -hCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在其他 Red Hat Enterprise Linux 版本中:
./bootstrap.py -h
# ./bootstrap.py -hCopy to Clipboard Copied! Toggle word wrap Toggle overflow
输入适合您环境的 bootstrap 命令。
对于
--server选项,指定 Satellite 服务器的 FQDN 或 Capsule 服务器。对于--location、--organization和--hostgroup选项,使用带引号的名称,而不是标签,作为选项的参数。有关高级用例,请参阅 第 3.4.2 节 “高级启动脚本配置”。在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
输入您使用
--login选项指定的 Satellite 用户的密码。脚本将进度通知发送到 stdout。
-
在脚本提示时,批准主机的 Puppet 证书。在 Satellite Web UI 中,进入到 Infrastructure > Capsules 并找到您使用
--server选项指定的 Satellite 或 Capsule 服务器。 - 从 Actions 列中的列表中,选择 证书。
- 在 Actions 列中,单击 Sign 以批准主机的 Puppet 证书。
- 返回到主机,以查看 bootstrap 过程的其余部分完成。
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,并确保主机连接到正确的主机组。
可选:主机注册完成后,删除脚本:
rm bootstrap.py
# rm bootstrap.pyCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.1. 为启动脚本设置权限 复制链接链接已复制到粘贴板!
使用这个流程配置 Satellite 用户,并带有运行 bootstrap 脚本所需的权限。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,进入到 Administer > Users。
- 点所需的用户名来选择现有用户。此时将打开一个新窗格,其中包含有关所选用户的信息的选项卡。或者,为运行此脚本的目的创建一个新用户。
- 点 Roles 选项卡。
从 Roles 列表中选择 Edit hosts 和 Viewer。
重要Edit hosts 角色允许用户编辑和删除主机,并能够添加主机。如果您的安全策略无法接受,请创建一个具有以下权限的新角色,并将其分配给用户:
-
view_organizations -
view_locations -
view_domains -
view_hostgroups -
view_hosts -
view_architectures -
view_ptables -
view_operatingsystems -
create_hosts
-
- 点 Submit。
CLI 过程
创建具有 bootstrap 脚本所需的最小权限的角色。本例创建一个名为 Bootstrap 的角色:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 为现有用户分配新角色:
hammer user add-role --id user_id --role Bootstrap
# hammer user add-role --id user_id --role BootstrapCopy to Clipboard Copied! Toggle word wrap Toggle overflow 或者,您也可以创建新用户,并为他们分配这个新角色。有关使用 Hammer 创建用户的更多信息,请参阅管理 Red Hat Satellite 中的管理用户和角色 。
3.4.2. 高级启动脚本配置 复制链接链接已复制到粘贴板!
本节提供了使用 bootstrap 脚本注册或迁移主机的更多示例。
这些示例指定 admin Satellite 用户。如果您的安全策略无法接受,请创建一个具有 bootstrap 脚本所需最低权限的新角色。更多信息请参阅 第 3.4.1 节 “为启动脚本设置权限”。
3.4.2.1. 将主机从一个 Satellite 迁移到另一个 Satellite 复制链接链接已复制到粘贴板!
使用带有 --force 的脚本从旧的 Satellite 中删除 katello-ca-consumer jpeg 软件包,并在新的 Satellite 上安装 katello-ca-consumer jpeg 软件包。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
启动脚本检测到 /etc/syconfig/rhn/systemid 和与 RHN 的有效连接,作为系统注册到传统平台的指示。然后,该脚本会调用 rhn-classic-migrate-to-rhsm 从 RHN 迁移系统。默认情况下,由于审计原因,该脚本不会删除系统的旧配置集。要删除传统配置文件,请使用 --legacy-purge,并使用 --legacy-login 提供具有适当权限来删除配置集的用户帐户。提示时输入用户帐户密码。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.3. 在没有 Puppet 的情况下将主机注册到 Satellite 复制链接链接已复制到粘贴板!
默认情况下,bootstrap 脚本配置主机以进行内容管理和配置管理。如果您有现有的配置管理系统,且不想在主机上安装 Puppet,请使用 --skip-puppet。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.4. 仅将主机注册到 Satellite 以进行内容管理 复制链接链接已复制到粘贴板!
要将系统注册为内容主机,并省略了调配和配置管理功能,请使用 --skip-foreman。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
/usr/libexec/platform-python bootstrap.py \ --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foreman
# /usr/libexec/platform-python bootstrap.py \ --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
bootstrap.py --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foreman
# bootstrap.py --server satellite.example.com \ --organization="My_Organization" \ --activationkey="My_Activation_Key" \ --skip-foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.5. 更改引导脚本用来下载 Consumer RPM 的方法 复制链接链接已复制到粘贴板!
默认情况下,bootstrap 脚本使用 HTTP 从 http://satellite.example.com/pub/katello-ca-consumer-latest.noarch.rpm 下载使用者 RPM。在某些环境中,您可能想要仅在主机和 Satellite 之间允许 HTTPS。使用 --download-method 将下载方法从 HTTP 更改为 HTTPS。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.6. 为 Satellite 提供主机的 IP 地址 复制链接链接已复制到粘贴板!
在一个接口上有多个接口或多个 IP 地址的主机上,您可能需要覆盖 IP 地址的自动检测,并为 Satellite 提供特定的 IP 地址。使用 --ip。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.7. 在主机上启用远程执行 复制链接链接已复制到粘贴板!
使用 --rex 和 --rex-user 启用远程执行,并为指定用户添加所需的 SSH 密钥。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.8. 在注册过程中为主机创建域 复制链接链接已复制到粘贴板!
要创建主机记录,在运行脚本之前,主机的 DNS 域需要存在于 Satellite 中。如果域不存在,请使用 --add-domain 添加它。
流程
在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.4.2.9. 为主机提供替代 FQDN 复制链接链接已复制到粘贴板!
如果主机名不是 FQDN,或者与 RFC 兼容(包含下划线等字符),则脚本会在主机名验证阶段失败。如果无法将主机更新为使用 Satellite 接受的 FQDN,您可以使用 bootstrap 脚本指定替代 FQDN。
流程
使用 Hammer 将
create_new_host_when_facts_are_uploaded和create_new_host_when_report_is_uploaded设置为 false :Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用
--fqdn指定将报告给 Satellite 的 FQDN:在 Red Hat Enterprise Linux 8 中输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 6 或 7 中,输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5. 安装 Katello 代理 复制链接链接已复制到粘贴板!
您可以安装 Katello 代理来远程更新 Satellite 客户端。
Katello 代理已弃用,并将在以后的 Satellite 版本中删除。迁移进程以使用远程执行功能远程更新客户端。如需更多信息,请参阅管理主机中的 从 Katello Agent 迁移到远程执行。
katello-agent 软件包依赖于 gofer 软件包,它提供了 goferd 服务。
先决条件
- 您已在 Satellite 服务器上启用了 Red Hat Satellite Client 6 存储库。如需更多信息,请参阅 在 连接的网络环境中安装 Satellite 服务器中的启用 Red Hat Satellite Client 6 仓库。
- 您已在 Satellite 服务器上同步了 Red Hat Satellite Client 6 存储库。如需更多信息,请参阅 在 连接的网络环境中安装 Satellite 服务器中的同步 Red Hat Satellite Client 6 仓库。
- 您已在客户端上启用了 Red Hat Satellite Client 6 存储库。
流程
安装
katello-agent软件包:dnf install katello-agent
# dnf install katello-agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow 启动
goferd服务:systemctl start goferd
# systemctl start goferdCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.6. 安装 Tracer 复制链接链接已复制到粘贴板!
使用这个流程在 Red Hat Satellite 上安装 Tracer 并访问 Traces。tracer 显示已过时且需要重启的服务和应用程序列表。trace 是 Satellite Web UI 中 tracer 生成的输出。
先决条件
- 主机注册到 Red Hat Satellite。
- 用于主机的操作系统的 Red Hat Satellite Client 6 存储库已同步到 Satellite 服务器上,可在内容视图和主机的生命周期环境中同步,并为主机启用。如需更多信息,请参阅管理内容 中的更改 Satellite 中的主机存储库设置 状态 。
流程
在内容主机上安装
katello-host-tools-tracerRPM 软件包:yum install katello-host-tools-tracer
# yum install katello-host-tools-tracerCopy to Clipboard Copied! Toggle word wrap Toggle overflow 输入以下命令:
katello-tracer-upload
# katello-tracer-uploadCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Hosts > All Hosts,然后点所需的主机名。
- 点 Traces 选项卡查看 Traces。如果没有安装,则 Enable Traces 按钮将启动安装软件包的远程执行作业。
3.7. 在主机注册过程中安装和配置 Puppet 代理 复制链接链接已复制到粘贴板!
您可以在注册过程中在主机上安装和配置 Puppet 代理。主机上需要配置了 Puppet 代理,以便 Puppet 与您的 Satellite 集成。有关 Puppet 的更多信息,请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置。
先决条件
- Puppet 必须在您的 Satellite 中启用。如需更多信息,请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置中的启用 Puppet 与 Satellite 集成。
- 用于主机的操作系统的 Red Hat Satellite Client 6 存储库在 Satellite 服务器上同步,并在您使用的激活码中启用。如需更多信息,请参阅 管理内容 中的 导入内容。
- 您有一个激活码。如需更多信息,请参阅管理内容中的管理激活码。
流程
- 在 Satellite Web UI 中,进入到 Configure > Global Parameters 以全局添加主机参数。或者,您可以进入到 Configure > Host Groups 并编辑或创建主机组,来仅将主机参数添加到主机组中。
-
使用全局参数或主机组中的 host 参数启用 Puppet 代理。添加名为
enable-puppet7的主机参数,选择 boolean 类型,然后将值设为true。 在全局参数或主机组中使用以下主机参数为 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 服务器。
-
添加名为
- 进入到 Hosts > Register Host,并使用适当的激活码注册您的主机。如需更多信息, 请参阅管理主机中的 注册主机。
- 进入到 Infrastructure > Capsules。
- 从所需胶囊服务器的 Actions 列中的列表中,选择 Certificates。
- 单击所需主机右侧的 Sign,为 Puppet 代理签署 SSL 证书。
3.8. 手动安装和配置 Puppet 代理 复制链接链接已复制到粘贴板!
您可以在主机上手动安装和配置 Puppet 代理。主机上需要配置了 Puppet 代理,以便 Puppet 与您的 Satellite 集成。有关 Puppet 的更多信息,请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置。
先决条件
- Puppet 必须在您的 Satellite 中启用。如需更多信息,请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置中的启用 Puppet 与 Satellite 集成。
- 主机必须分配有 Puppet 环境。
- 用于主机的操作系统的 Red Hat Satellite Client 6 存储库已同步到 Satellite 服务器上,可在内容视图和主机的生命周期环境中同步,并为主机启用。如需更多信息,请参阅管理内容 中的更改 Satellite 中的主机存储库设置 状态 。
步骤
-
以
root用户身份登录主机。 安装 Puppet 代理软件包。
在运行 Red Hat Enterprise Linux 8 及更高版本的主机上:
dnf install puppet-agent
# dnf install puppet-agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在运行 Red Hat Enterprise Linux 7 及更早版本的主机上:
yum install puppet-agent
# yum install puppet-agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow
使用以下脚本,将 Puppet 代理添加到当前 shell 中的
PATH中:. /etc/profile.d/puppet-agent.sh
. /etc/profile.d/puppet-agent.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow 配置 Puppet 代理。将
environment参数设置为主机所属的 Puppet 环境的名称:puppet config set server satellite.example.com --section agent puppet config set environment My_Puppet_Environment --section agent
# puppet config set server satellite.example.com --section agent # puppet config set environment My_Puppet_Environment --section agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow 启动 Puppet 代理服务:
puppet resource service puppet ensure=running enable=true
# puppet resource service puppet ensure=running enable=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow 为主机创建证书:
puppet ssl bootstrap
# puppet ssl bootstrapCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Infrastructure > Capsules。
- 从所需胶囊服务器的 Actions 列中的列表中,选择 Certificates。
- 单击所需主机右侧的 Sign,为 Puppet 代理签署 SSL 证书。
在主机上再次运行 Puppet 代理:
puppet ssl bootstrap
# puppet ssl bootstrapCopy to Clipboard Copied! Toggle word wrap Toggle overflow
3.9. 在主机注册过程中运行 Ansible 角色 复制链接链接已复制到粘贴板!
在将主机注册到 Satellite 时,您可以运行 Ansible 角色。
先决条件
- 所需的 Ansible 角色已从 Capsule 导入到 Satellite。如需更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的 导入 Ansible 角色和变量。
流程
- 使用 Ansible 角色创建主机组。如需更多信息,请参阅 第 2.8 节 “创建主机组”。
- 使用主机组和分配的 Ansible 角色注册主机。如需更多信息,请参阅 第 3.3.2 节 “注册主机”。
第 4 章 将主机从 Katello Agent 迁移到远程执行 复制链接链接已复制到粘贴板!
远程执行 是管理主机上软件包内容的首选方法。Katello Agent 已被弃用,并将在以后的 Satellite 版本中删除。按照以下步骤切换到远程执行。
先决条件
- 您已在 Satellite 服务器上启用了 Red Hat Satellite Client 6 存储库。如需更多信息,请参阅 在 连接的网络环境中安装 Satellite 服务器中的启用 Red Hat Satellite Client 6 仓库。
- 您已在 Satellite 服务器上同步了 Red Hat Satellite Client 6 存储库。如需更多信息,请参阅 在 连接的网络环境中安装 Satellite 服务器中的同步 Red Hat Satellite Client 6 仓库。
-
您之前已在内容主机上安装
katello-agent软件包。
流程
-
如果您将远程执行配置为使用
ssh模式,请将远程执行 SSH 密钥分发到主机。更多信息请参阅 第 12.14 节 “为远程执行分发 SSH 密钥”。 -
如果您将远程执行配置为使用
pull-mqtt模式,请将远程执行 pull 客户端部署到主机。更多信息请参阅 第 12.5 节 “配置主机以使用 Pull 客户端”。 在内容主机上停止 goferd 服务:
systemctl stop goferd
# systemctl stop goferdCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在内容主机上禁用 goferd 服务:
systemctl disable goferd
# systemctl disable goferdCopy to Clipboard Copied! Toggle word wrap Toggle overflow 删除内容主机上的 Katello 代理:
警告如果在 Red Hat Virtualization 版本 4.4 或更高版本上安装了主机,请不要删除
katello-agent软件包,因为删除的依赖项会破坏主机。dnf remove katello-agent
# dnf remove katello-agentCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Administer > Settings。
- 选择内容选项卡。
- 将 Use remote execution 默认 设为 Yes。
Satellite 服务器现在通过远程执行而不是 Katello Agent 使用主机管理。
下表显示了执行等同的远程执行命令,以执行特定的软件包操作。请参阅 hammer job-invocation create --help 以了解如何指定搜索查询来确定目标主机或主机集合。
| 操作 | Katello Agent | 远程执行 |
|---|---|---|
| 安装软件包 |
|
|
| 安装软件包(主机集合) |
|
|
| 删除软件包 |
|
|
| 删除软件包(主机集合) |
|
|
| 更新软件包 |
|
|
| 更新软件包(主机集合) |
|
|
| 更新所有软件包 |
|
|
| 安装勘误 |
|
|
| 安装勘误(主机集合) |
|
|
| 安装软件包组 |
|
|
| 安装软件包组(主机集合) |
|
|
| 删除软件包组 |
|
|
| 删除软件包组(主机集合) |
|
|
| 更新软件包组 |
|
|
| 更新软件包组(主机集合) |
|
|
第 5 章 添加网络接口 复制链接链接已复制到粘贴板!
Satellite 支持为单个主机指定多个网络接口。您可以在创建新主机时配置这些接口,如 第 2.1 节 “在 Red Hat Satellite 中创建主机” 或编辑现有主机时所述。
您可以附加到主机有几种网络接口。在添加新接口时,请选择以下之一:
接口 :允许您指定额外的物理或虚拟接口。您可以创建两种虚拟接口:当主机需要使用单个接口与多个(虚拟)网络通信时,使用 VLAN,而这些网络无法相互访问。使用 alias 为现有接口添加额外的 IP 地址。
有关添加物理接口的详情请参考 第 5.1 节 “添加物理接口”。
有关添加虚拟接口的详情,请参考 第 5.2 节 “添加虚拟接口”。
- 绑定 :创建绑定接口。NIC 绑定是一种将多个网络接口绑定到一个单一接口的方法,该接口显示为单个设备,并有一个 MAC 地址。这可让两个或多个网络接口充当一个,增加带宽并提供冗余。更多信息请参阅 第 5.3 节 “添加绑定接口”。
- BMC: Baseboard Management Controller (BMC)允许您远程监控和管理机器的物理状态。有关 BMC 的更多信息,请参阅在 连接的网络环境中安装 Satellite 服务器中的在受管主机上 启用电源管理。有关配置 BMC 接口的详情,请参考 第 5.5 节 “添加基板管理控制器(BMC)接口”。
其他接口默认启用 Managed 标志,这意味着在由 DNS 和与所选子网关联的 DHCP Capsule 服务器置备过程中自动配置新接口。这需要一个正确配置的 DNS 和 DHCP 胶囊服务器的子网。如果您使用 Kickstart 方法进行主机置备,则会在 /etc/sysconfig/network-scripts/ifcfg-interface_id 的安装后阶段为受管接口自动创建配置文件。
虚拟和绑定接口目前需要物理设备的 MAC 地址。因此,这些接口的配置仅适用于裸机主机。
5.1. 添加物理接口 复制链接链接已复制到粘贴板!
使用这个流程在主机中添加其他物理接口。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 点您要编辑的主机旁的 Edit。
- 在 Interfaces 选项卡中,点 Add Interface。
- 在 Type 列表中选择 Interface 选项。
- 指定 MAC 地址。此设置是必需的。
- 指定 设备标识符,如 eth0。标识符用于在创建绑定接口、VLAN 和别名时指定此物理接口。
- 指定与主机 IP 地址关联的 DNS 名称。Satellite 将此名称保存在与所选域(DNS A"字段)关联的 Capsule 服务器中,以及与所选子网(DNS PTR"字段)关联的 Capsule 服务器。因此,单个主机可以有多个 DNS 条目。
- 从 Domain 列表中选择一个域。要创建和管理域,请导航到 Infrastructure > Domains。
- 从 Subnet 列表中选择一个子网。要创建和管理子网,请导航到 Infrastructure > Subnets。
- 指定 IP 地址。带有分配的 DHCP 胶囊服务器的受管接口需要此设置来创建 DHCP 租期。启用 DHCP 的受管接口会自动提供推荐的 IP 地址。
- 选择接口是否是 Managed。如果管理接口,则在置备过程中从关联的 Capsule 服务器拉取配置,并创建 DNS 和 DHCP 条目。如果使用 kickstart 置备,则会自动为接口创建一个配置文件。
- 选择这是否是主机的主接口。主接口的 DNS 名称用作 FQDN 的主机部分。
- 选择这是否是主机的 Provision 接口。TFTP 引导使用置备接口进行。对于基于镜像的调配,用于完成调配的脚本是通过调配接口执行的。
- 选择是否将接口用于远程执行。
- 保持 虚拟 NIC 复选框清除。
- 单击 OK 以保存接口配置。
- 点 Submit 将更改应用到主机。
5.2. 添加虚拟接口 复制链接链接已复制到粘贴板!
使用这个流程为主机配置虚拟接口。这可以是 VLAN 或别名接口。
别名接口是附加到现有接口的额外 IP 地址。别名接口会自动从它所附加的接口继承 MAC 地址,因此您可以创建别名,而不指定 MAC 地址。接口必须在将引导模式设置为 静态 的子网中指定。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 点您要编辑的主机旁的 Edit。
- 在 Interfaces 选项卡中,点 Add Interface。
- 在 Type 列表中选择 Interface 选项。
指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。
为受管虚拟接口指定 MAC 地址,以便正确生成置备的配置文件。但是,不管理的接口不需要 MAC 地址。
如果创建 VLAN,请在 Device Identifier 字段中指定 eth1.10 格式的 ID。如果创建别名,请使用 eth1:10 格式的 ID。
选中 虚拟 NIC 复选框。其他特定于虚拟接口的配置选项会附加到表单中:
- 标签 :(可选)设置 VLAN 标签,将网络段从物理网络中继到虚拟接口。如果没有指定标签,受管接口将继承关联的子网的 VLAN 标签。此字段中的用户指定的条目不适用于别名接口。
- 连接到 :指定虚拟接口所属的物理接口的标识符,如 eth1。此设置是必需的。
- 单击 OK 以保存接口配置。
- 点 Submit 将更改应用到主机。
5.3. 添加绑定接口 复制链接链接已复制到粘贴板!
使用这个流程为主机配置绑定接口。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 点您要编辑的主机旁的 Edit。
- 在 Interfaces 选项卡中,点 Add Interface。
- 从 Type 列表中选择 Bond。其他特定于类型的配置选项会附加到表单中。
指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。
绑定接口在 Device Identifier 字段中以 bond0 的形式使用 ID。
单个 MAC 地址 就足够了。
如果要添加二级接口,请选择 Managed。否则,Satellite 不会应用配置。
指定特定于绑定接口的配置选项:
- 模式 :选择为容错和负载均衡定义策略的绑定模式。有关每个绑定模式的简短描述,请参阅 第 5.4 节 “Satellite 中可用的绑定模式”。
- 连接的设备 :指定以逗号分隔的附加设备的标识符列表。这些可以是物理接口或 VLAN。
- 绑定选项: 指定以空格分隔的配置选项列表,如 miimon=100。有关绑定接口的配置选项的更多信息,请参阅 Red Hat Enterprise Linux 配置和管理网络 指南中的 配置网络绑定。
- 单击 OK 以保存接口配置。
- 点 Submit 将更改应用到主机。
CLI 过程
要创建带有绑定接口的主机,请输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
5.4. Satellite 中可用的绑定模式 复制链接链接已复制到粘贴板!
| 绑定模式 | 描述 |
|---|---|
| balance-rr | 在每个绑定接口上按顺序接收和发送传输。 |
| active-backup | 通过第一个可用的绑定接口接收和发送传输。只有在活跃绑定接口失败时,才会使用另一个绑定接口。 |
| balance-xor | 传输基于所选的哈希策略。在这个模式中,目标为特定对等点的流量始终通过同一接口发送。 |
| Broadcast | 所有传输都会在所有绑定接口上发送。 |
| 802.a3 | 创建共享相同设置的聚合组。在活动组中的所有接口上传输并接收接收。 |
| balance-tlb | 传出流量会根据每个绑定接口的当前负载进行分发。 |
| balance-alb | 接收负载平衡是通过地址解析协议(ARP)协商来实现的。 |
5.5. 添加基板管理控制器(BMC)接口 复制链接链接已复制到粘贴板!
使用这个流程为支持此功能的主机配置基板管理控制器(BMC)接口。
先决条件
-
ipmitool软件包已安装。 您知道主机上 BMC 接口的 MAC 地址、IP 地址和其他详情,以及该接口的适当凭证。
注意如果管理 BMC 接口,您只需要 BMC 接口的 MAC 地址,以便它能够创建 DHCP 保留。
流程
如果还没有启用,在 Capsule 服务器上启用 BMC:
使用以下选项运行
satellite-installer脚本在 Capsule 服务器上配置 BMC 电源管理:satellite-installer --foreman-proxy-bmc=true \ --foreman-proxy-bmc-default-provider=ipmitool
# satellite-installer --foreman-proxy-bmc=true \ --foreman-proxy-bmc-default-provider=ipmitoolCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Infrastructure > Capsules。
- 从 Actions 列中的列表,单击 Refresh。Features 列中的列表现在应包含 BMC。
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 点您要编辑的主机旁的 Edit。
- 在 Interfaces 选项卡中,点 Add Interface。
- 从 Type 列表中选择 BMC。特定于类型的配置选项会附加到表单中。
- 指定常规接口设置。适用的配置选项与 第 5.1 节 “添加物理接口” 中描述的物理接口相同。
指定特定于 BMC 接口的配置选项:
- 用户名和密码 : 指定 BMC 所需的任何身份验证凭据。
- Provider: 指定 BMC 供应商。
- 单击 OK 以保存接口配置。
- 点 Submit 将更改应用到主机。
第 6 章 将主机升级到 Next Major Red Hat Enterprise Linux 版本 复制链接链接已复制到粘贴板!
您可以使用作业模板将 Red Hat Enterprise Linux 主机升级到下一个主发行版本。以下可能的升级路径是可能的:
- Red Hat Enterprise Linux 7 到 Red Hat Enterprise Linux 8
- Red Hat Enterprise Linux 8 到 Red Hat Enterprise Linux 9
先决条件
确保您的 Red Hat Enterprise Linux 主机满足升级要求。
- 对于 Red Hat Enterprise Linux 7 升级到 Red Hat Enterprise Linux 8,请参阅从 RHEL 7 升级到 RHEL 8中的规划升级。
- 对于 Red Hat Enterprise Linux 8 升级到 Red Hat Enterprise Linux 9,请参阅 从 RHEL 8 升级到 RHEL 9 中的规划升级到 RHEL 9。
准备 Red Hat Enterprise Linux 主机进行升级。
- 对于 Red Hat Enterprise Linux 7 升级到 Red Hat Enterprise Linux 8,请参阅从 RHEL 7 升级到 RHEL 8 中的为升级准备 RHEL 7 系统。
- 对于 Red Hat Enterprise Linux 8 升级到 Red Hat Enterprise Linux 9,请参阅从 RHEL 8 升级到 RHEL 9 中的为升级准备 RHEL 8 系统。
- 在 Satellite 上启用远程执行功能。更多信息请参阅 第 12 章 配置和设置远程作业。
- 将 Satellite SSH 密钥分发到您要升级的主机。更多信息请参阅 第 12.14 节 “为远程执行分发 SSH 密钥”。
流程
在 Satellite 上,启用 Leapp 插件:
satellite-installer --enable-foreman-plugin-leapp
# satellite-installer --enable-foreman-plugin-leappCopy to Clipboard Copied! Toggle word wrap Toggle overflow 如果您使用 Leapp 预升级检查的自定义作业模板,请将 leapp_preupgrade 远程执行功能配置为指向您的模板:
- 在 Satellite Web UI 中,进入到 Administer > Remote Execution Features。
- 点 leapp_preupgrade。
- 在作业模板 下拉菜单中,选择您的模板。
- 点 Submit。
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选择您要升级到下一个主 Red Hat Enterprise Linux 版本的主机。
- 在 Hosts 窗口的右上角,从 Select Action 列表中选择 Preupgrade check with Leapp。
- 输入所需信息并启动预升级检查。
检查完成后,点 Leapp preupgrade report 选项卡查看 Leapp 是否在主机上找到了任何问题。具有 Inhibitor 标志的问题被视为至关重要,并可能会破坏升级过程。具有 Has Remediation 标志的问题包含了可帮助您解决这个问题的补救。
点带有 Has Remediation 标记的问题扩展它。
- 如果问题包含补救 命令,您可以使用远程执行直接从 Satellite 修复它。选择问题。
- 如果问题只包含补救 Hint,使用 hint 来手动修复主机上的问题。
对其他问题重复此步骤。
- 在选择了补救命令中的任何问题后,点 Fix Selected 并提交作业。
- 修复问题后,点 Rerun,然后点 Submit 以再次运行预升级检查,以验证您要升级的主机是否没有任何问题并已准备好升级。
- 如果预升级检查验证主机没有任何问题,点 Run Upgrade 并点 Submit 来启动升级。
- 可选:您还可以在主机详情页面中选择 Schedule a Job 下拉菜单来升级。
第 7 章 将主机转换为 Red Hat Enterprise Linux 复制链接链接已复制到粘贴板!
您可以将 Red Hat Enterprise Linux 派生版本转换为主机上可支持的 Red Hat Enterprise Linux,同时保留已安装的应用程序和配置。Satellite 提供了 Convert2RHEL 工具来简化转换过程。
Satellite 中的 Convert2RHEL 工具包含一个 Ansible 角色和 Ansible playbook。您可以使用 Ansible 角色在 Satellite 服务器上生成转换数据,其中包括启用所需的存储库并创建产品、激活码和主机组。然后,您可以使用 Ansible playbook 在主机上执行实际转换,该 playbook 在主机上安装 Convert2RHEL CLI 工具并运行它。
您可以使用 Ansible 角色为以下转换生成转换数据:
- CentOS Linux 7 到 Red Hat Enterprise Linux 7
- Oracle Linux 7 到 Red Hat Enterprise Linux 7
- Oracle Linux 8 到 Red Hat Enterprise Linux 8
红帽支持这些转换。
转换过程与 Red Hat Enterprise Linux 的次版本升级类似,系统中的每个 RPM 软件包都会被替换。会保留在 Red Hat Enterprise Linux 中未提供的第三方软件包和非红帽软件包。
Convert2RHEL 工具会删除不必要的软件包,如徽标或已知在转换过程中导致问题的软件包。实用程序将 CentOS-release 或 Oracle-release 软件包替换为 rhel-release 软件包,并将 CentOS 或 Oracle 签名的所有软件包替换为其红帽对等软件包。该工具还向 Red Hat Subscription Management 订阅主机。
转换过程的持续时间取决于必须替换的软件包数量、网络速度、存储速度和类似因素。
先决条件
- 请参阅 Red Hat Enterprise Linux 8 中的 支持的转换路径,使用 Convert2RHEL 工具从 Linux 发行版本转换到 RHEL。
确保您有一个上传到 Satellite 的订阅清单,并且为您想要的转换分配了足够的 Red Hat Enterprise Linux 权利。或者,您可以使用 Ansible 变量告知角色从磁盘导入清单。清单必须导入到要转换的主机的机构中。
您可以更新您的分配并 从红帽客户门户网站下载 更新的清单。如需更多信息,请参阅 为连接的 Satellite 服务器创建和管理清单 中的 导出和下载 清单。
- 确保您已在 Satellite 中启用并同步了 Red Hat 仓库,用于将主机转换为的次要 Red Hat Enterprise Linux 版本。如需更多信息 ,请参阅管理内容中的 启用红帽存储库 和 同步存储库。
高级转换步骤
-
导入
redhat.satellite.convert2rhelAnsible 角色和变量。如需更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的 导入 Ansible 角色 和变量。 - 配置 Ansible 变量来生成转换数据。如需更多信息,请参阅 第 7.1 节 “用于转换的 Ansible 变量”。
-
将
redhat.satellite.convert2rhel角色分配给代表 Satellite 服务器的主机。如需更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的 将 Ansible 角色分配给现有主机。 请在 Satellite 服务器上运行 Ansible 角色。如需更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的 在主机上运行 Ansible 角色。
Ansible 角色生成主机转换所需的数据,即存储库、证书、激活密钥和主机组。该角色启用了带有 7Server 版本和 x86_64 架构的
rhel-7-server-rpms存储库,或rhel-8-for-x86_64-baseos-rpms和rhel-8-for-x86_64-appstream-rpms,具体取决于您在前面的步骤中设置的变量。使用生成的主机组注册主机进行转换。
在转换前,使用全局注册模板来注册和订阅您的主机。选择您要为转换生成的主机组,如
CentOS 7 转换(如果从 CentOS 7 转换)。如需更多信息,请参阅 第 3.3 节 “使用全局注册注册主机”。在主机组上运行 pre-conversion 分析,以验证您的主机是否已准备好进行转换。使用以下设置执行远程作业:
-
作业类别 :
Convert 2 RHEL 作业模板 :
Convert2RHEL analyze更多信息请参阅 第 12.22 节 “执行远程作业”。
查看 pre-conversion 分析报告并解决阻塞转换的所有问题。重复此步骤,直到您解决所有阻塞的问题。如需更多信息,请参阅使用 Convert2RHEL 工具从 Linux 发行版本转换到 RHEL 中的查看 Red Hat Enterprise Linux 8 中的 pre-conversion 分析报告 。
-
作业类别 :
在主机组上运行 Convert2RHEL playbook。使用以下设置执行远程作业:
-
作业类别 :
Convert 2 RHEL -
作业模板 :
转换到 RHEL 激活码 :
-
如果您转换为 Red Hat Enterprise Linux 7,
convert2rhel_rhel7 -
如果您转换为 Red Hat Enterprise Linux 8,
convert2rhel_rhel8
-
如果您转换为 Red Hat Enterprise Linux 7,
更多信息请参阅 第 12.22 节 “执行远程作业”。
-
作业类别 :
7.1. 用于转换的 Ansible 变量 复制链接链接已复制到粘贴板!
在运行 Ansible 角色来生成转换数据之前,请配置以下所需 Ansible 变量的值:
Satellite 从 redhat.satellite.convert2rhel 角色导入大多数所需的 Ansible 变量。但是,一些变量不会被导入。这些变量在下表中标有星号 *。您必须手动创建这些额外的变量,并将它们分配给 redhat.satellite.convert2rhel 角色。
| Name | 类型 | 目的和值 |
|---|---|---|
|
| 字符串 |
Satellite 服务器的 URL,如 |
|
| 字符串 | 您的用户名 |
|
| 字符串 | 您的密码 |
|
| 字符串 | 您的机构名称 |
|
| 布尔值 |
如果您不希望 Satellite 服务器在继续生成数据前等待存储库同步完成,则设置为 |
|
| 布尔值 |
如果要在 Ansible 中启用证书检查,设置为 |
|
| 布尔值 |
如果 Satellite 服务器上已有清单,则设置为 |
|
| 布尔值 |
启用 Red Hat Enterprise Linux 7 软件仓库。如果您不打算将主机转换为 Red Hat Enterprise Linux 7,则设置为 |
|
| 布尔值 |
如果您想要为 Oracle Linux 7 准备转换数据,设置为 |
|
| 布尔值 |
启用 Red Hat Enterprise Linux 8 软件仓库。如果您不打算将主机转换为 Red Hat Enterprise Linux 8,则设置为 |
|
| 布尔值 |
如果您想要为 Oracle Linux 8 准备转换数据,设置为 |
| Name | 类型 | 目的和值 |
|---|---|---|
|
| 字符串 |
从磁盘上传的清单路径,如 |
|
| 字符串 |
次版本,如 |
第 8 章 使用 RHEL Web 控制台主机管理和监控 复制链接链接已复制到粘贴板!
RHEL web 控制台是一个交互式 Web 界面,可用于执行操作并监控 Red Hat Enterprise Linux 主机。您可以启用远程执行功能,将 Satellite 与 RHEL web 控制台集成。当您在使用 Satellite 管理的主机上安装 RHEL web 控制台时,您可以在 Satellite web UI 中查看该主机的 RHEL web 控制台仪表板。您还可以使用与 RHEL web 控制台集成的功能,例如 Red Hat Image Builder。
8.1. 在 Satellite 中启用 RHEL Web 控制台 复制链接链接已复制到粘贴板!
默认情况下,RHEL web 控制台集成在 Satellite 中被禁用。如果要从 Satellite 中访问主机的 RHEL web 控制台功能,您必须首先在 Satellite 服务器上启用 RHEL web 控制台集成。
流程
在 Satellite 服务器上启用 RHEL web 控制台:
satellite-installer --enable-foreman-plugin-remote-execution-cockpit
# satellite-installer --enable-foreman-plugin-remote-execution-cockpitCopy to Clipboard Copied! Toggle word wrap Toggle overflow
8.2. 使用 RHEL Web 控制台管理和监控主机 复制链接链接已复制到粘贴板!
您可以通过 Satellite Web UI 访问 RHEL web 控制台 web UI,并使用功能管理和监控 Satellite 中的主机。
先决条件
- RHEL web 控制台在 Satellite 中启用。
RHEL web 控制台安装在您要查看的主机上:
- 对于 Red Hat Enterprise Linux 8,请参阅使用 RHEL 8 web 控制台指南中的安装 web 控制台。
- 对于 Red Hat Enterprise Linux 7,请参阅使用 RHEL 7 web 控制台指南中的安装 web 控制台。
- Satellite 或 Capsule 可以使用 SSH 密钥向主机进行身份验证。更多信息请参阅 第 12.14 节 “为远程执行分发 SSH 密钥”。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,再选择您要使用 RHEL web 控制台管理和监控的主机。
- 在主机窗口的右上角,点垂直 ellipsis 并选择 Web Console。
现在,您可以通过 RHEL web 控制台访问主机监控和管理的完整功能,如 Red Hat Image Builder。
有关开始使用 Red Hat web 控制台的更多信息,请参阅使用 RHEL 8 web 控制台指南或使用 RHEL 7 web 控制台指南管理系统。
有关通过 RHEL web 控制台使用 Red Hat Image Builder 的更多信息,请参阅 在 RHEL 8 web 控制台中访问镜像构建器 GUI 或 访问 RHEL 7 web 控制台中的镜像构建器 GUI。
8.3. 在 Satellite 上禁用 RHEL Web 控制台 复制链接链接已复制到粘贴板!
如果要在 Satellite 上禁用 RHEL web 控制台,请执行以下步骤。
流程
运行这个
satellite-installer命令:satellite-installer --no-enable-foreman-plugin-remote-execution-cockpit
# satellite-installer --no-enable-foreman-plugin-remote-execution-cockpitCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 在 Satellite Web UI 中,进入到 Administer > Settings 并点 Remote execution 选项卡。
- 在 Cockpit URL 行中,清除 Value 下的设置,然后点 Submit。这会从 Satellite Web UI 中删除 Web 控制台按钮。
从 Satellite 卸载 RHEL web 控制台软件包:
dnf remove rubygem-foreman_remote_execution-cockpit
# dnf remove rubygem-foreman_remote_execution-cockpitCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要RHEL web 控制台集成可以在胶囊服务器上独立启用或禁用。要防止在 Capsule 服务器上启用 RHEL web 控制台集成,请在完成流程后运行以下命令:
satellite-installer --foreman-proxy-plugin-remote-execution-script-cockpit-integration=false
# satellite-installer --foreman-proxy-plugin-remote-execution-script-cockpit-integration=falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第 9 章 使用 Red Hat Insights 监控主机 复制链接链接已复制到粘贴板!
您可以使用 Insights 诊断与安全漏洞、性能下降和稳定性故障相关的系统和停机时间。您可以使用 Insights 仪表板快速识别稳定性、安全性和性能的关键风险。您可以根据类别排序,查看影响和解决方案的详情,然后确定受影响的系统。
要使用 Insights 监控您通过 Satellite 管理的主机,您必须首先在主机上安装 Insights,并使用 Insights 注册您的主机。
对于新的 Satellite 主机,您可以在主机注册到 Satellite 的过程中安装和配置 Insights。如需更多信息,请参阅 第 3.3 节 “使用全局注册注册主机”。
对于已注册到 Satellite 的主机,您可以使用 Ansible 角色在主机上安装和配置 Insights。如需更多信息,请参阅 第 9.3 节 “使用 Ansible 角色部署 Red Hat Insights”。
其它信息
-
要查看所有插件的日志,请转至
/var/log/foreman/production.log。 - 如果您在连接到 Insights 时遇到问题,请确保您的证书为最新版本。刷新订阅清单以更新您的证书。
-
您可以通过在一个主机上配置
insights-client.timer来更改运行insights-client的默认调度。如需更多信息,请参阅 Red Hat Insights 的客户端配置指南 中的 更改 insights-client 调度。
9.1. 从 Satellite 中的 Insights 访问信息 复制链接链接已复制到粘贴板!
您可以在 Satellite Web UI 中的以下位置访问 Red Hat Insights 中主机可用的额外信息:
- 进入 Configure > Insights,其中 Remediate 按钮旁边的垂直 ellipsis 在 Red Hat Insights 链接中提供了一个 View in Red Hat Insights 链接。在每个建议行中,垂直的 ellipsis 在 Red Hat Insights 中提供了一个 View,指向推荐规则。如果这个规则可用于该建议,一个 知识库文章 链接。
- 如需更多信息,请导航到 Hosts > All Hosts。如果主机列出了建议,点建议数。在 Insights 选项卡中,Remediate 按钮旁边的垂直 ellipsis 提供了一个 Go To Satellite Insights 页面 链接,指向系统的信息,以及 Red Hat Insights 链接中的 View in Red Hat Insights 链接,用于托管控制台详情。
9.2. 从 rh-cloud 和 insights-client 报告中排除主机 复制链接链接已复制到粘贴板!
您可以将 host_registration_insights 参数设置为 False,以省略 rh-cloud 和 insights-client 报告。Satellite 将排除 rh-cloud 报告中的主机,并阻止 insights-client 上传报告到云。
使用以下步骤更改 host_registration_insights 参数的值:
流程
- 在 Satellite Web UI 中,进入到 Host > All Hosts。
- 选择您要更改值的任何主机。
-
在 Parameters 选项卡上,单击
host_registration_insights的编辑按钮。 - 将值设为 False。
此参数也可以在组织、hostgroup、子网和域级别上设置。另外,它会自动阻止新报告上传,只要它们与实体关联。
如果您在已经在 Red Hat Hybrid Cloud Console 上报告的主机上将 参数设置为 false,则它仍会从清单中自动删除。但是,这个过程可能需要一些时间才能完成。
9.3. 使用 Ansible 角色部署 Red Hat Insights 复制链接链接已复制到粘贴板!
RedHatInsights.insights-client Ansible 角色用于自动化安装并使用 Insights 注册主机。有关在 Satellite 中添加此角色的更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的开始使用 Satellite 中的 Ansible。
流程
将 RedHatInsights.insights-client 角色添加到主机。
有关新主机,请参阅 第 2.1 节 “在 Red Hat Satellite 中创建主机”。
对于现有主机,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的使用 Ansible 角色在客户端上自动化重复的任务。
- 要在主机上运行 RedHatInsights.insights-client 角色,请导航到 Hosts > All Hosts,再单击您要使用的主机的名称。
- 在主机详情页面上,展开 Schedule a job 下拉菜单。
- 单击 Run Ansible roles。
9.4. 为主机配置 Insights 建议同步 复制链接链接已复制到粘贴板!
您可以启用从 Red Hat Hybrid Cloud Console 进行自动同步,该控制台默认发生。如果禁用设置,您可以手动同步建议。
流程
自动获取建议:
- 在 Satellite Web UI 中,进入到 Configure > Insights。
- 自动启用 Sync。
手动获取建议:
- 在 Satellite Web UI 中,进入到 Configure > Insights。
- 在垂直 ellipsis 上,点 Sync Recommendations。
9.5. 从 Insights 清单配置自动删除主机 复制链接链接已复制到粘贴板!
从 Satellite 中删除主机时,也可以自动或手动从 Red Hat Insights 的清单中删除它们。在 Red Hat Hybrid Cloud Console 与 Satellite 默认进行的 Satellite 同步过程中,您可以配置从 Insights 清单自动移除主机。如果禁用了设置,您仍然可以从清单中手动删除批量主机。
前提条件
-
您的用户帐户必须具有
view_foreman_rh_cloud的权限,才能在 Satellite Web UI 中查看清单上传页面。
流程
- 在 Satellite Web UI 中,进入到 Configure > Inventory Upload。
- 启用 Automatic Mismatch Deletion 设置。
9.6. 为主机创建 Insights 修复计划 复制链接链接已复制到粘贴板!
使用 Satellite,您可以创建 Red Hat Insights 修复计划,并在 Satellite 主机上运行计划。
流程
- 在 Satellite web UI 中,进入 Configure > Insights。
在 Red Hat Insights 页面中,选择您要包含在 Insights 计划中的建议数。
您只能选择具有关联 playbook 的建议。
- 点 Remediate。
- 在 Remediation Summary 窗口中,您可以选择要应用的解决方案。使用 Filter 字段搜索特定关键字。
- 点 Remediate。
- 在 Job Invocation 页面中,请勿更改预先完成字段的内容。
- 可选。对于远程执行作业的更多高级配置,请点 Show Advanced Fields。
- 选择您需要的 查询类型。
- 选择您需要的 Schedule。
- 点 Submit。
或者:
- 在 Satellite Web UI 中,进入到 Hosts > ; All Hosts。
- 选择主机。
- 在 Host details 页面中,点 Recommendations。
- 在 Red Hat Insights 页面中,选择您要包含在 Insights 计划中的建议数,然后继续。
在 Jobs 窗口中,您可以查看计划的进度。
第 10 章 使用报告模板监控主机 复制链接链接已复制到粘贴板!
您可以使用报告模板查询 Satellite 数据,以获取有关主机状态、注册的主机、适用勘误表、应用勘误表、订阅详情和用户活动的信息。您可以使用 Satellite 附带的报告模板,或自行编写自定义报告模板以满足您的要求。报告引擎使用嵌入式 Ruby (ERB)语法。有关编写模板和 ERB 语法的更多信息,请参阅 附录 B, 模板编写参考。
您可以创建模板,或克隆模板并编辑克隆。如需模板语法的帮助,请单击模板并单击 帮助 选项卡。
10.1. 生成主机监控报告 复制链接链接已复制到粘贴板!
要在 Satellite web UI 中查看报告模板,请导航到 Monitor > Report Templates。要调度报告,请配置 cron 任务或使用 Satellite Web UI。
流程
在 Satellite Web UI 中,进入到 Monitor > Report Templates。例如,以下模板可用:
- 主机 - 安装的产品
- 将此模板用于 Simple Content Access (SCA)机构中的主机。它生成报告以及安装的产品信息以及 Subscription - 权利报告 中包含的其他指标,除了有关订阅的信息。
- 订阅 - 权利报告
- 将此模板用于不在 SCA 组织中的主机。它生成报告,其中包含有关订阅权利的信息,包括其过期时间。它仅输出不使用 SCA 的机构中主机的信息。
- 在您要使用的报告模板右侧,点 Generate。
- 可选: 要调度报告,在 Generate at 字段右侧点击图标来选择您要生成报告的日期和时间。
- 可选: 要向电子邮件地址发送报告,请选择 通过电子邮件发送报告 复选框,然后在 传送到电子邮件地址 字段中,输入所需的电子邮件地址。
- 可选:应用搜索查询过滤器。要查看所有可用结果,请不要使用任何值填充 filter 字段。
- 点 Submit。包含报告的 CSV 文件会被下载。如果您已 通过电子邮件 复选框选择了发送报告,主机监控报告将发送到您的电子邮件地址。
CLI 过程
列出所有可用的报告模板:
hammer report-template list
# hammer report-template listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 生成一个报告:
hammer report-template generate --id My_Template_ID
# hammer report-template generate --id My_Template_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 此命令会等待报告完全生成后再完成。如果要生成报告作为后台任务,您可以使用
hammer report-template schedule命令。注意如果要生成订阅权利报告,您必须使用 Now 选项中的
日期指定授权订阅的最新过期时间。您可以使用no limit值来显示所有权利。显示所有权利
hammer report-template generate \ --inputs "Days from Now=no limit" \ --name "Subscription - Entitlement Report"
# hammer report-template generate \ --inputs "Days from Now=no limit" \ --name "Subscription - Entitlement Report"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 显示所有将在 60 天后过期的权利
hammer report-template generate \ --inputs "Days from Now=60" \ --name "Subscription - Entitlement Report"
# hammer report-template generate \ --inputs "Days from Now=60" \ --name "Subscription - Entitlement Report"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
10.2. 创建报告模板 复制链接链接已复制到粘贴板!
在 Satellite 中,您可以创建报告模板并自定义模板以符合您的要求。您可以导入现有的报告模板,并使用 snippets 和 template 宏进一步自定义它们。
报告模板使用嵌入式 Ruby (ERB)语法。要在 Satellite Web UI 中查看有关使用 ERB 语法和宏的信息,请导航到 Monitor > Report Templates,然后点 Create Template,然后点 Help 选项卡。
当您在 Satellite 中创建报告模板时,默认启用安全模式。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates,然后点 Create Template。
- 在 Name 字段中输入您的报告模板的唯一名称。
- 如果您希望模板可用于所有位置和组织,请选择 Default。
- 在模板编辑器中直接创建模板,或者通过单击 Import 从文本文件导入模板。有关导入模板的更多信息,请参阅 第 10.5 节 “导入报告模板”。
- 可选:在 Audit Comment 字段中,您可以添加有关此模板的任何有用信息。
-
点 Input 选项卡,然后在 Name 字段中输入您可以在模板中引用的输入名称:
input ('name')。请注意,您必须先保存模板,然后才能在模板正文中引用此输入值。 - 选择输入值是否是必需的。如果输入值是必需的,请选中 Required 复选框。
- 在 Value Type 列表中,选择用户必须输入的输入值类型。
- 可选:如果要使用事实进行模板输入,请选择 Advanced 复选框。
- 可选:在 Options 字段中,定义用户可以从中选择的选项。如果此字段未定义,用户会收到一个自由文本字段,他们可以在其中输入所需的值。
- 可选:在 Default 字段中输入一个值,例如,一个主机名,您要将其设置为默认模板输入。
- 可选: 在 Description 字段中,您可以在生成报告时输入您要显示为内联帮助的信息。
- 可选:点 Type 选项卡,并选择此模板是要包含在其他模板中的代码片段。
- 点 Location 选项卡,并添加您要使用模板的位置。
- 单击 Organizations 选项卡,再添加要使用的模板组织。
- 点 Submit 保存您的更改。
其他资源
- 有关安全模式的详情,请参考 第 10.9 节 “报告模板安全模式”。
- 有关编写模板的更多信息,请参阅 附录 B, 模板编写参考。
- 有关您可以在报告模板中使用的宏的更多信息,请参阅 第 B.6 节 “templates Macros”。
- 要查看填充模板的步骤示例,请参阅 第 10.8 节 “创建报告模板以监控权利”。
10.3. 导出报告模板 复制链接链接已复制到粘贴板!
您可以导出在 Satellite 中创建的报告模板。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates。
- 找到您要导出的模板,然后从 Actions 列中的列表中,选择 Export。
- 对您要下载的每个报告模板重复此操作。
包含模板下载的 .erb 文件。
CLI 过程
要查看可用于导出的报告模板,请输入以下命令:
hammer report-template list
# hammer report-template listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 请注意,要在此命令的输出中导出的模板 ID。
要导出报告模板,请输入以下命令:
hammer report-template dump --id My_Template_ID > example_export.erb
# hammer report-template dump --id My_Template_ID > example_export.erbCopy to Clipboard Copied! Toggle word wrap Toggle overflow
10.4. 使用 Satellite API 导出报告模板 复制链接链接已复制到粘贴板!
您可以使用 Satellite report_templates API 从 Satellite 导出报告模板。有关使用 Satellite API 的更多信息,请参阅 API 指南。
流程
使用以下请求检索可用报告模板列表:
请求示例:
curl --insecure --user admin:redhat \ --request GET \ --config https://satellite.example.com/api/report_templates \ | json_reformat
$ curl --insecure --user admin:redhat \ --request GET \ --config https://satellite.example.com/api/report_templates \ | json_reformatCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在本例中,
json_reformat工具用于格式化 JSON 输出。响应示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 记录您要导出的模板的
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
$ curl --insecure --output /tmp/_Example_Export_Template.erb_ \ --user admin:password --request GET --config \ https://satellite.example.com/api/report_templates/My_Template_ID/exportCopy to Clipboard Copied! Toggle word wrap Toggle overflow 请注意,
158是要导出的模板的示例 ID。在本例中,导出的模板被重定向到
host_complete_list.erb。
10.5. 导入报告模板 复制链接链接已复制到粘贴板!
您可以将报告模板导入到您要创建的新模板的正文中。请注意,使用 Satellite Web UI,您只能单独导入模板。对于批量操作,请使用 Satellite API。更多信息请参阅 第 10.6 节 “使用 Satellite API 导入报告模板”。
前提条件
- 您必须已经从 Satellite 导出的模板,才能导入它们以便在新模板中使用。如需更多信息,请参阅 第 10.3 节 “导出报告模板”。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates。
- 在 Report Templates 窗口右上角,单击 Create Template。
-
在 Editor 选项卡的右上角,单击文件夹图标,然后选择您要导入的
.erb文件。 - 编辑模板以满足您的要求。
- 点 Submit。
有关自定义模板的更多信息,请参阅 附录 B, 模板编写参考。
10.6. 使用 Satellite API 导入报告模板 复制链接链接已复制到粘贴板!
您可以使用 Satellite API 将报告模板导入到 Satellite。使用 Satellite API 导入报告模板会自动解析报告模板元数据,并分配机构和位置。有关使用 Satellite API 的更多信息,请参阅 API 指南。
先决条件
使用
.erb语法创建模板,或者从其他 Satellite 导出模板。有关编写模板的更多信息,请参阅 附录 B, 模板编写参考。
有关从 Satellite 导出模板的更多信息,请参阅 第 10.4 节 “使用 Satellite API 导出报告模板”。
流程
使用以下示例格式化您要导入到
.json文件的模板:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 带有 ERB 模板的 JSON 文件示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用以下请求导入模板:
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
$ curl --insecure --user admin:redhat \ --data @Example_Template.json --header "Content-Type:application/json" \ --request POST --config https://satellite.example.com/api/report_templates/importCopy to Clipboard Copied! Toggle word wrap Toggle overflow 使用以下请求来检索报告模板列表,并验证您可以在 Satellite 中查看模板:
curl --insecure --user admin:redhat \ --request GET --config https://satellite.example.com/api/report_templates | json_reformat
$ curl --insecure --user admin:redhat \ --request GET --config https://satellite.example.com/api/report_templates | json_reformatCopy to Clipboard Copied! Toggle word wrap Toggle overflow
10.7. 生成安装的软件包列表 复制链接链接已复制到粘贴板!
使用这个流程在 Report Templates 中生成已安装的软件包列表。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates。
- 在 Host 右侧 - All Installed Packages,点 Generate。
- 可选:使用 Hosts filter search 字段搜索和应用特定的主机过滤器。
- 点 Generate。
- 如果下载没有自动启动,点 Download。
验证
- 您有列出计算机上下载的所选主机的电子表格。
10.8. 创建报告模板以监控权利 复制链接链接已复制到粘贴板!
您可以使用报告模板返回具有特定订阅的主机列表,并显示这些主机的内核数。有关编写模板的更多信息,请参阅 附录 B, 模板编写参考。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates,然后点 Create Template。
可选:在 Editor 字段中,使用
<%# >标签添加注释,其中的信息可能有助于以后参考。例如:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用
load_hosts ()宏添加一行,并使用以下方法之一和变量填充宏:<%- load_hosts(includes: [:lifecycle_environment, :operatingsystem, :architecture, :content_view, :organization, :reported_data, :subscription_facet, :pools => [:subscription]]).each_record do |host| -%>
<%- load_hosts(includes: [:lifecycle_environment, :operatingsystem, :architecture, :content_view, :organization, :reported_data, :subscription_facet, :pools => [:subscription]]).each_record do |host| -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要查看您可以使用的变量列表,请点 Help 选项卡,并在 Safe 模式方法和变量 表中找到 Host::Managed 行。
添加一个带有
each方法的host.pools变量的一行,例如:<%- host.pools.each do |pool| -%>
<%- host.pools.each do |pool| -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用
report_row ()方法添加一行,以创建报告并添加您要作为报告的一部分的目标变量:Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在模板中添加结束语句:
<%- end -%> <%- end -%>
<%- end -%> <%- end -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 要生成报告,您必须添加 <%
= report_render -%>宏:<%= report_render -%>
<%= report_render -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 点 Submit 以保存模板。
10.9. 报告模板安全模式 复制链接链接已复制到粘贴板!
当您在 Satellite 中创建报告模板时,默认启用安全模式。安全模式限制了您可以在报告模板中使用的宏和变量。安全模式可防止在报告模板中呈现问题并强制实施最佳实践。Satellite Web UI 中提供了支持的宏和变量列表。
要查看可用的宏和变量,在 Satellite Web UI 中进入 Monitor > Report Templates 并点 Create Template。在 Create Template 窗口中,单击 Help 选项卡并展开 Safe mode 方法。
虽然启用安全模式,但如果您尝试使用没有在 Safe 模式方法 中列出的宏或变量,模板编辑器会显示错误消息。
要在 Satellite 中查看安全模式的状态,在 Satellite Web UI 中进入到 Administer > Settings 并点 Provisioning 选项卡。找到 Safemode 渲染 行以检查值。
第 11 章 配置主机集合 复制链接链接已复制到粘贴板!
主机集合是一组内容主机。此功能使您能够一次性对多个主机执行相同的操作。这些操作可以包括安装、删除和更新软件包和勘误表、更改分配的生命周期环境以及内容视图的更改。您可以创建主机集合以满足您的要求和您公司的要求。例如,按功能、部门或业务单元对主机集合中的主机进行分组。
11.1. 创建主机集合 复制链接链接已复制到粘贴板!
以下步骤演示了如何创建主机集合。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 单击 New Host Collection。
- 添加 主机集合的名称。
- 清除 Unlimited Content Hosts,在 Limit 自动中输入期望的最多的主机数量。
- 添加主机集合的 Description。
- 点击 Save。
CLI 过程
运行以下命令来创建主机集合:
hammer host-collection create \ --name "My_Host_Collection" \ --organization "My_Organization"
# hammer host-collection create \ --name "My_Host_Collection" \ --organization "My_Organization"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
11.2. 克隆主机集合 复制链接链接已复制到粘贴板!
以下步骤演示了如何克隆主机集合。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 在左侧面板中,点您要克隆的主机集合。
- 点 Copy Collection。
- 为克隆的集合指定一个名称。
- 点 Create。
11.3. 删除主机集合 复制链接链接已复制到粘贴板!
使用以下步骤从 Satellite 中删除主机集合。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 选择您要删除的主机集合。
- 在 Select Action 下,单击 Remove。
- 单击 Delete 以删除主机集合。
11.4. 批量为主机集合添加主机 复制链接链接已复制到粘贴板!
您可以将多个主机添加到主机集合。
先决条件
主机必须注册到 Red Hat Satellite,才能将其添加到主机集合中。有关注册主机的详情,请参考 第 3.3 节 “使用全局注册注册主机”。
请注意,如果您将主机添加到主机集合,Satellite 审计系统不会记录更改。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 选择应添加主机的主机集合。
- 在 Hosts 选项卡上,选择 Add 子选项卡。
- 从表中选择要添加的主机,然后单击 Add Selected。
CLI 过程
要将多个主机添加到主机集合,请输入以下命令:
hammer host-collection add-host \ --host-ids My_Host_ID_1,My_Host_ID_2 \ --id My_Host_Collection_ID
# hammer host-collection add-host \ --host-ids My_Host_ID_1,My_Host_ID_2 \ --id My_Host_Collection_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow
11.5. 从主机集合中删除主机 复制链接链接已复制到粘贴板!
以下步骤演示了如何从主机集合中删除主机。
请注意,如果您从主机集合中删除主机,则不会修改数据库中的主机集合记录,以便 Satellite 审计系统不会记录更改。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 选择所需的主机集合。
- 在 Hosts 选项卡上,选择 List/Remove 子选项卡。
- 选择您要从主机集合中删除的主机,然后单击 Remove Selected。
11.6. 在主机集合中添加内容 复制链接链接已复制到粘贴板!
这些步骤演示了如何在 Red Hat Satellite 中向主机集合添加内容。
11.6.1. 在主机集合中添加软件包 复制链接链接已复制到粘贴板!
以下流程演示了如何将软件包添加到主机集合。
先决条件
- 要添加的内容应该位于其中一个现有软件仓库中,或者在此流程前添加。
- 内容应提升到分配主机的环境。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 选择要添加软件包的主机集合。
- 在 Collection Actions 选项卡上,单击 Package Installation、Removal 和 Update。
- 要更新所有软件包,请点击 Update All Packages 以使用默认方法。或者,选择按钮右侧的下拉列表图标来选择要使用的方法。通过远程执行选择 - 自定义第一个 菜单条目将把您带到您可以自定义该操作 的作业调用 页面。
- 根据需要选择 Package 或 Package Group 按钮。
在提供的字段中,指定软件包或软件包组名称。然后点击:
- Install – 使用默认方法安装新软件包。或者,选择按钮右侧的下拉列表图标并选择要使用的方法。通过远程执行选择 - 自定义第一个 菜单条目将把您带到您可以自定义该操作 的作业调用 页面。
- update - 使用默认方法 更新 主机集合中的现有软件包。或者,选择按钮右侧的下拉列表图标并选择要使用的方法。通过远程执行选择 - 自定义第一个 菜单条目将把您带到您可以自定义该操作 的作业调用 页面。
11.6.2. 查看安装的软件包 复制链接链接已复制到粘贴板!
使用以下步骤查看主机安装的软件包。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 并选择主机的名称。
- 在 Content 选项卡上,Packages 会显示安装的软件包列表。
要查看软件包的详情,请选择该软件包。
- Details 选项卡显示所选软件包的详细信息。
- Files 标签页列出了软件包中包含的文件。
- Dependencies 选项卡列出了软件包的依赖项。
- Repositories 选项卡列出了包含所选软件包的存储库。
- 您可以根据 Library 或 Default organization 进行过滤。
11.6.3. 升级软件包 复制链接链接已复制到粘贴板!
使用以下步骤查看主机安装的软件包。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,再选择包含您要升级软件包的主机名称。
在 Content 选项卡中,选择 Packages。
Status 列显示软件包是可升级还是 Up-to date。您无法更新最新的软件包。
- 从软件包列表中,选择您要升级的软件包,然后点击行末尾的垂直 ellipsis 图标。
- 选择 Apply via Remote Execution 来使用远程执行,或通过 自定义远程执行应用 (例如,要自定义远程执行)来设置应该应用的时间。
- 点 Submit 以升级软件包。
11.6.4. 从主机中删除软件包 复制链接链接已复制到粘贴板!
使用以下步骤从主机中删除已安装的软件包。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,再选择包含您要删除的软件包的主机。
- 在 Content 选项卡中,选择 Packages。
- 点您要删除的软件包行末尾的垂直 ellipsis 图标,然后选择 Remove 选项。
- 点 Submit。
11.6.5. 将勘误添加到主机集合 复制链接链接已复制到粘贴板!
以下流程演示了如何将勘误表添加到主机集合。
先决条件
- 要添加的勘误应在其中一个现有存储库中可用,或者在此流程前添加。
- 勘误应提升到分配主机的环境。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collections。
- 选择添加勘误表的主机集合。
- 在 Collection Actions 选项卡上,单击 Errata Installation。
- 选择您要添加到主机集合中的勘误,然后点 Install Selected 以使用默认的方法。或者,选择按钮右侧的下拉列表图标来选择要使用的方法。通过远程执行选择 - 自定义第一个 菜单条目会带您进入 作业调用 页面,您可以在其中自定义操作。
11.6.6. 将勘误添加到单一主机 复制链接链接已复制到粘贴板!
使用以下步骤将勘误添加到主机。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选择您要向其添加勘误表的主机。
- 单击 Content,再选择 Errata 选项卡。
- 选择您要添加到主机的勘误,或者选择列表顶部的复选框来添加所有可安装勘误表。单击您想要从完整列表中删除的勘误旁边的复选框。
- 使用您要添加到主机的勘误旁边的垂直 ellipsis 图标,选择 Apply via Remote Execution 来使用 Remote Execution,如果想要 自定义远程执行,请选择 Apply via custom remote execution。如果您没有使用 SSH 连接到目标主机,请选择 Apply via Katello agent。
- 点 Submit。
11.6.7. 应用可安装的勘误 复制链接链接已复制到粘贴板!
使用以下步骤查看可安装的勘误列表,并选择要安装的勘误。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 并选择您需要的主机。
- 如果存在与主机关联的勘误,则在新的 Host 页面的 Installable Errata 卡中会显示它们。
- 在 Content 选项卡上,勘误 显示所选主机的可安装勘误表。
- 点您要安装的任何勘误的复选框。
- 使用您要添加到主机的勘误旁边的垂直 ellipsis 图标,选择 Apply via Remote Execution 来使用远程执行。如果要自定义 远程执行,请选择 Apply via custom remote execution,或者如果您没有使用 SSH 连接到目标主机,请选择 Apply via Katello agent。
- 点 Submit。
11.6.8. 根据类型和严重性过滤勘误 复制链接链接已复制到粘贴板!
使用以下步骤根据类型或严重性过滤勘误。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 并点主机的名称。
- 在 Contents 选项卡中,勘误 列出了与所选主机关联的勘误。
- 单击 Type 以根据类型过滤勘误表。
- 您可以过滤以显示 Security, Bugfix, 或 Enhancement 类型的勘误
- 点 Severity 根据严重性过滤。
- 您可以过滤显示严重性为 N/A、低、中等、重要或严重的勘误。
- 要取消选择您的选择,返回到选项列表,然后再次单击所选选项。
您还可以使用主机页面中的 勘误 卡在显示前预先过滤类型勘误。
11.6.9. 通过适用和可安装查看勘误 复制链接链接已复制到粘贴板!
使用以下步骤查看适用或可安装的勘误。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 选择主机名。
- 单击 Overview 选项卡。在勘误卡下,有两种类型的勘误。
- 点 Applicable 查看适用于您主机上安装的软件包的勘误。
- 点 Installable 查看主机内容视图和生命周期环境中提供的适用勘误。
- 点每种类型下带有勘误数量的链接,以查看该类型的所有可用勘误列表。
- 点 每种类型的安全公告、错误修复或 改进,以仅查看相应的勘误表类型。
11.6.10. 为可安装和适用的勘误生成报告 复制链接链接已复制到粘贴板!
使用以下步骤在受管主机上生成可安装或适用勘误表的报告。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Report Templates。
- 点 Host - Applicable Errata 模板的 Generate。
- 可选: 要调度报告,请点击 Generate at 字段右侧的 日历 图标,并为生成的报告选择您想要的日期和时间。
- 可选: 要向电子邮件地址发送报告,请选择 通过电子邮件发送报告 复选框,然后在 传送到电子邮件地址 字段中,输入所需的电子邮件地址。
- 可选:为 报告文件选择另一个输出格式。默认为 CSV。
- 可选: 要将报告仅限制为搜索查询找到的主机,请点击 Hosts 过滤器 并从可用主机列表中搜索。对于所有可用主机的报告,请将 Hosts 过滤器 留空。
- 可选: 要将报告限制为仅搜索查询找到的勘误,请点击 Errata filter,并从可用勘误列表中搜索。对于所有可用勘误的报告,请将 Errata 过滤器 留空。
在 Installability 列表中选择以下选项之一:
- 适用于 显示所有适用的勘误。
- 可安装,将报告仅限制为可能安装的主机内容视图环境中访问的勘误。
- 点 Generate。您的浏览器会在 Satellite 创建报告文件后自动下载报告文件。如果您已 通过电子邮件 选项选择了发送报告,则报告将发送到您的电子邮件地址。
11.6.11. 从主机集合中删除内容 复制链接链接已复制到粘贴板!
以下流程演示了如何从主机集合中删除软件包。
流程
- 点 Hosts > Host Collections。
- 单击应当删除软件包的主机集合。
- 在 Collection Actions 选项卡上,单击 Package Installation、Removal 和 Update。
- 根据需要选择 Package 或 Package Group 按钮。
- 在提供的字段中,指定软件包或软件包组名称。
- 点 Remove,以使用默认方法删除软件包或软件包组。或者,选择按钮右侧的下拉列表图标并选择要使用的方法。通过远程执行选择 - 自定义第一个 菜单条目将把您带到您可以自定义该操作 的作业调用 页面。
11.6.12. 更改主机集合的生命周期环境或内容视图 复制链接链接已复制到粘贴板!
以下流程演示了如何更改主机集合的分配的生命周期环境或内容视图。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Host Collection。
- 选择应更改生命周期环境或内容视图的主机集合。
- 在 Collection Actions 选项卡上,单击 Change assigned Lifecycle Environment 或 Content View。
- 选择要分配给主机集合的生命周期环境。
- 从列表中选择所需的内容视图。
单击 Assign。
注意更改在大约 4 小时内生效。要使更改生效,在主机上立即生效,请输入以下命令:
subscription-manager refresh
# subscription-manager refreshCopy to Clipboard Copied! Toggle word wrap Toggle overflow 您可以使用远程执行来同时在多个主机上运行此命令。
第 12 章 配置和设置远程作业 复制链接链接已复制到粘贴板!
使用本节作为配置 Satellite 在远程主机上执行作业的指南。
要应用到远程主机的任何命令都必须定义为作业模板。在定义了作业模板后,您可以多次执行它。
12.1. 关于在主机上运行作业 复制链接链接已复制到粘贴板!
您可以使用 shell 脚本或 Ansible 任务和 playbook 在胶囊中远程运行作业。这称为远程执行。
对于您创建的自定义 Ansible 角色或您下载的角色,您必须在胶囊基本操作系统上安装包含角色的软件包。在使用 Ansible 角色之前,您必须将角色从安装它们的 Capsule 中导入 Satellite。
通信通过胶囊服务器进行,这意味着 Satellite 服务器不需要直接访问目标主机,并可扩展来管理多个主机。更多信息请参阅 第 12.4 节 “远程执行的传输模式”。
Satellite 使用 ERB 语法作业模板。更多信息请参阅 附录 B, 模板编写参考。
默认包括用于 shell 脚本和 Ansible 的几个作业模板。如需更多信息,请参阅管理主机中的 设置作业模板。
任何胶囊服务器基础操作系统都是 Satellite 服务器内部胶囊的客户端,因此本节适用于连接到 Satellite 服务器的任何类型的主机,包括胶囊。
您可以一次在多个主机上运行作业,您可以使用命令中的变量来更精细地控制您运行的作业。您可以使用主机事实和参数来填充变量值。
另外,您可以在运行命令时为模板指定自定义值。
如需更多信息 ,请参阅管理主机中的 执行远程作业。
12.2. 远程执行工作流 复制链接链接已复制到粘贴板!
当您对每个主机运行远程作业时,Satellite 都会执行以下操作来查找要使用的远程执行胶囊:
Satellite 只搜索启用了远程执行功能的 Capsules。
- Satellite 找到选择了 远程执行 复选框的主机接口。
- Satellite 查找这些接口的子网。
- Satellite 查找分配给这些子网的远程执行胶囊。
- 从这一组胶囊中,Satellite 选择了具有最少数量运行的作业的胶囊。通过这样做,Satellite 可确保作业的负载在远程执行胶囊之间平衡。
如果您已启用了 Prefer registered through Capsule for remote execution,Satellite 会使用主机注册到的 Capsule 运行 REX 作业。
默认情况下,Prefer registered through Capsule for remote execution 被设置为 No。要启用它,在 Satellite web UI 中,进入到 Administer > Settings,在 Content 标签页中将 Prefer registered through Capsule for remote execution 设置为 Yes。这可确保 Satellite 根据它们注册到的胶囊对主机执行 REX 作业。
如果 Satellite 在此阶段找不到远程执行胶囊,如果 Fallback 设为 Any Capsule 设置,则 Satellite 会添加另一组 Capsules 以选择远程执行胶囊。Satellite 从分配给主机的以下类型的胶囊中选择最轻便加载的 Capsule:
- DHCP、DNS 和 TFTP Capsules 分配给主机子网
- 分配给主机域的 DNS Capsule
- 分配给主机域的 realm Capsule
- Puppet 服务器 Capsule
- Puppet CA Capsule
- OpenSCAP Capsule
如果 Satellite 在此阶段找不到远程执行 Capsule,如果启用了 Enable Global Capsule 设置,则 Satellite 会从主机的机构和位置中的所有 Capsule 中选择最轻量的远程执行 Capsule,以执行远程作业。
12.3. 远程执行的权限 复制链接链接已复制到粘贴板!
您可以控制哪些角色可以在您的基础架构中运行哪些作业,包括他们可以的目标主机。远程执行功能提供了两个内置角色:
- 远程执行管理器 :可以访问所有远程执行功能和功能。
- 远程执行用户 :只能运行作业。
您可以克隆 Remote Execution User 角色,并自定义其过滤器以提高粒度。如果您使用自定义角色的 view_job_templates 权限调整过滤器,则只能根据匹配的作业模板查看和触发作业。您可以使用 view_hosts 和 view_smart_proxies 权限来限制角色可见的主机或胶囊。
execute_template_invocation 权限是一个特殊权限,在执行作业开始前立即检查。此权限定义您可以在特定主机上运行的作业模板。这在指定权限时实现更精细的。
您可以使用 execute_jobs_on_infrastructure_hosts 权限针对作为主机注册到 Red Hat Satellite 运行远程执行作业。默认情况下,标准的 Manager 和 Site Manager 角色已具有这个权限。如果您使用 Manager 或 Site Manager 角色,或者使用带有 execute_jobs_on_infrastructure_hosts 权限的自定义角色,您可以针对注册的 Red Hat Satellite 和 Capsule 主机执行远程作业。
有关使用角色和权限的更多信息,请参阅管理 Red Hat Satellite 中的创建和管理角色。
以下示例显示了 execute_template_invocation 权限的过滤器:
name = Reboot and host.name = staging.example.com name = Reboot and host.name ~ *.staging.example.com name = "Restart service" and host_group.name = webservers
name = Reboot and host.name = staging.example.com
name = Reboot and host.name ~ *.staging.example.com
name = "Restart service" and host_group.name = webservers
使用本示例中的第一行将 Reboot 模板应用到选定主机。使用第二行定义一个主机池,其名称以 .staging.example.com 结尾。使用第三行将模板与主机组绑定。
分配给具有这些角色的用户的权限可能会随时间变化。如果您已将一些作业调度到将来运行并且权限更改,这可能会导致执行失败,因为权限在作业执行前被立即检查。
12.4. 远程执行的传输模式 复制链接链接已复制到粘贴板!
您可以将 Satellite 配置为使用两种不同的传输模式来远程作业执行。
在 ssh 模式的 Capsules 上,远程执行使用 SSH 服务传输作业详情。这是默认的传输模式。必须在目标主机上启用并激活 SSH 服务。远程执行胶囊必须有权访问目标主机上的 SSH 端口。除非您有其他设置,否则标准 SSH 端口为 22。
如果您的 Capsule 已使用 pull-mqtt 模式,而您想要切回到 ssh 模式,请运行这个 satellite-installer 命令:
satellite-installer --foreman-proxy-plugin-remote-execution-script-mode=ssh
# satellite-installer --foreman-proxy-plugin-remote-execution-script-mode=ssh
在 pull-mqtt 模式的 Capsules 上,远程执行使用 Message Queueing Telemetry Transport (MQTT)来发布它从 Satellite 服务器接收的作业。主机订阅 Capsule 上的 MQTT 代理,以便使用 yggdrasil pull 客户端的作业通知。主机收到通知后,它会通过 HTTPS 从 Capsule 拉取作业详情,运行该作业,并将结果报告回胶囊。
要使用 pull-mqtt 模式,您必须在 Capsule 服务器上启用它,并在目标主机上配置拉取客户端。
其他资源
- 要在 Capsule 服务器上启用拉取模式,请参阅安装 Capsule 服务器中的 为 Pull Client 配置远程执行。
- 要在现有主机上启用拉取模式,请继续 第 12.5 节 “配置主机以使用 Pull 客户端”。
- 要从 Katello Agent 迁移主机,请参阅 第 4 章 将主机从 Katello Agent 迁移到远程执行。
要在新主机上启用拉取模式,请继续以下流程之一:
12.5. 配置主机以使用 Pull 客户端 复制链接链接已复制到粘贴板!
对于配置为使用 pull-mqtt 模式的 Capsules,主机可以使用远程执行拉取客户端订阅远程作业。受管主机不需要 SSH 连接到其胶囊服务器。
前提条件
- 您已将主机注册到 Satellite。
-
主机注册的胶囊配置为使用
pull-mqtt模式。如需更多信息,请参阅安装 Capsule 服务器 中的 为 Pull 客户端配置远程执行。 - 用于主机的操作系统的 Red Hat Satellite Client 6 存储库已同步到 Satellite 服务器上,可在内容视图和主机的生命周期环境中同步,并为主机启用。如需更多信息,请参阅管理内容 中的更改 Satellite 中的主机存储库设置 状态 。
-
主机可以使用端口
1883通过 MQTT 与其胶囊通信。 -
主机可以使用端口
9090通过 HTTPS 与胶囊通信。
创建 katello-pull-transport-migrate 软件包,以帮助用户通过 pull 客户端从 Katello Agent 迁移到远程执行。但是,主机上安装了 Katello Agent 并不是必须的。无论是否安装了 Katello Agent,您可以使用 katello-pull-transport-migrate。
流程
在您的主机上安装
katello-pull-transport-migrate软件包:在 Red Hat Enterprise Linux 8 和 Red Hat Enterprise Linux 9 主机上:
dnf install katello-pull-transport-migrate
# dnf install katello-pull-transport-migrateCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在 Red Hat Enterprise Linux 7 主机上:
yum install katello-pull-transport-migrate
# yum install katello-pull-transport-migrateCopy to Clipboard Copied! Toggle word wrap Toggle overflow
软件包将
foreman_ygg_worker和yggdrasil作为依赖项安装,并在主机上启用拉取模式。主机的subscription-manager配置和消费者证书用于在主机上配置yggdrasil客户端,并且启动拉取模式客户端 worker。可选: 要验证拉取客户端是否正在运行并正确配置,请检查
yggdrasild服务的状态:systemctl status yggdrasild
# systemctl status yggdrasildCopy to Clipboard Copied! Toggle word wrap Toggle overflow 可选:安装该软件包后,您可以从主机中删除
katello-agent。警告如果在 Red Hat Virtualization 版本 4.4 或更高版本上安装了主机,请不要删除
katello-agent软件包,因为删除的依赖项会破坏主机。
12.6. 创建作业模板 复制链接链接已复制到粘贴板!
使用这个流程创建作业模板。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Job templates。
- 单击 New Job Template。
- 点 Template 选项卡,然后在 Name 字段中输入您的作业模板的唯一名称。
- 选择 Default 使模板可用于所有机构和位置。
- 在模板编辑器中直接创建模板,或通过单击 Import 从文本文件中上传。
- 可选:在 Audit Comment 字段中,添加有关更改的信息。
- 单击 Job 选项卡,然后在 Job category 字段中输入您自己的类别,或者从管理主机的默认 作业模板类别中列出的默认类别 中进行选择。
-
可选:在 Description Format 字段中输入描述模板。例如,
安装 package %{package_name}。您还可以在模板中使用%{template_name}和%{job_category}。 - 从 Provider Type 列表中,为 shell 脚本选择 SSH,为 Ansible 任务或 playbook 选择 Ansible。
- 可选:在 Timeout to kill 字段中,输入超时值来终止作业(如果未完成)。
- 可选:点击 Add Input 以定义输入参数。在执行作业时请求参数,且不必在模板中定义。例如,请参阅 Help 选项卡。
- 可选:点击 Foreign 输入集 来包括此作业中的其他模板。
-
可选:在 Effective 用户 区中,如果命令无法使用默认的
remote_execution_effective_user设置,请配置用户。 - 可选:如果此模板是要包含在其他模板中的片段,点 Type 选项卡并选择 Snippet。
- 可选:如果使用 Ansible 供应商,点 Ansible 选项卡。选择 Enable Ansible Callback 以允许主机发送用于创建配置报告的事实,并在作业完成后返回到 Satellite。
- 点 Location 选项卡,并添加您要使用模板的位置。
- 单击 Organizations 选项卡,再添加要使用的模板组织。
- 点 Submit 保存您的更改。
您可以通过在模板语法中包含其他模板来扩展和自定义模板。如需更多信息,请参阅管理主机中的模板编写参考 和 作业模板示例和扩展。
CLI 过程
要使用 template-definition 文件创建作业模板,请输入以下命令:
hammer job-template create \ --file "Path_to_My_Template_File" \ --job-category "My_Category_Name" \ --name "My_Template_Name" \ --provider-type SSH
# hammer job-template create \ --file "Path_to_My_Template_File" \ --job-category "My_Category_Name" \ --name "My_Template_Name" \ --provider-type SSHCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.7. 根据名称导入 Ansible Playbook 复制链接链接已复制到粘贴板!
您可以根据名称导入 Satellite,从 Capsule 上安装的集合导入 Ansible playbook。Satellite 从导入的 playbook 创建作业模板,并将模板放在 Ansible Playbook - 导入 的作业类别中。
如果您有自定义集合,请将其放在 /etc/ansible/collections/ansible_collections/My_Namespace/My_Collection 中。
前提条件
- Ansible 插件已启用。
-
您的 Satellite 帐户有一个授予
import_ansible_playbooks权限的角色。
流程
使用以下 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
# curl -X GET -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/fetch?proxy_id=My_capsule_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 选择您要导入的 Ansible playbook 并记下其名称。
使用名称导入 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# 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_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 导入完成后,您将在 Satellite Web UI 中收到通知。
后续步骤
- 您可以通过从创建的作业模板执行远程作业来运行 playbook。更多信息请参阅 第 12.22 节 “执行远程作业”。
12.8. 导入所有可用 Ansible Playbook 复制链接链接已复制到粘贴板!
您可以从 Capsule 上安装的集合将所有可用的 Ansible playbook 导入到 Satellite。Satellite 从导入的 playbook 创建作业模板,并将模板放在 Ansible Playbook - 导入 的作业类别中。
如果您有自定义集合,请将其放在 /etc/ansible/collections/ansible_collections/My_Namespace/My_Collection 中。
先决条件
- Ansible 插件已启用。
-
您的 Satellite 帐户有一个授予
import_ansible_playbooks权限的角色。
流程
使用以下 API 请求导入 Ansible playbook:
curl -X PUT -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My_capsule_ID
# curl -X PUT -H 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My_capsule_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 导入完成后,您将在 Satellite Web UI 中收到通知。
后续步骤
- 您可以通过从创建的作业模板执行远程作业来运行 playbook。更多信息请参阅 第 12.22 节 “执行远程作业”。
12.9. 在 Satellite 中将 Fallback 配置为 Any Capsule 远程执行设置 复制链接链接已复制到粘贴板!
您可以启用 Fallback 到 Any Capsule 设置,将 Satellite 配置为从分配给主机的胶囊列表搜索远程执行 Capsule。如果您需要在未配置子网的主机上运行远程作业,或者主机子网被分配给没有启用远程执行功能的胶囊,这将非常有用。
如果启用了 Fallback 到 Any Capsule 设置,Satellite 会添加另一组胶囊,从中选择远程执行胶囊。Satellite 还从分配给主机的所有 Capsule 集合中选择最轻量载入的 Capsule,如下所示:
- DHCP、DNS 和 TFTP Capsules 分配给主机子网
- 分配给主机域的 DNS Capsule
- 分配给主机域的 realm Capsule
- Puppet 服务器 Capsule
- Puppet CA Capsule
- OpenSCAP Capsule
流程
- 在 Satellite Web UI 中,进入到 Administer > Settings。
- 点 Remote Execution。
- 将 Fallback 配置为 Any Capsule 设置。
CLI 过程
在 Satellite 上输入
hammer settings set命令,将 Fallback 配置为 Any Capsule 设置。要将值设为true,输入以下命令:hammer settings set \ --name=remote_execution_fallback_proxy \ --value=true
# hammer settings set \ --name=remote_execution_fallback_proxy \ --value=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.10. 在 Satellite 中配置全局胶囊远程执行设置 复制链接链接已复制到粘贴板!
默认情况下,Satellite 会在主机的机构和位置中搜索远程执行胶囊,无论是否将胶囊分配给主机的子网。如果要将搜索限制为分配给主机子网的胶囊,您可以禁用 Enable Global Capsule 设置。
如果启用了 Enable Global Capsule 设置,Satellite 会添加另一组 Capsule 以选择远程执行胶囊。Satellite 还从主机的机构中的所有胶囊集合中选择最轻量的远程执行胶囊,以执行远程作业。
流程
- 在 Satellite Web UI 中,进入到 Administer > Settings。
- 点 Remote Execution。
- 配置 Enable Global Capsule 设置。
CLI 过程
在 Satellite 中输入
hammer settings set命令,以配置Enable Global Capsule设置。要将值设为true,输入以下命令:hammer settings set \ --name=remote_execution_global_proxy \ --value=true
# hammer settings set \ --name=remote_execution_global_proxy \ --value=trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.11. 在 Push 模式中为远程执行作业设置替代目录 复制链接链接已复制到粘贴板!
默认情况下,Satellite 以推送模式将主机上的 /var/tmp 目录用于远程执行作业。如果您的主机上的 /var/tmp 目录使用 noexec 标志挂载,则 Satellite 无法在此目录中执行远程执行作业脚本。您可以使用 satellite-installer 设置一个替代目录,以便在推送模式下执行远程执行作业。
流程
在主机上,创建一个新目录:
mkdir /My_Remote_Working_Directory
# mkdir /My_Remote_Working_DirectoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow 从默认的
/var/tmp目录中复制 SELinux 上下文:chcon --reference=/var/tmp /My_Remote_Working_Directory
# chcon --reference=/var/tmp /My_Remote_Working_DirectoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow 将您的 Satellite 服务器或 Capsule 服务器配置为使用新目录:
satellite-installer \ --foreman-proxy-plugin-remote-execution-script-remote-working-dir /My_Remote_Working_Directory
# satellite-installer \ --foreman-proxy-plugin-remote-execution-script-remote-working-dir /My_Remote_Working_DirectoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.12. 在 Pull 模式中为远程执行作业设置替代目录 复制链接链接已复制到粘贴板!
默认情况下,Satellite 在拉取模式中使用主机上的 /run 目录用于远程执行作业。如果主机上的 /run 目录使用 noexec 标志挂载,则 Satellite 无法在此目录中执行远程执行作业脚本。您可以使用 yggdrasild 服务设置在拉取模式中执行远程执行作业的替代目录。
流程
在您的主机上执行以下步骤:
创建新目录:
mkdir /My_Remote_Working_Directory
# mkdir /My_Remote_Working_DirectoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow 访问
yggdrasild服务配置:systemctl edit yggdrasild
# systemctl edit yggdrasildCopy to Clipboard Copied! Toggle word wrap Toggle overflow 通过在配置中添加以下行来指定替代目录:
Environment=FOREMAN_YGG_WORKER_WORKDIR=/My_Remote_Working_Directory
Environment=FOREMAN_YGG_WORKER_WORKDIR=/My_Remote_Working_DirectoryCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重启
yggdrasild服务:systemctl restart yggdrasild
# systemctl restart yggdrasildCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.13. 更改权限提升方法 复制链接链接已复制到粘贴板!
默认情况下,基于推送的远程执行使用 sudo 从 SSH 用户切换到在主机上执行脚本的有效用户。在某些情况下,您可能需要使用其他方法,如 su 或 dzdo。您可以在 Satellite 设置中全局配置替代方法。
先决条件
-
您的用户帐户分配了一个授予
view_settings和edit_settings权限的角色。 -
如果要将
dzdo用于 Ansible 作业,请确保已安装了包含所需 dzdo become 插件的community.generalAnsible 集合。如需更多信息,请参阅 Ansible 文档中的安装 集合。
流程
- 导航到 Administer > Settings。
- 选择 Remote Execution 选项卡。
- 点 Effective User Method 设置的值。
- 选择新值。
- 点 Submit。
12.14. 为远程执行分发 SSH 密钥 复制链接链接已复制到粘贴板!
对于 ssh 模式中的胶囊,远程执行连接通过 SSH 进行身份验证。Capsule 中的公共 SSH 密钥必须分发到要管理的附加主机上。
确保 SSH 服务已启用并在主机上运行。配置任何基于网络的或基于主机的防火墙,以启用端口 22 的访问权限。
使用以下方法之一将公共 SSH 密钥从 Capsule 分发到目标主机:
- 第 12.15 节 “为远程执行手动分发 SSH 密钥”.
- 第 12.17 节 “使用 Satellite API 获取远程执行的 SSH 密钥”.
- 第 12.18 节 “在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥”.
- 对于新的 Satellite 主机,您可以使用全局注册模板在注册过程中将 SSH 密钥部署到 Satellite 主机。如需更多信息,请参阅管理主机中的使用全局注册模板将主机注册到 Red Hat Satellite。
默认情况下,Satellite 将远程执行功能的 SSH 密钥分发到从 Satellite 置备的主机。
如果主机在 Amazon Web Services 上运行,请启用密码身份验证。如需更多信息,请参阅新用户帐户。
12.15. 为远程执行手动分发 SSH 密钥 复制链接链接已复制到粘贴板!
要手动分发 SSH 密钥,请完成以下步骤:
流程
将 SSH 公钥从 Capsule 复制到您的目标主机:
ssh-copy-id -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy.pub root@client.example.com
# ssh-copy-id -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy.pub root@client.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow 对您要管理的每个目标主机重复此步骤。
验证
要确认密钥已成功复制到目标主机,请在 Capsule 上输入以下命令:
ssh -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy root@client.example.com
# ssh -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy root@client.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.16. 将密码添加到用于远程执行的 SSH 密钥 复制链接链接已复制到粘贴板!
默认情况下,胶囊使用非密码短语保护的 SSH 密钥来在主机上执行远程作业。您可以按照以下流程使用密码短语保护 SSH 密钥。
流程
在 Satellite 服务器或 Capsule 服务器上,使用
ssh-keygen在您的 SSH 密钥中添加密码短语:ssh-keygen -p -f ~foreman-proxy/.ssh/id_rsa_foreman_proxy
# ssh-keygen -p -f ~foreman-proxy/.ssh/id_rsa_foreman_proxyCopy to Clipboard Copied! Toggle word wrap Toggle overflow
后续步骤
- 现在,在主机上运行远程执行作业时,用户必须使用密码短语。
12.17. 使用 Satellite API 获取远程执行的 SSH 密钥 复制链接链接已复制到粘贴板!
要使用 Satellite API 从 Capsule 下载公钥,请在每个目标主机上完成此流程。
流程
在目标主机上,创建
~/.ssh目录来存储 SSH 密钥:mkdir ~/.ssh
# mkdir ~/.sshCopy to Clipboard Copied! Toggle word wrap Toggle overflow 从 Capsule 下载 SSH 密钥:
curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys
# curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keysCopy to Clipboard Copied! Toggle word wrap Toggle overflow 为
~/.ssh目录配置权限:chmod 700 ~/.ssh
# chmod 700 ~/.sshCopy to Clipboard Copied! Toggle word wrap Toggle overflow 为
authorized_keys文件配置权限:chmod 600 ~/.ssh/authorized_keys
# chmod 600 ~/.ssh/authorized_keysCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.18. 在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥 复制链接链接已复制到粘贴板!
您可以在自定义 Kickstart 模板中添加 remote_execution_ssh_keys 片断,以便在置备过程中将 SSH 密钥部署到主机。Satellite 附带的 Kickstart 模板默认包含此代码片段。Satellite 在调配期间将用于远程执行的 SSH 密钥复制到系统。
流程
要在新置备主机中包含公钥,请在您使用的 Kickstart 模板中添加以下片断:
<%= snippet 'remote_execution_ssh_keys' %>
<%= snippet 'remote_execution_ssh_keys' %>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
12.19. 为 Kerberos Ticket Granting Tickets 配置 keytab 复制链接链接已复制到粘贴板!
使用这个流程将 Satellite 配置为使用 keytab 来获取 Kerberos 票据授予票据。如果没有设置 keytab,则必须手动检索票据。
流程
查找
foreman-proxy用户的 ID:id -u foreman-proxy
# id -u foreman-proxyCopy to Clipboard Copied! Toggle word wrap Toggle overflow 修改
umask值,以便新文件的权限为600:umask 077
# umask 077Copy to Clipboard Copied! Toggle word wrap Toggle overflow 为 keytab 创建目录:
mkdir -p "/var/kerberos/krb5/user/My_User_ID"
# mkdir -p "/var/kerberos/krb5/user/My_User_ID"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 创建 keytab 或将现有 keytab 复制到目录中:
cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytab
# cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytabCopy to Clipboard Copied! Toggle word wrap Toggle overflow 将目录所有者更改为
foreman-proxy用户:chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"
# chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 确保 keytab 文件是只读的:
chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"
# chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 恢复 SELinux 上下文:
restorecon -RvF /var/kerberos/krb5
# restorecon -RvF /var/kerberos/krb5Copy to Clipboard Copied! Toggle word wrap Toggle overflow
12.20. 为远程执行配置 Kerberos 身份验证 复制链接链接已复制到粘贴板!
您可以使用 Kerberos 身份验证在 Satellite 主机上建立用于远程执行的 SSH 连接。
前提条件
- 在 Kerberos 服务器上注册 Satellite 服务器
- 在 Kerberos 服务器中注册 Satellite 目标主机
- 配置并初始化用于远程执行的 Kerberos 用户帐户
- 确保 Satellite 上的 foreman-proxy 用户具有有效的 Kerberos 票据授予票据
流程
要为远程执行安装并启用 Kerberos 身份验证,请输入以下命令:
satellite-installer --scenario satellite \ --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth true
# satellite-installer --scenario satellite \ --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 要编辑用于远程执行的默认用户,请在 Satellite Web UI 中进入到 Administer > Settings 并点 Remote Execution 选项卡。在 SSH User 行中,编辑第二列,并添加 Kerberos 帐户的用户名。
- 导航到 remote_execution_effective_user,再编辑第二列,以添加 Kerberos 帐户的用户名。
验证
- 要确认 Kerberos 身份验证已准备好使用,请在主机上运行远程作业。如需更多信息 ,请参阅管理主机中的 执行远程作业。
12.21. 设置作业模板 复制链接链接已复制到粘贴板!
Satellite 提供可用于执行作业的默认作业模板。要查看作业模板列表,请导航到 Hosts > Job templates。如果要使用没有更改的模板,请执行 管理主机 中的 执行远程作业。
您可以使用默认模板作为自行开发的基础。默认作业模板被锁定以进行编辑。克隆模板并编辑克隆。
流程
- 要克隆模板,请在 Actions 列中选择 Clone。
- 输入克隆的唯一名称,然后点 Submit 以保存更改。
作业模板使用嵌入式 Ruby (ERB)语法。有关编写模板的更多信息, 请参阅管理主机中的模板编写参考 。
Ansible 注意事项
要创建 Ansible 作业模板,请使用以下步骤和 ERB 语法,请使用 YAML 语法。使用 --- 开始模板。您可以将 Ansible playbook YAML 文件嵌入到作业模板正文中。您还可以添加 ERB 语法来自定义 YAML Ansible 模板。您还可以在 Satellite 中导入 Ansible playbook。如需更多信息, 请参阅管理主机中的 同步存储库模板。
参数变量
在运行时,作业模板可以接受您为主机定义的参数变量。请注意,只有主机编辑页面中的参数在 Parameters 选项卡中看到的参数才能用作作业模板的输入参数。
12.22. 执行远程作业 复制链接链接已复制到粘贴板!
您可以针对一个或多个主机执行基于作业模板的作业。
要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Jobs 并点 Run job。
- 选择要使用的 Job category 和 Job template,然后点 Next。
选择您要在其上运行作业的主机。如果您没有选择任何主机,则该作业将在当前上下文中看到的所有主机上运行。
注意如果要选择主机组及其所有子组,则不能选择主机组,因为该作业只会直接在该组的主机上运行,而不在子组中的主机上运行。反之,您必须选择主机组及其所有子组,或者使用此搜索查询:
hostgroup_fullname ~ "My_Host_Group*"
hostgroup_fullname ~ "My_Host_Group*"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将 My_Host_Group 替换为顶级主机组的名称。
- 如果需要,为作业模板提供输入。不同的模板有不同的输入,一些模板没有任何输入。输入所有所需的输入后,点 Next。
- 可选: 要为作业配置高级设置,请填写 高级字段。要了解更多有关高级设置的信息,请参阅 第 12.23 节 “作业向导中的 Advanced Settings”。
- 点击 Next。
作业的计划时间。
- 要立即执行作业,请保留预先选择的 Immediate 执行。
- 要在以后执行该作业,请选择 将来的执行。
- 要定期执行作业,请选择 Recurring execution。
可选:如果您选择了将来或重复执行,请选择 Query 类型,否则点 Next。
- 静态查询 意味着,作业在您提供的主机的确切列表上执行。
- 动态查询 表示仅在执行作业前评估主机列表。如果您根据某些过滤器输入主机列表,则结果可能与您首次使用该过滤器时的不同。
选择了查询类型后,点 Next。
可选:如果您选择将来或重复执行,请提供附加详情:
- 对于将来的执行,请输入开始 日期和时间。您还可以选择 Starts before dates before time。如果作业无法在那个时间之前启动,它将被取消。
- 对于 Recurring execution,请选择开始日期和时间、频率以及结束周期性作业的条件。您可以选择永不结束、在特定时间结束或在指定数量的重复后结束。您还可以添加 Purpose - 用于跟踪作业的特殊标签。一次只能有一个具有给定目的的活跃作业。
输入所需信息后,点 Next。
- 查看作业详情。您可以选择返回作业向导的任何部分,并编辑信息。
- 单击 Submit 以计划执行的作业。
CLI 过程
在 Satellite 中输入以下命令:
hammer settings set \ --name=remote_execution_global_proxy \ --value=false
# hammer settings set \ --name=remote_execution_global_proxy \ --value=falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow 查找您要使用的作业模板的 ID:
hammer job-template list
# hammer job-template listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 显示模板详情以查看模板所需的参数:
hammer job-template info --id My_Template_ID
# hammer job-template info --id My_Template_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 使用自定义参数执行远程作业:
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"
# 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"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 将
My_Search_Query替换为定义主机的过滤器表达式,如"name ~ My_Pattern"。有关使用 hammer 执行远程命令的更多信息,请输入hammer job-template --help和hammer job-invocation --help。
12.23. 作业向导中的 Advanced Settings 复制链接链接已复制到粘贴板!
有些任务模板要求您输入高级设置。某些高级设置仅对某些作业模板可见。以下是常规高级设置列表。
- SSH 用户
- 用于通过 SSH 连接到主机的用户。
- 有效用户
- 用于执行作业的用户。默认情况下,它是 SSH 用户。如果它与 SSH 用户(su 或 sudo)不同,具体取决于您的设置,则用于切换帐户。
- Description
- 作业的描述模板。
- 终止超时
- 作业开始的时间(以秒为单位)后,如果作业尚未结束,则应终止该作业的时间(以秒为单位)。
- 选择时间
-
如果作业没有被客户端获取,则取消作业的时间(以秒为单位)。此设置仅适用于使用
pull-mqtt传输的主机。 - 密码
- 如果 SSH 验证方法是密码而不是 SSH 密钥,则使用。
- 私钥密码短语
- 如果 SSH 密钥受密语保护,则使用。
- 有效的用户密码
- 如果有效用户与 ssh 用户不同,则使用。
- 并发级别
- 定义一次执行的最大作业数。这可以防止在大量主机上执行作业时过载系统资源。
- 时间范围
- 在所选秒数中分发远程执行。作业会定期启动一个,以固定间隔处理所给的时间窗。与并发级别类似,这也可能会阻止系统资源过载。
- 执行排序
- 决定在主机上执行作业的顺序。它可以按字母顺序排列,也可以随机化。
12.24. 使用 Extended Cron Lines 复制链接链接已复制到粘贴板!
当使用远程执行调度 cron 作业时,您可以使用扩展 cron 行来指定作业的速度。标准 cron 行包含指定分钟、小时、月份和星期日的五个字段。例如,0 5 * * * 代表每天的上午 5 点。
Extended cron 行提供以下功能:
- 您可以使用
#在一个月中指定 concrete week day 例如:
-
0 0 * mon#1指定月的 first Monday -
0 0 * * Fri#3,fri#4specifies 3rd 和 4th Fridays of the month -
0 7 * * Fri#-1指定月的最后 Friday (位于 07:00) -
0 7 * * Fri#L还指定月的最后五部时间(07:00) -
0 23 * * mon#2,tue指定月份的 2nd Monday 和 every Tuesday,地址为 23:00
-
- 您可以使用
%指定每月的每半天 例如:
-
9 0 * * Sun%2指定其他 Sunday at 00:09 -
0 0 * Sun%2+1指定每个奇数周日 -
9 0 * * Sun%2,tue%3指定其他周日和每三十天指定
-
- 您可以使用
& 指定月的日期必须与星期几匹配 例如:
-
0 0 30 * 1& 指定月 30 天,但仅在其为 Monday 时指定
-
12.25. 为主机调度周期性 Ansible 作业 复制链接链接已复制到粘贴板!
您可以计划周期性作业来在主机上运行 Ansible 角色。
前提条件
-
确保您有
view_foreman_tasks、view_job_invocations和view_recurring_logics权限。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,再选择您要在其上执行远程作业的目标主机。
- 在 Ansible 选项卡上,选择 Jobs。
- 单击 Schedule recurring job。
- 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
- 点 Submit。
- 可选:查看主机概述中的调度的 Ansible 作业,或导航到 Ansible > Jobs。
12.26. 为主机组调度周期性 Ansible 作业 复制链接链接已复制到粘贴板!
您可以调度周期性作业,以便在主机组上运行 Ansible 角色。
流程
- 在 Satellite Web UI 中,进入到 Configure > Host groups。
- 在 Actions 列中,为您要为其调度 Ansible 角色的主机组选择 Configure Ansible Job。
- 单击 Schedule recurring job。
- 在 Create New Recurring Ansible Run 窗口中定义第一次运行的重复频率、开始时间和日期。
- 点 Submit。
12.27. 监控作业 复制链接链接已复制到粘贴板!
您可以在作业运行时监控作业的进度。这有助于提供可能需要的任何故障排除。
Ansible 作业在 100 个主机的批处理上运行,因此您无法取消特定主机上运行的虚拟机。只有在 Ansible playbook 在批处理中的所有主机上运行后,作业才会完成。
流程
-
在 Satellite Web UI 中,进入到 Monitor > Jobs。如果您使用
Execute now设置触发作业,则会自动显示此页面。要监控调度的作业,请导航到 Monitor > Jobs 并选择您要检查的作业运行。 - 在 Job 页面上,单击 Hosts 选项卡。这将显示作业运行的主机列表。
- 在 Host 列中,单击要检查的主机的名称。这将显示 Commands 页面详情,您可以在其中实时监控作业执行。
- 您可以随时单击 Back to Job 以返回到 Job Details 页面。
CLI 过程
查找作业的 ID:
hammer job-invocation list
# hammer job-invocation listCopy to Clipboard Copied! Toggle word wrap Toggle overflow 监控作业输出:
hammer job-invocation output \ --host My_Host_Name \ --id My_Job_ID
# hammer job-invocation output \ --host My_Host_Name \ --id My_Job_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow 可选: 要取消作业,请输入以下命令:
hammer job-invocation cancel \ --id My_Job_ID
# hammer job-invocation cancel \ --id My_Job_IDCopy to Clipboard Copied! Toggle word wrap Toggle overflow
12.28. 在 Capsule 上设置作业率限制 复制链接链接已复制到粘贴板!
您可以一次限制胶囊上活动作业的最大数量,以防止性能激增。该作业从 Capsule 第一次尝试通知主机作业前,直到主机上作业完成为止。
作业速率限制仅适用于基于 mqtt 的作业。
最佳活跃作业数量取决于胶囊服务器的计算资源。默认情况下,活跃作业的最大数量为无限。
流程
使用
satellite-installer设置活跃作业的最大数量:satellite-installer \ --foreman-proxy-plugin-remote-execution-script-mqtt-rate-limit MAX_JOBS_NUMBER
# satellite-installer \ --foreman-proxy-plugin-remote-execution-script-mqtt-rate-limit MAX_JOBS_NUMBERCopy to Clipboard Copied! Toggle word wrap Toggle overflow 例如:
satellite-installer \ --foreman-proxy-plugin-remote-execution-script-mqtt-rate-limit 200
# satellite-installer \ --foreman-proxy-plugin-remote-execution-script-mqtt-rate-limit 200Copy to Clipboard Copied! Toggle word wrap Toggle overflow
第 13 章 Satellite 中的主机状态 复制链接链接已复制到粘贴板!
在 Satellite 中,每个主机都有一个全局状态,指示哪些主机需要注意。每个主机也具有代表特定功能状态的子状态。当子状态发生变化时,会重新计算全局状态,结果由所有子状态确定。
13.1. 主机全局状态概述 复制链接链接已复制到粘贴板!
全局状态代表特定主机的整体状态。状态可以有三个可能的值之一: OK、Warning 或 Error。您可以在 Hosts Overview 页面中找到全局状态。状态显示主机名旁边的小图标,并且具有与状态对应的颜色。将鼠标悬停在图标上会显示带有子状态信息的工具提示,可快速查找更多详细信息。要在 Satellite Web UI 中查看主机的全局状态,请导航到 Hosts > All Hosts。
- 确定
- 任何子状态都没有报告任何错误。此状态以颜色绿色突出显示。
- 警告
- 虽然没有检测到错误,但有些子状态会引发警告。例如,即使主机被配置为发送报告,主机也没有配置管理报告。调查任何警告是很好的做法,以确保您的部署处于健康状态。此状态突出显示了颜色黄色。
- Error
- 有些子状态报告失败。例如,运行包含一些失败的资源。这个状态以颜色红色突出显示。
搜索语法
如果要根据其状态搜索主机,请使用 管理 Red Hat Satellite 中的 搜索和书签 中介绍的语法在 Satellite 中进行搜索,然后使用以下与状态相关的示例进行搜索:
搜索具有 OK 状态的主机:
global_status = ok
global_status = ok
搜索所有需要注意的主机:
global_status = error or global_status = warning
global_status = error or global_status = warning
13.2. 主机子状态概述 复制链接链接已复制到粘贴板!
子状态仅监控主机功能的一部分。
要查看主机的子状态,在 Satellite web UI 中进入 Hosts > All Hosts,然后点击您要检查的完整状态的主机。您可以查看主机名称和 Host 状态卡中的主机子状态旁边的全局主机状态。
每个子状态都有自己的一组可能值,它们映射到三个全局状态值。
下面列出了 Satellite 包含的子状态。
- 配置
只有 Satellite 使用 Ansible、Puppet 或 Salt 等配置管理系统时,此子状态才相关。
可能的值:
Expand 标签 全局主机状态 禁用警报
确定
Active
确定
待处理
确定
没有更改
确定
没有报告
确定/警告
不同步
警告
Error
Error
有关此子状态值的附加信息:
- 活动 :在上一次配置期间,会应用一些资源。
-
待定 :在最后一次配置期间,将应用一些资源,但您的配置管理集成已配置为以
noop模式运行。 - 没有更改 :在最后的配置中,不会更改。
-
没有报告 :这可以是 Warning 或 OK 状态。如果没有报告,但主机使用关联的 Capsule 进行配置管理,或者
always_show_configuration_status设置设为true,它将映射到 Warning。否则,它会映射到 OK。 - 错误 :这表示配置过程中出现错误。例如,配置运行无法安装软件包。
-
不同步 :根据
outofsync_interval 设置,在预期间隔内不会收到配置报告。报告由源标识,并可以根据不同的间隔有不同的间隔。
- Build
此子状态仅与通过全局注册注册的 Satellite 或主机置备的主机相关。
可能的值:
Expand 标签 全局主机状态 数字值 已安装
确定
0
待处理的安装
确定
1
令牌已过期
Error
2
安装错误
Error
3
- Compliance
指明主机是否与 OpenSCAP 策略兼容。
可能的值:
Expand 标签 全局主机状态 数字值 Compliant
确定
0
inconclusive
警告
1
至少有一个不合规
Error
2
- OVAL 扫描
指明主机上是否有发现漏洞
可能的值:
Expand 标签 全局主机状态 数字值 没有找到漏洞
确定
0
发现漏洞
警告
1
找到可用补丁的漏洞
Error
2
- 执行
最后完成的远程执行作业的状态。
可能的值:
Expand 标签 全局主机状态 数字值 最后执行成功 / No execution completed
确定
0
最后执行失败
Error
1
未知执行状态
确定
2 或 3
最后一次执行已取消
确定
4
- 清单(Inventory)
指明主机是否同步到 Red Hat Hybrid Cloud Console。Satellite 服务器执行同步本身,但仅将基本信息上传到红帽混合云控制台。
可能的值:
Expand 标签 全局主机状态 数字值 主机没有上传到您的 RH 云清单中
警告
0
成功上传到您的 RH 云清单
确定
1
- Insights
指明主机是否同步到 Red Hat Hybrid Cloud Console。此同步由主机执行。主机上传比 Satellite 服务器更多的信息。
可能的值:
Expand 标签 全局主机状态 数字值 报告
确定
0
Not reporting
Error
1
- 勘误
指明 Errata 是否在主机上可用。
可能的值:
Expand 标签 全局主机状态 数字值 最新的
确定
0
Unknown
警告
1
所需的勘误
Error
2
所需的安全勘误
Error
3
- 订阅
指明主机是否具有有效的 RHEL 订阅。
可能的值:
Expand 标签 全局主机状态 数字值 完全授权
确定
0
部分授权
警告
1
未权利
Error
2
Unknown
警告
3
已取消订阅的 hypervisor
警告
4
启用 SCA
确定
5
- 服务级别
指明是否可以附加与指定 Service level syspurpose 值匹配的订阅。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
确定
0
不匹配
警告
1
匹配
确定
2
未指定
确定
3
- 角色
指明是否可以附加与您指定的 Role syspurpose 值匹配的订阅。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
确定
0
不匹配
警告
1
匹配
确定
2
未指定
确定
3
- 使用方法
指明是否可以附加与您的指定 Usage syspurpose 值匹配的订阅。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
确定
0
不匹配
警告
1
匹配
确定
2
未指定
确定
3
- 附加组件
指明是否可以附加与指定 Addons syspurpose 值匹配的订阅。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
确定
0
不匹配
警告
1
匹配
确定
2
未指定
确定
3
- 系统目的
指明是否可以附加与您指定的 syspurpose 值匹配的订阅。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
确定
0
不匹配
警告
1
匹配
确定
2
未指定
确定
3
- trace
指明主机是否需要重启或进程重启。
可能的值:
Expand 标签 全局主机状态 数字值 Unknown
警告
-1
最新的
确定
0
所需的进程重启
Error
1
所需的重启
Error
2
搜索语法
如果要根据其子状态搜索主机,请使用 管理 Satellite 指南中的 搜索和书签一章中介绍的语法在 Satellite 中进行搜索,然后使用以下与状态相关的示例进行搜索:
您可以根据其上次报告的状态搜索主机的配置子状态。
例如,查找至少有一个待处理资源的主机:
status.pending > 0
status.pending > 0
查找在最后一次运行期间重启某些服务的主机:
status.restarted > 0
status.restarted > 0
要查找有值得关注的运行的主机,这可能表示发生了什么:
status.interesting = true
status.interesting = true
第 14 章 同步模板存储库 复制链接链接已复制到粘贴板!
在 Satellite 中,您可以在 Satellite 服务器和版本控制系统或本地目录之间同步作业模板、置备模板、报告模板和分区表模板。在本章中,Git 存储库用于演示目的。
本节详细介绍了安装和配置 TemplateSync 插件并执行导出和导入任务的工作流。
14.1. 启用 TemplateSync 插件 复制链接链接已复制到粘贴板!
流程
要在 Satellite 服务器上启用插件,请输入以下命令:
satellite-installer --enable-foreman-plugin-templates
# satellite-installer --enable-foreman-plugin-templatesCopy to Clipboard Copied! Toggle word wrap Toggle overflow - 要验证插件是否已正确安装,请确保 Administer > Settings 包含 TemplateSync 菜单。
14.2. 配置 TemplateSync 插件 复制链接链接已复制到粘贴板!
在 Satellite Web UI 中,进入到 Administer > Settings > TemplateSync 来配置插件。下表说明了属性行为。请注意,一些属性仅用于导入或导出任务。
| 参数 | API 参数名称 | 导入含义 | 导出含义 |
|---|---|---|---|
| 关联 |
接受的值: | 根据元数据将模板与 OS、Organization 和 Location 相关联。 | N/A |
| 分支 |
| 指定要从中读取的 Git 存储库中的默认分支。 | 指定要写入的 Git 存储库中的默认分支。 |
| dirname |
| 指定要从中读取的存储库下的子目录。 | 指定要写入的存储库下的子目录。 |
| Filter |
| 仅导入具有与此正则表达式匹配的名称的模板。 | 仅导出具有与此正则表达式匹配的名称的模板。 |
| 强制导入 |
| 导入的模板会使用相同的名称覆盖锁定的模板。 | N/A |
| 锁定模板 |
| 当您导入具有相同名称的新模板时,请不要覆盖现有模板,除非启用了 Force import。 | N/A |
| 元数据导出模式 |
接受的值: | N/A | 定义在导出时如何处理元数据:
|
| negate |
接受的值: | 导入忽略 filter 属性的模板。 | 导出模板忽略过滤器属性。 |
| prefix |
| 如果模板名称没有以前缀开头,请将指定的字符串添加到模板的开头。 | N/A |
| 仓库 |
| 定义要从中同步的存储库的路径。 | 定义要导出到的存储库的路径。 |
| 详细程度 |
接受的值: | 启用将详细消息写入此操作的日志。 | N/A |
14.3. 使用存储库源 复制链接链接已复制到粘贴板!
您可以使用现有存储库或本地目录来将模板与 Satellite 服务器同步。
14.3.1. 使用现有存储库同步模板 复制链接链接已复制到粘贴板!
使用这个流程在 Satellite 服务器和现有存储库之间同步模板。
流程
如果要使用 HTTPS 连接到存储库,并在 Git 服务器上使用自签名证书颁发机构(CA):
在
/usr/share/foreman/目录下创建一个新目录,以存储证书的 Git 配置:mkdir --parents /usr/share/foreman/.config/git
# mkdir --parents /usr/share/foreman/.config/gitCopy to Clipboard Copied! Toggle word wrap Toggle overflow 在新目录中创建一个名为
config的文件:touch /usr/share/foreman/.config/git/config
# touch /usr/share/foreman/.config/git/configCopy to Clipboard Copied! Toggle word wrap Toggle overflow 允许
foreman用户访问.config目录:chown --recursive foreman /usr/share/foreman/.config
# chown --recursive foreman /usr/share/foreman/.configCopy to Clipboard Copied! Toggle word wrap Toggle overflow 使用您自签名 CA 证书的路径为
foreman用户更新 Git 全局配置:sudo --user foreman git config --global http.sslCAPath Path_To_CA_Certificate
# sudo --user foreman git config --global http.sslCAPath Path_To_CA_CertificateCopy to Clipboard Copied! Toggle word wrap Toggle overflow
如果要使用 SSH 连接到存储库:
如果还没有 SSH 密钥对,请创建一个 SSH 密钥对。不要指定密码短语。
sudo --user foreman ssh-keygen
# sudo --user foreman ssh-keygenCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
使用 Satellite 的公钥配置您的版本控制服务器,该密钥位于
/usr/share/foreman/.ssh/id_rsa.pub。 以
foreman用户身份接受 Git SSH 主机密钥:sudo --user foreman ssh git.example.com
# sudo --user foreman ssh git.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow
在 TemplateSync 选项卡中配置 TemplateSync 插件设置。
- 更改 Branch 设置,使其与 Git 服务器上的目标分支匹配。
-
更改 Repo 设置以匹配 Git 存储库。例如,对于位于
git@git.example.com/templates.git的存储库,将设置设置为git@git.example.com/templates.git。
14.3.2. 将模板与本地目录同步 复制链接链接已复制到粘贴板!
如果您在本地目录中配置了版本控制系统,则与本地目录同步模板很有用。这样,您可以编辑模板并跟踪目录中编辑的历史记录。您也可以在编辑模板后将更改同步到 Satellite 服务器。
先决条件
每个模板必须包含模板所属的位置和组织。这适用于所有模板类型。在导入模板前,请确保将以下部分添加到模板中:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
流程
在
/var/lib/foreman中,创建一个用于存储模板的目录:mkdir /var/lib/foreman/My_Templates_Dir
# mkdir /var/lib/foreman/My_Templates_DirCopy to Clipboard Copied! Toggle word wrap Toggle overflow 注意您可以将模板放在
/var/lib/foreman以外的自定义目录中,但必须确保Foreman服务可以读取其内容。目录必须具有正确的文件权限和foreman_lib_tSELinux 标签。将新 templates 目录的所有者改为
foreman用户:chown foreman /var/lib/foreman/My_Templates_Dir
# chown foreman /var/lib/foreman/My_Templates_DirCopy to Clipboard Copied! Toggle word wrap Toggle overflow -
更改 TemplateSync 选项卡上的 Repo 设置,以匹配
/var/lib/foreman/My_Templates_Dir/目录。
14.4. 导入和导出模板 复制链接链接已复制到粘贴板!
您可以使用 Satellite Web UI、Hammer CLI 或 Satellite API 导入和导出模板。Satellite API 调用使用基于角色的访问控制系统,它允许以任何用户身份执行任务。您可以将模板与版本控制系统(如 Git)或本地目录同步。
14.4.1. 导入模板 复制链接链接已复制到粘贴板!
您可以从您选择的存储库导入模板。您可以使用不同的协议指向存储库,如 /tmp/dir、git://example.com、https://example.com 和 ssh://example.com。
Satellite 提供的模板已锁定,您无法默认导入它们。要覆盖此行为,请将 TemplateSync 菜单中的 Force import 设置改为 yes,或将 force 参数 -d '{ "force": "true" }' 改为 import 命令。
先决条件
每个模板必须包含模板所属的位置和组织。这适用于所有模板类型。在导入模板前,请确保将以下部分添加到模板中:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
要使用 API,请参阅 API 流程。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Sync Templates。
- 点 Import。
- 每个字段使用 Administer > Settings > TemplateSync 中配置的值填充。根据需要更改您要导入的模板的值。有关每个字段的详情请参考 第 14.2 节 “配置 TemplateSync 插件”。
- 点 Submit。
Satellite Web UI 显示导入的状态。状态不是持久性;如果您离开状态页面,就无法返回到它。
CLI 过程
要从存储库导入模板,请输入以下命令:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 为了更好地索引和管理模板,请使用
--prefix为您的模板设置类别。要从大型存储库中选择某些模板,请使用--filter来定义要导入的模板的标题。例如,--filter 'ocpAnsible Default$'导入各种 Ansible Default 模板。
API 流程
将
POST请求发送到api/v2/templates/import:curl -H "Accept:application/json" \ -H "Content-Type:application/json" \ -u login:password \ -k https://satellite.example.com/api/v2/templates/import \ -X POST
# curl -H "Accept:application/json" \ -H "Content-Type:application/json" \ -u login:password \ -k https://satellite.example.com/api/v2/templates/import \ -X POSTCopy to Clipboard Copied! Toggle word wrap Toggle overflow 如果导入成功,您会收到
{"message":"Success"}。
14.4.2. 导出模板 复制链接链接已复制到粘贴板!
使用这个流程将模板导出到 git 存储库。
要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程。
要使用 API,请参阅 API 流程。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Sync Templates。
- 单击 Export。
- 每个字段使用 Administer > Settings > TemplateSync 中配置的值填充。根据需要更改您要导出的模板的值。有关每个字段的详情请参考 第 14.2 节 “配置 TemplateSync 插件”。
- 点 Submit。
Satellite Web UI 显示导出的状态。状态不是持久性;如果您离开状态页面,就无法返回到它。
CLI 过程
要将模板导出到存储库,请输入以下命令:
hammer export-templates \ --organization "My_Organization" \ --repo "https://git.example.com/path/to/repository"
# hammer export-templates \ --organization "My_Organization" \ --repo "https://git.example.com/path/to/repository"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意此命令克隆存储库,在提交中进行更改,并推送回存储库。您可以使用
--branch "My_Branch"选项,将模板导出到特定的分支。
API 流程
将
POST请求发送到api/v2/templates/export:curl -H "Accept:application/json" \ -H "Content-Type:application/json" \ -u login:password \ -k https://satellite.example.com/api/v2/templates/export \ -X POST
# curl -H "Accept:application/json" \ -H "Content-Type:application/json" \ -u login:password \ -k https://satellite.example.com/api/v2/templates/export \ -X POSTCopy to Clipboard Copied! Toggle word wrap Toggle overflow 如果导出成功,您会收到
{"message":"Success"}。
您可以使用 -d 参数在请求中指定默认 API 设置来覆盖它们。以下示例将模板导出到 git.example.com/templates 存储库:
第 15 章 管理软件包 复制链接链接已复制到粘贴板!
您可以使用 Satellite 在主机上安装、升级和删除软件包,以及在主机上启用或禁用存储库。
15.1. 在主机上启用和禁用存储库 复制链接链接已复制到粘贴板!
使用这个流程为 Satellite 在主机上启用和禁用存储库。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts,
- 选择主机名。
- 单击 Content 选项卡。
- 单击 Repository Sets 选项卡。
- 点垂直 ellipsis 选择 Override to disabled 或 Override to enabled 来在主机上禁用或启用存储库。
15.2. 在主机上安装软件包 复制链接链接已复制到粘贴板!
使用这个流程,使用 Satellite Web UI 查看并安装软件包。用于安装的软件包列表取决于分配给主机的内容视图和生命周期环境。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts 并选择您要安装的软件包的主机。
- 在 Content 选项卡中,选择 Packages 选项卡。
- 在升级按钮旁边的垂直 ellipsis 图标上,点 Install Packages。
- 在 Install packages 窗口中,选择要在主机上安装的软件包或软件包。
- 点 Install。
默认情况下,软件包使用远程执行安装。有关运行远程执行作业的更多信息, 请参阅管理主机中的 配置和设置远程作业。
按照以下说明,以 JSON 格式创建 API 请求的正文。
API 流程
-
创建
"job_invocation"对象,并将其余正文放在此对象内。 -
使用字符串类型的
"package"字段创建"inputs"对象,指定您要安装的软件包。如果您要指定多个软件包,请使用空格分开它们。 -
为字符串类型创建一个
"feature"字段,其值为"katello_package_install"。 -
为字符串类型创建一个
"search_query"字段,并输入与您要安装软件包的主机匹配的搜索查询。 可选:如果要以特定用户身份安装软件包,请使用字符串类型的以下字段创建一个
ssh对象:-
使用 ssh 用户名称的
"effective_user" -
如果需要此密码,使用 ssh 用户的密码
"effective_user_password"
-
使用 ssh 用户名称的
可选: 如果要稍后安装软件包,请创建
"scheduling"对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段,包括日期、时间和时区:-
"start_at"- 设置安装软件包的时间 -
"start_before"- 设置安装软件包的最新时间。如果此时无法安装软件包,则会取消这个操作。
如果省略了时间,则默认为 00:00:00。如果省略了时区,则默认为 UTC。
-
-
可选: 如果要限制同时运行作业的主机数量,请使用整数类型的
"concurrency_level"字段创建"concurrency_control"对象。将主机数量分配为字段值。 -
可选: 如果要稍后安装软件包,并且您希望在运行作业时评估主机搜索查询,请使用
"dynamic_query"值创建字符串类型的"targeting_type"字段。如果您预期搜索查询的结果在运行作业时不同,因为主机状态改变,则这非常有用。如果省略此字段,则默认为"static_query"。 使用创建的正文发送
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
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.toolCopy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
- 在 Satellite Web UI 中,进入到 Monitor > Jobs 并查看调度或完成远程执行作业的报告,以便在所选主机上安装软件包。
API 请求正文示例
15.3. 升级主机上的软件包 复制链接链接已复制到粘贴板!
您可以在 Satellite Web UI 中批量升级主机上的软件包。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Content 选项卡,然后点 Packages 选项卡。
- 从 Status 列表中选择 Upgradable。
- 从可升级到 适用的列中选择 升级版本。
- 选择您要升级的软件包。
- 单击 Upgrade。完成远程执行作业后,您会收到 REX 作业通知。
按照以下说明,以 JSON 格式创建 API 请求的正文。
API 流程
-
创建
"job_invocation"对象,并将其余正文放在此对象内。 -
使用字符串类型的
"package"字段创建"inputs"对象,指定您要更新的软件包。如果您要指定多个软件包,请使用空格分开它们。 -
为字符串类型创建一个
"feature"字段,其值为"katello_package_update"。 -
为字符串类型创建一个
"search_query"字段,并输入与要更新软件包的主机匹配的搜索查询。 可选: 如果要以特定用户身份更新软件包,请使用字符串类型的以下字段创建一个
ssh对象:-
使用 ssh 用户名称的
"effective_user" -
如果需要此密码,使用 ssh 用户的密码
"effective_user_password"
-
使用 ssh 用户名称的
可选: 如果要稍后更新软件包,请创建
"scheduling"对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段,包括日期、时间和时区:-
"start_at"- 设置更新软件包的时间 -
"start_before"- 设置更新软件包的最新时间。如果此时无法更新软件包,则会取消这个操作。
如果省略了时间,则默认为 00:00:00。如果省略了时区,则默认为 UTC。
-
-
可选: 如果要限制同时运行作业的主机数量,请使用整数类型的
"concurrency_level"字段创建"concurrency_control"对象。将主机数量分配为字段值。 -
可选: 如果要稍后更新软件包,并且您希望在运行作业时评估主机搜索查询,请使用
"dynamic_query"值创建字符串类型的"targeting_type"字段。如果您预期搜索查询的结果在运行作业时不同,因为主机状态改变,则这非常有用。如果省略此字段,则默认为"static_query"。 使用创建的正文发送
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
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.toolCopy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
- 在 Satellite Web UI 中,进入到 Monitor > Jobs 并查看调度或完成远程执行作业的报告,以更新所选主机上的软件包。
API 请求正文示例
15.4. 从主机中删除软件包 复制链接链接已复制到粘贴板!
您可以使用 Satellite Web UI 从主机中删除软件包。
流程
- 在 Satellite Web UI 中,进入到 Hosts > All Hosts。
- 单击要修改的主机的名称。
- 点 Content 选项卡,然后点 Packages 选项卡。
- 点要删除的软件包的垂直 ellipsis,然后选择 Remove。完成远程执行作业后,您会收到 REX 作业通知。
按照以下说明,以 JSON 格式创建 API 请求的正文。
API 流程
-
创建
"job_invocation"对象,并将其余正文放在此对象内。 -
使用字符串类型的
"package"字段创建"inputs"对象,指定您要删除的软件包。如果您要指定多个软件包,请使用空格分开它们。 -
为字符串类型创建一个
"feature"字段,其值为"katello_package_remove"。 -
为字符串类型创建一个
"search_query"字段,并输入与您要删除软件包的主机匹配的搜索查询。 可选:如果要以特定用户身份删除软件包,请使用字符串类型的以下字段创建一个
ssh对象:-
使用 ssh 用户名称的
"effective_user" -
如果需要此密码,使用 ssh 用户的密码
"effective_user_password"
-
使用 ssh 用户名称的
可选: 如果要稍后删除软件包,请创建
"scheduling"对象。该对象可以包含 ISO 8601 格式的字符串类型中的一个或两个字段,包括日期、时间和时区:-
"start_at"- 设置删除软件包的时间 -
"start_before"- 设置删除软件包的最新时间。如果此时无法删除软件包,则会取消这个操作。
如果省略了时间,则默认为 00:00:00。如果省略了时区,则默认为 UTC。
-
-
可选: 如果要限制同时运行作业的主机数量,请使用整数类型的
"concurrency_level"字段创建"concurrency_control"对象。将主机数量分配为字段值。 -
可选: 如果要稍后删除软件包,并且您希望在运行作业时评估主机搜索查询,请使用
"dynamic_query"值创建字符串类型的"targeting_type"字段。如果您预期搜索查询的结果在运行作业时不同,因为主机状态改变,则这非常有用。如果省略此字段,则默认为"static_query"。 使用创建的正文发送
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
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.toolCopy to Clipboard Copied! Toggle word wrap Toggle overflow
验证
- 在 Satellite Web UI 中,进入到 Monitor > Jobs 并查看调度或完成远程执行作业的报告,以删除所选主机上的软件包。
API 请求正文示例
附录 A. 故障排除:远程作业在 yggdrasil 更新后超时 复制链接链接已复制到粘贴板!
在禁用了弱依赖项且配置为使用 yggdrasil pull 客户端的主机上,远程作业可能会在 yggdrasil 软件包更新至 0.4.z 或更高版本后启动失败。
基于拉取的传输配置依赖于 Yggdrasil 服务,并根据主机上安装的 yggdrasil 软件包的版本而有所不同。要在主机上安装 yggdrasil 版本 0.4.z 后,基于拉取的远程执行模式可以正常工作,必须更新 Yggdrasil 客户端配置。在主机上安装 foreman_ygg_migration 软件包,可确保 Satellite 将所需的更改应用到 Yggdrasil 配置。
在启用了弱依赖项的主机上,Satellite 会自动安装 foreman_ygg_migration 软件包。不需要进一步的步骤。
在禁用弱依赖项的主机上,您必须手动安装 foreman_ygg_migration 软件包。
流程
确定在主机上安装了
yggdrasil软件包的版本:rpm --query yggdrasil
$ rpm --query yggdrasilCopy to Clipboard Copied! Toggle word wrap Toggle overflow 如果您的主机安装了
yggdrasil版本 0.4.z 或更高版本,则yggdrasil和com.redhat.Yggdrasil1.Worker1.foreman服务应该正在运行。检查这些服务的状态:systemctl status yggdrasil com.redhat.Yggdrasil1.Worker1.foreman
# systemctl status yggdrasil com.redhat.Yggdrasil1.Worker1.foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow 如果上述服务没有运行,这意味着 Yggdrasil 可能没有正确配置。
手动安装
foreman_ygg_migration软件包:dnf install foreman_ygg_migration
# dnf install foreman_ygg_migrationCopy to Clipboard Copied! Toggle word wrap Toggle overflow 安装
foreman_ygg_migration可确保 Satellite 应用所需的 Yggdrasil 配置更改,并在 pull 模式中启用远程执行按预期工作。
验证
再次检查 Yggdrasil 服务的状态:
systemctl status yggdrasil com.redhat.Yggdrasil1.Worker1.foreman
# systemctl status yggdrasil com.redhat.Yggdrasil1.Worker1.foremanCopy to Clipboard Copied! Toggle word wrap Toggle overflow 这些服务现在应该正在运行。
附录 B. 模板编写参考 复制链接链接已复制到粘贴板!
嵌入式 Ruby (ERB)是一种基于模板生成文本文件的工具,可将纯文本与 Ruby 代码组合。Red Hat Satellite 在以下情况下使用 ERB 语法:
- 置备模板
- 如需更多信息,请参阅 置备主机 中的 创建 置备模板。
- 远程执行作业模板
- 更多信息请参阅 第 12 章 配置和设置远程作业。
- 报告模板
- 更多信息请参阅 第 10 章 使用报告模板监控主机。
- 分区表的模板
- 如需更多信息,请参阅 置备主机 中的 创建分区表。
- 智能类参数
- 如需更多信息,请参阅在 Red Hat Satellite 中使用 Puppet 集成管理配置 中的 配置 Puppet 智能类参数。
本节概述可在 ERB 模板中使用的特定于 Satellite 的宏和变量以及一些用法示例。请注意,Red Hat Satellite 提供的默认模板(Hosts > Provisioning templates,Hosts > Job templates,Monitor > Report Templates )还提供了 ERB 语法示例的良好源。
在调配主机或运行远程作业时,将执行 ERB 中的代码,并且变量替换为特定于主机的值。这个过程被称为 渲染。默认情况下,Satellite 服务器启用了 securemode 渲染选项,这可以防止从模板执行任何有害代码。
B.1. 在 Satellite Web UI 中访问模板编写参考 复制链接链接已复制到粘贴板!
您可以在 Satellite Web UI 中访问模板编写参考文档。
流程
- 登录 Satellite Web UI。
- 在 Satellite Web UI 中,进入到 Administer > About。
- 单击 Support 部分中的 Templates DSL 链接。
B.2. 在模板中使用自动完成功能 复制链接链接已复制到粘贴板!
您可以使用自动完成选项访问模板编辑器中的可用宏和使用信息列表。这适用于 Satellite 中的所有模板。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Partition tables,Hosts > Provisioning templates, 或 Hosts > Job templates。
- 点模板编辑器右上角的 设置 图标,然后选择 Autocompletion。
-
在模板编辑器中按
Ctrl+Space来访问所有可用宏的列表。您可以通过输入 来缩小宏列表范围。例如,如果您查找列出主机内容源的 ID 的方法,您可以键入host并检查内容源的可用宏列表。 - 下拉菜单旁边的窗口提供宏描述、使用方法及其返回值。
-
当您找到您想要的方法时,按
Enter键输入方法。
您还可以在 设置 菜单中启用 Live Autocompletion,以查看在您键入内容时与模式匹配的宏列表。但是,这可能会在意外的位置输入宏,如置备模板中的软件包名称。
B.3. 编写 ERB 模板 复制链接链接已复制到粘贴板!
以下标签是 ERB 模板中最重要的常用:
<% %>
所有 Ruby 代码都包括在 ERB 模板中的 & lt;% % > 中。在渲染模板时执行代码。它可以包含 Ruby 控制流结构以及特定于 Satellite 的宏和变量。例如:
<% if @host.operatingsystem.family == "Redhat" && @host.operatingsystem.major.to_i > 6 -%>
systemctl <%= input("action") %> <%= input("service") %>
<% else -%>
service <%= input("service") %> <%= input("action") %>
<% end -%>
<% if @host.operatingsystem.family == "Redhat" && @host.operatingsystem.major.to_i > 6 -%>
systemctl <%= input("action") %> <%= input("service") %>
<% else -%>
service <%= input("service") %> <%= input("action") %>
<% end -%>
请注意,此模板会静默地执行带有服务的操作,并在输出中不返回任何操作。
<%= %>
这提供了与 <% %> 相同的功能,但在执行模板时,代码输出会插入到模板中。这对变量替换很有用,例如:
输入示例:
echo <%= @host.name %>
echo <%= @host.name %>
渲染示例:
host.example.com
host.example.com
输入示例:
<% server_name = @host.fqdn %> <%= server_name %>
<% server_name = @host.fqdn %>
<%= server_name %>
渲染示例:
host.example.com
host.example.com
请注意,如果您输入了不正确的变量,则不会返回任何输出。但是,如果您试图在不正确的变量上调用方法,则会返回以下出错信息:
输入示例:
<%= @example_incorrect_variable.fqdn -%>
<%= @example_incorrect_variable.fqdn -%>
渲染示例:
undefined method `fqdn' for nil:NilClass
undefined method `fqdn' for nil:NilClass
<% -%>, <%= -%>
默认情况下,如果一个 Ruby 块在行末尾关闭,则会在 Ruby 块后面插入换行符:
输入示例:
<%= "line1" %> <%= "line2" %>
<%= "line1" %>
<%= "line2" %>
渲染示例:
line1 line2
line1
line2
要更改默认行为,请使用 -% > 修改标记:
输入示例:
<%= "line1" -%> <%= "line2" %>
<%= "line1" -%>
<%= "line2" %>
渲染示例:
line1line2
line1line2
这用于减少在渲染模板中允许 Ruby 语法的行数。ERB 标签中的空格将被忽略。
在报告模板中如何使用它的示例,以便在 FQDN 和 IP 地址间删除不必要的新行:
输入示例:
<%= @host.fqdn -%> <%= @host.ip -%>
<%= @host.fqdn -%>
<%= @host.ip -%>
渲染示例:
host.example.com10.10.181.216
host.example.com10.10.181.216
<%# %>
括起模板渲染期间忽略的注释:
输入示例:
<%# A comment %>
<%# A comment %>
这不会生成任何输出。
ERB 模板中的缩进
由于 ERB 标签的长度不同,因此缩进 ERB 语法似乎似乎比较好。ERB 语法忽略空格。处理缩进的一种方法是在每行的开头声明 ERB 标签,然后使用 ERB 标签中的空格来概述语法中的关系,例如:
<%- load_hosts.each do |host| -%> <%- if host.build? %> <%= host.name %> build is in progress <%- end %> <%- end %>
<%- load_hosts.each do |host| -%>
<%- if host.build? %>
<%= host.name %> build is in progress
<%- end %>
<%- end %>
B.4. ERB 模板故障排除 复制链接链接已复制到粘贴板!
Satellite Web UI 提供了两种方法来验证特定主机的模板渲染:
- Directly in the template editor – 当编辑一个模板 (在 Hosts > Partition tables, Hosts > Provisioning templates 下, 或 Hosts > Job templates), 在 Template 标签页中点 Preview 并从列表中选择一个主机。然后,模板会使用所选主机的参数在文本字段中呈现。预览失败有助于识别模板中的问题。
- 在主机详情页面 - 选择位于 Hosts > All Hosts 的主机,点 Templates 选项卡列出与主机关联的模板。从所选模板旁边的列表中选择 Review 来查看呈现的版本。
B.5. 通用的针对与 Satellite 的宏 复制链接链接已复制到粘贴板!
本节列出了 ERB 模板的特定于 Satellite 的宏。您可以在所有类型的模板中使用下表中列出的宏。
| Name | 描述 |
|---|---|
| indent(n) | 使用未缩进的代码片段模板,将代码块缩进为 n 空格。 |
| foreman_url(kind) |
将完整 URL 返回到给定种类的主机渲染的模板。例如,"provision"类型的模板通常位于 |
| snippet(name) | 呈现指定的代码片段模板。用于嵌套置备模板。 |
| snippets(file) |
呈现 Foreman 数据库中找到的指定代码段,如果数据库中没有找到,会尝试从 |
| snippet_if_exists(name) | 呈现指定的代码片段,如果没有找到具有指定名称的代码片段,则跳过。 |
B.6. templates Macros 复制链接链接已复制到粘贴板!
如果要编写自定义模板,您可以使用以下一些宏。根据模板类型,以下一些宏有不同的要求。
有关报告模板可用宏的更多信息,请在 Satellite Web UI 中导航到 Monitor > Report Templates,然后点击 Create Template。在 Create Template 窗口中,单击 Help 选项卡。
有关作业模板可用宏的更多信息,在 Satellite Web UI 中导航到 Hosts > Job Templates,然后点击 New Job Template。在 New Job Template 窗口中,单击 Help 选项卡。
- 输入
使用
输入宏,您可以自定义模板可以使用的输入数据。您可以定义可用于用户的输入名称、类型和选项。对于报告模板,只能使用用户输入。当您定义新输入并保存模板时,您可以在模板正文的 ERB 语法中引用输入。<%= input('cpus') %><%= input('cpus') %>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 这会从用户输入
cpus加载值。- load_hosts
使用
load_hosts宏,您可以生成完整的主机列表。<%- load_hosts().each_record do |host| -%> <%= host.name %>
<%- load_hosts().each_record do |host| -%> <%= host.name %>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 使用带有
each_record宏的load_hosts宏来批量加载 1000 个记录,以减少内存消耗。如果要过滤报告的主机列表,您可以添加选项
search: input ('Example_Host'):<% load_hosts(search: input('Example_Host')).each_record do |host| -%> <%= host.name %> <% end -%><% load_hosts(search: input('Example_Host')).each_record do |host| -%> <%= host.name %> <% end -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 在本例中,您首先会创建一个输入,然后使用该输入优化
load_hosts宏检索的搜索条件。- report_row
使用
report_row宏,您可以创建一个格式化的报告来简化分析。report_row宏需要report_render宏来生成输出。输入示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 渲染示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 您可以通过添加另一个标头来向报告添加额外的列。以下示例在报告中添加 IP 地址:
输入示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 渲染示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - report_render
这个宏仅适用于报告模板。
使用
report_render宏,您可以为报告创建输出。在模板渲染过程中,您可以选择您要报告的格式。支持 YAML、JSON、HTML 和 CSV 格式。<%= report_render -%>
<%= report_render -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow - render_template()
这个宏仅适用于作业模板。
使用这个宏,您可以呈现特定的模板。您还可以启用和定义您要传递给模板的参数。
- 真实性
使用
truthy宏,您可以声明传递的值是否为 true 或 false,无论值是否为整数或布尔值或字符串。此宏有助于避免模板包含多个值类型时出现混淆。例如,布尔值
true与字符串值"true"不同。使用这个宏,您可以声明如何希望模板解释值并避免混淆。您可以使用
truthy来声明值,如下所示:truthy?(“true”) => true truthy?(1) => true truthy?(“false”) => false truthy?(0) => false
truthy?(“true”) => true truthy?(1) => true truthy?(“false”) => false truthy?(0) => falseCopy to Clipboard Copied! Toggle word wrap Toggle overflow - Falsy
falsy 宏与数据源宏的作用相同。
使用
falsy宏,您可以声明传递的值是否为 true 或 false,无论值是否为整数或布尔值或字符串。您可以使用
falsy来声明值,如下所示:falsy?(“true”) => false falsy?(1) => false falsy?(“false”) => true falsy?(0) => true
falsy?(“true”) => false falsy?(1) => false falsy?(“false”) => true falsy?(0) => trueCopy to Clipboard Copied! Toggle word wrap Toggle overflow
B.7. 特定于主机的变量 复制链接链接已复制到粘贴板!
以下变量可在模板中使用主机数据。请注意,作业模板仅接受 @host 变量。
| Name | 描述 |
|---|---|
| @host.architecture | 主机的构架。 |
| @host.bond_interfaces | 返回所有绑定接口的数组。请参阅 第 B.10 节 “解析数组”。 |
| @host.capabilities | 系统调配方法,可以是 build (如 kickstart)或 image。 |
| @host.certname | 主机的 SSL 证书名称。 |
| @host.diskLayout | 主机的磁盘布局。可以从操作系统继承。 |
| @host.domain | 主机的域。 |
|
@host.environment 已弃用 使用 | 主机的 Puppet 环境。 |
| @host.facts | 返回一个来自 Facter 的 Ruby 事实哈希。例如,若要从输出中访问 "ipaddress" 事实,指定 @host.facts['ipaddress']。 |
| @host.grub_pass | 返回主机的引导装载程序密码。 |
| @host.hostgroup | 主机的主机组。 |
| host_enc['parameters'] | 返回包含主机参数信息的 Ruby 哈希。例如,使用 host_enc['parameters']['lifecycle_environment'] 获取主机的生命周期环境。 |
| @host.image_build? |
如果使用镜像置备主机,则返回 |
| @host.interfaces | 包含包括了主接口的所有可用主机接口的数组。请参阅 第 B.10 节 “解析数组”。 |
| @host.interfaces_with_identifier('IDs') | 返回具有给定标识符的接口数组。您可以将多个标识符的数组作为输入,如 @host.interfaces_with_identifier (['eth0', 'eth1'])。请参阅 第 B.10 节 “解析数组”。 |
| @host.ip | 主机的 IP 地址。 |
| @host.location | 主机的位置。 |
| @host.mac | 主机的 MAC 地址。 |
| @host.managed_interfaces | 返回一组受管接口(BMC 和绑定接口除外)。请参阅 第 B.10 节 “解析数组”。 |
| @host.medium | 分配的操作系统安装介质。 |
| @host.name | 主机的全名。 |
| @host.operatingsystem.family | 操作系统系列。 |
| @host.operatingsystem.major | 分配的操作系统的主版本号。 |
| @host.operatingsystem.minor | 分配的操作系统的次要版本号。 |
| @host.operatingsystem.name | 分配的操作系统名称。 |
| @host.operatingsystem.boot_files_uri(medium_provider) | 到内核和 initrd 的完整路径,返回数组。 |
| @host.os.medium_uri(@host) | 用于置备的 URI (安装介质中配置的路径)。 |
| host_param('parameter_name') | 返回指定 host 参数的值。 |
| host_param_false?('parameter_name') |
如果指定的 host 参数评估为 |
| host_param_true?('parameter_name') |
如果指定的 host 参数评估为 |
| @host.primary_interface | 返回主机的主接口。 |
| @host.provider | 计算资源提供程序。 |
| @host.provision_interface | 返回主机的置备接口。返回 interface 对象。 |
| @host.ptable | 分区表名称。 |
|
@host.puppet_ca_server 已弃用 使用 | 主机必须使用的 Puppet CA 服务器。 |
|
@host.puppetmaster 已弃用 使用 | 主机必须使用的 Puppet 服务器。 |
| @host.pxe_build? |
如果使用网络或 PXE 置备主机,则返回 |
| @host.shortname | 主机的短名称。 |
| @host.sp_ip | BMC 接口的 IP 地址。 |
| @host.sp_mac | BMC 接口的 MAC 地址。 |
| @host.sp_name | BMC 接口的名称。 |
| @host.sp_subnet | BMC 网络的子网。 |
| @host.subnet.dhcp |
如果为这个主机配置了 DHCP 代理,则返回 |
| @host.subnet.dns_primary | 主机的主 DNS 服务器。 |
| @host.subnet.dns_secondary | 主机的辅助 DNS 服务器。 |
| @host.subnet.gateway | 主机的网关。 |
| @host.subnet.mask | 主机的子网掩码。 |
| @host.url_for_boot(:initrd) | 与此主机关联的 initrd 镜像的完整路径。不建议,因为它不进行干预。 |
| @host.url_for_boot(:kernel) | 与此主机关联的内核的完整路径。不建议使用此变量,首选 boot_files_uri。 |
| @provisioning_type | 等于 'host' 或 'hostgroup',具体取决于调配类型。 |
| @static |
如果网络配置为 static,则返回 |
| @template_name | 正在呈现的模板的名称。 |
| grub_pass | 返回一个 bootloader 参数,以设置加密的引导装载程序密码,如 --md5pass=114{@host.grub_pass}。 |
| ks_console | 使用端口和可添加到内核行的 baud 速率返回字符串。例如 console=ttyS1,9600。 |
| root_pass | 返回为系统配置的 root 密码。 |
大多数常见的 Ruby 方法可以在特定于主机的变量上应用。例如,要提取主机 IP 地址的最后一部分,您可以使用:
<% @host.ip.split('.').last %>
<% @host.ip.split('.').last %>
B.8. 特定于 Kickstart 的变量 复制链接链接已复制到粘贴板!
以下变量设计为在 kickstart 置备模板中使用。
| Name | 描述 |
|---|---|
| @arch | 主机架构名称,与 @host.architecture.name 相同。 |
| @dynamic |
如果使用的分区表是 %pre 脚本(在表的第一行有一个 #Dynamic 选择),则返回 |
| @epel | 将自动安装 epel-release rpm 的正确版本的命令。在 %post 脚本中使用。 |
| @mediapath | 提供 URL 命令的完整 kickstart 行。 |
| @osver | 操作系统主版本号,与 @host.operatingsystem.major 相同。 |
B.9. 条件语句 复制链接链接已复制到粘贴板!
在模板中,您可以根据存在哪个值来执行不同的操作。要达到此目的,您可以在 ERB 语法中使用条件语句。
在以下示例中,ERB 语法搜索特定的主机名,并根据找到的值返回输出:
输入示例
渲染示例
host1.example.com positive
host1.example.com
positive
B.10. 解析数组 复制链接链接已复制到粘贴板!
在编写或修改模板时,您可能会遇到返回数组的变量。例如,与网络接口相关的主机变量,如 @host.interfaces 或 @host.bond_interfaces,返回数组中分组的接口数据。要提取特定接口的参数值,请使用 Ruby 方法解析数组。
查找正确的方法来解析阵列
以下流程是一个示例,您可以使用它来查找模板中解析数组的相关方法。本例中使用了报告模板,但步骤适用于其他模板。
若要检索内容主机的 NIC,在本示例中使用
@host.interfaces变量返回类值,然后使用该方法查找方法来解析数组。输入示例:
<%= @host.interfaces -%>
<%= @host.interfaces -%>Copy to Clipboard Copied! Toggle word wrap Toggle overflow 渲染示例:
<Nic::Base::ActiveRecord_Associations_CollectionProxy:0x00007f734036fbe0>
<Nic::Base::ActiveRecord_Associations_CollectionProxy:0x00007f734036fbe0>Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
在 Create Template 窗口中,单击 Help 选项卡,再搜索
ActiveRecord_Associations_CollectionProxy和Nic::Base类。 对于
ActiveRecord_Associations_CollectionProxy,在 Allowed method 或 members 列中,您可以查看以下方法来解析数组:[] each find_in_batches first map size to_a
[] each find_in_batches first map size to_aCopy to Clipboard Copied! Toggle word wrap Toggle overflow 对于
Nic::Base,在 Allowed method 或 members 列中,您可以查看以下方法来解析阵列:alias? attached_devices attached_devices_identifiers attached_to bond_options children_mac_addresses domain fqdn identifier inheriting_mac ip ip6 link mac managed? mode mtu nic_delay physical? primary provision shortname subnet subnet6 tag virtual? vlanid
alias? attached_devices attached_devices_identifiers attached_to bond_options children_mac_addresses domain fqdn identifier inheriting_mac ip ip6 link mac managed? mode mtu nic_delay physical? primary provision shortname subnet subnet6 tag virtual? vlanidCopy to Clipboard Copied! Toggle word wrap Toggle overflow 要迭代接口数组,请在 ERB 语法中添加相关的方法:
输入示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 渲染示例:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
B.11. 模板片断示例 复制链接链接已复制到粘贴板!
检查主机是否启用 Puppet 和 Puppetlabs
以下示例检查主机是否启用了 Puppet 和 Puppetlabs 存储库:
<%
pm_set = @host.puppetmaster.empty? ? false : true
puppet_enabled = pm_set || host_param_true?('force-puppet')
puppetlabs_enabled = host_param_true?('enable-puppetlabs-repo')
%>
<%
pm_set = @host.puppetmaster.empty? ? false : true
puppet_enabled = pm_set || host_param_true?('force-puppet')
puppetlabs_enabled = host_param_true?('enable-puppetlabs-repo')
%>
捕获主机操作系统的主版本和次版本
以下示例演示了如何捕获主机操作系统的次要和主版本,它们可用于软件包相关决策:
将片段导入到模板
以下示例将 subscription_manager_registration 片段导入到模板,并按四个空格进行缩进:
<%= indent 4 do snippet 'subscription_manager_registration' end %>
<%= indent 4 do
snippet 'subscription_manager_registration'
end %>
有条件导入 Kickstart 片段
如果主机的子网启用了 DHCP 引导模式,以下示例导入 kickstart_networking_setup 片断:
<% subnet = @host.subnet %> <% if subnet.respond_to?(:dhcp_boot_mode?) -%> <%= snippet 'kickstart_networking_setup' %> <% end -%>
<% subnet = @host.subnet %>
<% if subnet.respond_to?(:dhcp_boot_mode?) -%>
<%= snippet 'kickstart_networking_setup' %>
<% end -%>
从主机自定义事实解析值
您可以使用 host.facts 变量来从主机的事实和自定义事实中解析值。在本例中,luks_stat 是一个自定义事实,您可以以与 dmi::system::serial_number 相同的方式解析,这是主机事实:
'Serial': host.facts['dmi::system::serial_number'], 'Encrypted': host.facts['luks_stat'],
'Serial': host.facts['dmi::system::serial_number'],
'Encrypted': host.facts['luks_stat'],
在本例中,您可以自定义 Applicable Errata report 模板,以解析每个主机的内核版本的自定义信息:
附录 C. 作业模板示例和扩展 复制链接链接已复制到粘贴板!
使用本节作为参考来帮助修改、自定义和扩展作业模板以满足您的要求。
C.1. 自定义作业模板 复制链接链接已复制到粘贴板!
在创建作业模板时,您可以在模板编辑器字段中包含现有模板。这样,您可以组合模板,或者从一般模板中创建更具体的模板。
以下模板组合了默认模板,以在客户端上安装和启动 nginx 服务:
<%= render_template 'Package Action - SSH Default', :action => 'install', :package => 'nginx' %> <%= render_template 'Service Action - SSH Default', :action => 'start', :service_name => 'nginx' %>
<%= render_template 'Package Action - SSH Default', :action => 'install', :package => 'nginx' %>
<%= render_template 'Service Action - SSH Default', :action => 'start', :service_name => 'nginx' %>
以上模板直接指定渲染模板的参数值。也可以使用 input () 方法,允许用户在作业执行时为呈现的模板定义输入。例如,您可以使用以下语法:
<%= render_template 'Package Action - SSH Default', :action => 'install', :package => input("package") %>
<%= render_template 'Package Action - SSH Default', :action => 'install', :package => input("package") %>
使用上述模板,您必须从渲染的模板导入参数定义。为此,请导航到 Jobs 选项卡,单击 Add Foreign Input Set,然后从 Target template 列表中选择 rendered template。您可以导入所有参数,或者指定逗号分隔的列表。
C.2. 默认作业模板类别 复制链接链接已复制到粘贴板!
| 作业模板类别 | Description |
|---|---|
| 软件包 | 用于执行软件包相关操作的模板。默认包括安装、更新和删除操作。 |
| puppet | 用于在目标主机上运行 Puppet 的模板。 |
| power | 用于执行电源相关操作的模板。默认包括重启和关闭操作。 |
| 命令 | 在远程主机上执行自定义命令的模板。 |
| 服务 | 用于执行服务相关操作的模板。默认包括 start、stop、restart 和 status 操作。 |
| Katello | 用于执行内容相关操作的模板。这些模板主要与 Satellite Web UI 的不同部分使用(例如,用于内容主机的批量操作 UI),但可以单独用于执行勘误安装等操作。 |
C.3. restorecon 模板示例 复制链接链接已复制到粘贴板!
本例演示了如何创建名为 Run Command - restorecon 的模板,该模板为目标主机上所选目录中所有文件恢复默认的 SELinux 上下文。
流程
- 在 Satellite Web UI 中,进入到 Hosts > Job templates。
- 单击 New Job Template。
在 Name 字段中输入 Run Command - restorecon。选择 Default 使模板可供所有机构使用。在模板编辑器中添加以下文本:
restorecon -RvF <%= input("directory") %>restorecon -RvF <%= input("directory") %>Copy to Clipboard Copied! Toggle word wrap Toggle overflow &
lt;%= input ("directory")%> 字符串在作业调用过程中被用户定义的目录替代。-
在 Job 选项卡中,将 Job category 设置为
Commands。 -
单击 Add Input 以允许作业自定义。在 Name 字段中输入
目录。输入名称必须与模板编辑器中指定的值匹配。 - 点 Required,以便在没有用户指定的参数的情况下无法执行命令。
-
从 Input type 列表中选择 User input。输入在作业调用期间要显示的描述,如
Target directory for restorecon。 - 点 Submit。如需更多信息,请参阅管理主机中的 在多个主机上执行 restorecon 模板。
C.4. 渲染 restorecon 模板 复制链接链接已复制到粘贴板!
本例演示了如何创建从 Example restorecon Template 中创建的 Run command - restorecon 模板派生出的模板。此模板在在作业执行时不需要用户输入,它将在目标主机上的 /home/ 目录下的所有文件中恢复 SELinux 上下文。
创建新模板,如 设置作业模板 中所述,并在模板编辑器中指定以下字符串:
<%= render_template("Run Command - restorecon", :directory => "/home") %>
<%= render_template("Run Command - restorecon", :directory => "/home") %>
C.5. 在多个主机上执行 restorecon 模板 复制链接链接已复制到粘贴板!
本例演示了如何在多个主机上基于 示例 restorecon 模板中创建的模板运行作业。作业在 /home/ 目录下的所有文件中恢复 SELinux 上下文。
流程
- 在 Satellite Web UI 中,进入到 Monitor > Jobs 并点 Run job。
- 选择 Commands as Job category and Run Command - restorecon as Job template,再单击 Next。
- 选择您要在其上运行作业的主机。如果您没有选择任何主机,则该作业将在当前上下文中看到的所有主机上运行。
-
在 目录 字段中,提供一个目录,如
/home,然后单击 Next。 - 可选: 要为作业配置高级设置,请填写 高级字段。要了解更多有关高级设置的信息,请参阅 第 12.23 节 “作业向导中的 Advanced Settings”。当您输入高级设置或不需要时,点 Next。
作业的计划时间。
- 要立即执行作业,请保留预先选择的 Immediate 执行。
- 要在以后执行该作业,请选择 将来的执行。
- 要定期执行作业,请选择 Recurring execution。
可选:如果您选择了将来或重复执行,请选择 Query 类型,否则点 Next。
- 静态查询 意味着,作业会在您提供的确切主机列表上执行。
动态查询 表示仅在执行作业前评估主机列表。如果您根据某些过滤器输入主机列表,则结果可能与您首次使用该过滤器时的不同。
选择了查询类型后,点 Next。
可选:如果您选择将来或重复执行,请提供附加详情:
- 对于将来的执行,请输入开始 日期和时间。您还可以选择 Starts before dates before time。如果作业无法在那个时间之前启动,它将被取消。
对于 Recurring execution,请选择结束周期性作业的开始日期和时间、频率和条件。您可以选择永不结束、在特定时间结束或在指定数量的重复后结束。您还可以添加 Purpose - 用于跟踪作业的特殊标签。一次只能有一个具有给定目的的活跃作业。
输入所需信息后,点 Next。
- 查看作业详情。您可以选择返回作业向导的任何部分,并编辑信息。
- 单击 Submit 以计划执行的作业。
C.6. 在模板中包括电源操作 复制链接链接已复制到粘贴板!
本例演示了如何为执行电源操作(如重启)设置作业模板。此流程可防止 Satellite 在重启时将断开连接异常解释为错误,因此远程执行作业可以正常工作。
创建新模板,如 设置作业模板 中所述,并在模板编辑器中指定以下字符串:
<%= render_template("Power Action - SSH Default", :action => "restart") %>
<%= render_template("Power Action - SSH Default", :action => "restart") %>
附录 D. 主机列概述 复制链接链接已复制到粘贴板!
以下是在主机表中显示、分为内容类别的列的完整概述。有些列位于多个类别下。有关如何在主机表中自定义列的详情请参考 第 2.22 节 “选择主机列”。
- General
- power - 主机是打开还是关闭(如果可用)
- name - 主机的名称
- 操作系统 - 主机的操作系统
- 模型 - 主机硬件模型(如果是虚拟主机则为计算资源)
- Owner - 拥有主机的用户或组
- 主机组 - 主机的主机组
- 最后报告 - 最后主机报告的时间
- 注释 - 提供给主机的评论
- 内容
- name - 主机的名称
- 操作系统 - 主机的操作系统
- 订阅状态 - 主机附加了有效的订阅
- 可安装更新 - 可安装的更新数量被分为四个类别:安全、错误修复、功能增强、总计
- 生命周期环境 - 主机的生命周期环境
- 内容视图 - 主机的内容视图
- registered - 主机注册到 Satellite 的时间
- 最后检查 - 主机和 Satellite 服务器之间的通信最后一次时间
- 网络
- IPv4 - 主机的 IPv4 地址
- IPv6 - 主机的 IPv6 地址
- MAC - 主机的 MAC 地址
- 报告的数据
- 插槽 - 主机插槽数
- cores - 主机处理器内核数
- RAM - 内存量
- 引导时间 - 主机的最后一次引导时间
- Virtual - 主机是否被识别为虚拟机
- 磁盘总空间 - 主机存储空间总量
- 内核版本 - 主机操作系统的内核版本
- BIOS vendor - 主机 BIOS 的厂商
- BIOS 发行日期 - 主机 BIOS 的发行日期
- BIOS 版本 - 主机 BIOS 的版本
- Puppet (仅在安装了 Puppet 插件时)
- 环境名称 - 主机的 Puppet 环境的名称
- RH 云
- 建议 - 主机的可用建议数