搜索

5.3. 使用全局注册注册主机

download PDF

您可以通过在 Satellite 上生成 curl 命令并在主机上运行此命令,将主机注册到 Satellite。此方法使用两个置备模板: Global Registration template 和 Linux host_init_config 默认模板。这样,您可以完全控制主机注册过程。

如果需要更大的灵活性,您还可以自定义默认模板。如需更多信息,请参阅 第 5.3.3 节 “自定义注册模板”

5.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 中的代码片段。

5.3.2. 注册主机

您可以使用注册模板注册主机,并在注册过程中设置各种集成功能和主机工具。

先决条件

  • 您的用户帐户分配了 create_hosts 权限的角色。
  • 您必须在要注册的主机上具有 root 权限。
  • Satellite 服务器、任何胶囊服务器和所有主机都必须与相同的 NTP 服务器同步,并且启用和运行时间同步工具。
  • 主机必须使用激活码。如需更多信息,请参阅管理内容中的管理 激活码
  • 可选:如果要将主机注册到 Red Hat Insights,您必须同步 rhel-8-for-x86_64-baseos-rpmsrhel-8-for-x86_64-appstream-rpms 存储库,并在您使用的激活码中提供它们。这是在主机上安装 insights-client 软件包所必需的。
  • 如果要使用 Capsule 服务器而不是 Satellite 服务器,请确保已相应地配置了 Capsule 服务器。如需更多信息,请参阅安装 Capsule 服务器 中的 为主机注册和置备配置 Capsule
  • 如果您的 Satellite 服务器或 Capsule 服务器位于 HTTP 代理后面,请将主机上的订阅管理器配置为使用 HTTP 代理进行连接。如需更多信息,请参阅红帽知识库中的 如何通过防火墙或代理访问 Red Hat Subscription Manager (RHSM)

流程

  1. 在 Satellite Web UI 中,进入到 Hosts > Register Host
  2. 可选:选择不同的 机构
  3. 可选: 选择不同的位置
  4. 可选:在 Host Group 列表中选择要关联主机的主机组。从 Host group 继承值的字段:操作系统激活码生命周期环境
  5. 可选: 在 Operating system 列表中,选择您要注册的主机的操作系统。
  6. 可选:在 Capsule 列表中,选择 Capsule 来注册主机。

    注意

    负载平衡器后面的胶囊优先于 Satellite Web UI 中选择的胶囊作为主机的内容源。

  7. Activation Keys 字段中,输入一个或多个要分配给主机的激活码。
  8. 可选:如果要使第一个调用不安全,请选择 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

    然后,使用安全 curl 命令注册主机,例如:

    # curl -sS https://satellite.example.com/register ...

    以下是带有 --insecure 选项的 curl 命令示例:

    # curl -sS --insecure https://satellite.example.com/register ...
  9. 选择 Advanced 选项卡。
  10. 可选:在 Setup REX 列表中,选择是否要将 Satellite SSH 密钥部署到主机。

    如果设置为 Yes,则将在注册的主机上安装公共 SSH 密钥。继承的值基于 host_registration_remote_execution 参数。它可以继承,例如从主机组、操作系统或组织继承。覆盖后,所选值将存储在主机参数级别上。

  11. 可选:在 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-rpms

      insights-client 软件包默认安装在 Red Hat Enterprise Linux 8 上,除非使用 "Minimal Install" 选项部署 Red Hat Enterprise Linux 8 的环境中。

  12. 可选:在 Install packages 字段中,列出您要在注册时在主机上安装的软件包(与空格分开)。这可以通过 host_packages 参数设置。
  13. 可选: 选择 Update packages 选项,在注册时更新主机上的所有软件包。这可以通过 host_update_packages 参数设置。
  14. 可选:在 Repository 字段中,输入要在执行注册前添加的存储库。例如,使 subscription-manager 软件包可供注册使用。对于红帽系列分发,请输入存储库的 URL,例如 http://rpm.example.com/
  15. 可选:在 Repository GPG key URL 字段中,指定验证 GPG 签名软件包签名的公钥。它需要在 ASCII 表单中使用 GPG 公钥标头指定。
  16. 可选:在 Token 生命周期(小时) 字段中,更改 Satellite 用于身份验证的 JSON Web Token (JWT)的有效性持续时间。此令牌的持续时间定义生成的 curl 命令的工作方式。您可以将持续时间设置为 0 – 999 999 小时,或没有限制。

    请注意,Satellite 应用生成 curl 命令授权的用户的权限。如果用户丢失或获得额外权限,则 JWT 的权限也会改变。因此,不要在令牌期间删除、阻止或更改用户的权限。

    JWT 的范围仅限于注册端点,不能在任何其他地方使用。

  17. 可选:在 Remote Execution Interface 字段中输入主机必须用于 SSH 连接的网络接口的标识符。如果将此字段留空,Satellite 将使用默认网络接口。
  18. 可选:从 REX pull 模式 列表中,选择是否要部署 Satellite 远程执行 pull 客户端。

    如果设置为 Yes,则将在注册的主机上安装远程执行 pull 客户端。继承的值基于 host_registration_remote_execution_pull 参数。它可以继承,例如从主机组、操作系统或组织继承。覆盖后,所选值存储在主机参数级别上。

    注册的主机必须有权访问 Red Hat Satellite Client 6 软件仓库。

    有关 pull 模式的更多信息,请参阅 第 13.4 节 “远程执行的传输模式”

  19. 可选:如果要忽略订阅管理器 错误,请选择 Ignore 错误。
  20. 可选:如果要在注册前删除任何 katello-ca-consumer rpms,选择 Force 选项,并运行带有 --force 参数的 subscription-manager
  21. Generate
  22. 复制生成的 curl 命令。
  23. 在您要注册的主机上,以 root 用户身份运行 curl 命令。

5.3.3. 自定义注册模板

您可以通过编辑置备模板来自定义注册过程。请注意,Satellite 中的所有默认模板都会被锁定。如果要自定义注册模板,您必须克隆默认模板并编辑克隆。

注意

红帽只提供对原始未编辑的模板的支持。自定义模板不会收到红帽发布的更新。

注册过程使用以下置备模板:

  • Global Registration 模板包含将主机注册到 Satellite 的步骤。此模板会在主机访问 /register Satellite API 端点时呈现。
  • Linux host_init_config 默认模板 包含主机注册后初始配置的步骤。

流程

  1. 导航到 Hosts > Templates > Provisioning Templates
  2. 搜索您要编辑的模板。
  3. 在所需模板的行中,单击 Clone
  4. 根据需要编辑模板。如需更多信息,请参阅 附录 A, 模板编写参考
  5. Submit
  6. 导航到 Administer > Settings > Provisioning
  7. 根据需要更改以下设置:

    • Default Global registration template 设置指向您的自定义全局注册模板,
    • Default 'Host initial configuration' 模板 设置为您的自定义初始配置模板。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.