在 Red Hat Satellite 中使用 Ansible 集成管理配置

Red Hat Satellite 6.12

在卫星中使用 Ansible 集成来配置主机系统

Red Hat Satellite Documentation Team

摘要

本指南说明了如何将红帽卫星与 Ansible 集成,以及如何在卫星中使用 Ansible 角色和 playbook 使重复性任务自动化。

向红帽文档提供反馈

我们感谢您对文档提供反馈信息。请让我们了解如何改进文档。

您可以通过在 Bugzilla 中记录一个 ticket 来提交反馈:

  1. 导航到 Bugzilla 网站。
  2. Component 字段中,使用 Documentation
  3. Description 字段中,输入您要改进的建议。包括文档相关部分的链接。
  4. Submit Bug

第 1 章 Satellite 中的 Ansible 入门

使用本指南将 Satellite 配置为使用 Ansible 进行远程执行。

1.1. 支持的 Ansible 版本

卫星使用 Ansible 作为卫星服务器的基本操作系统提供,或任何用于远程执行的胶囊。因此,支持的 Ansible 版本取决于您的基础操作系统配置。

1.2. 配置 Satellite 以运行 Ansible 角色

在卫星中,您可以导入 Ansible 角色,以帮助自动执行日常任务。Ansible 在卫星服务器上默认启用。

Ansible 路径

卫星根据 /etc/ansible/ansible.cfg 中的配置从路径导入 Ansible 角色和变量。然后,卫星根据 /etc/foreman-proxy/ansible.cfg 中的配置从路径运行导入的角色。在这两种情况下,Satellite 从 roles_pathcollections_paths 指令读取路径。将这两个 cfg 文件保持同步,否则您可能会导入无法运行的角色,或者您不会看到您可以运行的角色。

如果没有在配置文件中指定任何路径,则会使用以下默认路径:

  • /etc/ansible/roles
  • /usr/share/ansible/roles
  • /etc/ansible/collections
  • /usr/share/ansible/collections

流程

  1. 在卫星服务器和您要使用角色的所有胶囊服务器上配置您的 Ansible 路径
  2. 将角色添加到卫星服务器上 Ansible 路径中的目录,以及您要在其中使用角色的所有胶囊服务器。如果要使用自定义或第三方 Ansible 角色,请确保配置外部版本控制系统,以在卫星服务器和胶囊服务器之间同步角色。
  3. 在您要用来在主机上运行 Ansible 角色的所有胶囊服务器上,启用 Ansible 插件:

    # satellite-installer --scenario capsule \
    --enable-foreman-proxy-plugin-ansible
  4. 分发 SSH 密钥,以启用胶囊以使用 SSH 连接到主机。如需更多信息,请参阅管理主机中的远程执行的 SSH 密钥 卫星运行 Ansible 角色的方式与运行远程执行作业的方式相同。
  5. 将 Ansible 角色导入到卫星中。
  6. 继续 第 2 章 使用 Ansible 角色在客户端上自动化重复的任务

1.3. 启用 Ansible 与 Satellite 的集成

执行以下步骤在 Satellite 服务器上启用 Ansible 插件。

流程

  • 在 Satellite 服务器上启用 Ansible 插件:

    # satellite-installer \
    --enable-foreman-plugin-ansible \
    --enable-foreman-proxy-plugin-ansible

1.4. 导入 Ansible 角色和变量

您可以从启用了 Ansible 的卫星服务器或胶囊上的 Ansible 路径 导入 Ansible 角色和变量。

请注意,有些角色需要比其他角色导入更长的时间。

前提条件

  • 确保导入的角色和变量位于您希望使用角色的所有胶囊上的 Ansible 路径中

流程

  1. 在 Satellite Web UI 中,导航到 Configure > Roles
  2. 单击 Import 以选择要从中导入的胶囊。
  3. 选择您要导入的角色。
  4. Submit

1.5. 在卫星中覆盖 Ansible 变量

如果在卫星中运行 Ansible 角色,您可以使用卫星覆盖这些角色的 Ansible 变量。

以下流程指的是主机和主机组。如需更多信息,请参阅管理主机

覆盖变量中的优先级

如果您使用 Ansible 角色以不是 Effective User 的用户身份运行任务,则有严格的优先级顺序来覆盖 Ansible 变量。要确保您覆盖的变量按照正确的优先级顺序进行覆盖,请参阅 变量优先级:我应该在哪里放置变量?

前提条件

流程

  1. 在 Satellite Web UI 中,进入 Configure > Variables
  2. 选择您要通过卫星覆盖和管理的 Ansible 变量。
  3. Default Behavior 区域中,选中 覆盖 复选框。
  4. Parameter Type 字段中,选择验证的值类型,如 字符串boolean。type 数组hash 具有更多选项,可用于在变量匹配时进行处理。如需更多信息 ,请参阅下面的 优先级属性顺序 区域
  5. Default Value 字段中,如果变量不匹配,请输入您要使用的默认值。
  6. 可选:如果您不想在卫星 Web UI 中以纯文本形式显示变量的值,请选择 Hidden Value 复选框,将变量的内容显示为星号。这可用于敏感值,如密码或机密令牌。
  7. 可选:扩展 Optional Input Validator 区域,并指定用于验证变量值的条件:

    • 如果要 强制用户填写此变量,请选择此项。
    • Validator Type 字段中,选择如何验证值:

      • list - 将根据允许值的枚举进行验证。
      • regex - 该值将针对正则表达式模式进行验证。
  8. 可选:Prioritize Attribute Order 区中,由主机属性指定优先级顺序来匹配带有主机的覆盖。顶端的顺序具有更高的优先级。第一个匹配项胜出。

    您可以将多个属性组合成一个匹配者键,使用逗号作为 AND 操作。例如,匹配器关键字 hostgroup, environment 会预期如 hostgroup = "web servers" AND environment = production 的匹配器。

    如果使用参数类型 数组散列,您可以进一步设置:

    • merge Overrides - 合并阵列/哈希的成员,而不是替换整个阵列或哈希。如果哈希包含相同的键,则该值会被主机的值覆盖。
    • Merge Default – 为数组或散列添加默认值。
    • 避免重复 - 确保阵列中的值或哈希值是唯一的。
  9. 可选:扩展 指定 Matchers 区域,并指定用于选择变量覆盖的主机的条件。
  10. 要保存覆盖设置,请点击 Submit

要使用 Ansible 变量,请将 变量添加为主机或主机组的参数,或者将 变量添加为全局参数。

将变量添加到主机

  1. 在 Satellite Web UI 中,进入 Hosts > All Hosts 并选择要使用的主机。
  2. Ansible 选项卡,在 Variables 区域中,单击铅笔图标以编辑 变量的值。
  3. 点击 tick 图标接受 changed 变量的值或跨图标取消更改。

将变量添加到主机组

  1. 在 Satellite Web UI 中,进入 Configure > Host Groups,然后选择要使用的主机组。
  2. 单击 Parameters 选项卡,然后在 主机组参数 区域中,单击 Add Parameter
  3. Name 字段中,添加 Ansible 变量名称。
  4. Type 列表中,选择用于验证的变量类型。
  5. Value 字段中,输入 变量的值。

将变量添加为全局参数

  1. 在 Satellite Web UI 中,导航到 Configure > Global Parameters,点 Create Parameter
  2. Name 字段中,添加 Ansible 变量名称。
  3. Type 列表中,选择用于验证的变量类型。
  4. Value 字段中,输入 变量的值。
  5. 可选:如果您不想以纯文本形式显示 Ansible 变量,请选择 Hidden Values 复选框,将变量的内容显示为 Satellite Web UI 中的星号。

1.6. 添加 Red Hat Enterprise Linux 系统角色

Red Hat Enterprise Linux 系统角色是远程管理 Red Hat Enterprise Linux 服务器的配置界面。您可以使用 Red Hat Enterprise Linux 系统角色在卫星中添加 Ansible 角色。在卫星中使用 Ansible 角色可以更快、更轻松地进行配置。

某些 Red Hat Enterprise Linux 系统角色的支持等级可能还只是一个技术预览。有关支持级别以及 Red Hat Enterprise Linux 系统角色的常规信息,请参阅 Red Hat Enterprise Linux 系统角色

在订阅 Extras 频道前,请查看 Red Hat Enterprise Linux Extras 产品生命周期 文档。

流程

  1. 确定启用了以下软件仓库:

    • 在 Red Hat Enterprise Linux 8 中,确保启用了 Appstream 存储库:

      # subscription-manager repos --enable=rhel-8-for-x86_64-appstream-rpms

      您必须启用为架构指定的 Appstream 存储库。如需更多信息,请参阅 RHEL 8 软件仓库

    • 在 Red Hat Enterprise Linux 7 中,确保启用了 Extras 软件仓库:

      # subscription-manager repos --enable=rhel-7-server-extras-rpms
  2. 安装 rhel-system-roles 软件包:

    # satellite-maintain packages install rhel-system-roles

    rhel-system-roles 软件包将下载到 /usr/share/ansible/roles/。您可以在导入前查看和对文件进行修改。

  3. 在 Satellite Web UI 中,进入 Configure > Roles 并点包含您要导入的角色的胶囊。
  4. 从 Ansible 角色列表中,选择要导入的角色的复选框,然后单击 Update

现在,您可以将 Ansible 角色分配给主机或主机组。如需更多信息,请参阅 第 2.1 节 “为现有主机分配 Ansible 角色”

您还可以将这些角色中包含的模块添加到 Ansible playbook 中,方法是将其添加到 Ansible 作业模板中。您必须在作业模板中包含 hosts:all 行。如需更多信息,请参阅 Red Hat Enterprise Linux (RHEL) 系统角色

1.7. 同步 Ansible 集合

在 Satellite 中,您可以从 Private Automation Hub、console.redhat.com 和其他 Satellite 实例同步 Ansible Collections。在同步后,Ansible Collections 将会出现在 Satellite web UI 菜单的 Content 下作为一个新的仓库类型。

流程

  1. 在 Satellite Web UI 中,导航到 Content > Products
  2. 选择所需的产品名称。
  3. Products 窗口中,选择要为其创建存储库的产品名称。
  4. 单击 Repositories 选项卡,然后单击 New Repository
  5. Name 字段中输入存储库的名称。

    Label 字段会根据名称自动填充。

  6. Type 列表中,选择 ansible collection
  7. Upstream URL 字段中,输入上游集合存储库的 URL。

    URL 可以是任何 Ansible Galaxy 端点。例如: https://console.redhat.com/api/automation-hub/

  8. 可选:在 requirements.yml 字段中,您可以指定您要从端点同步的集合列表及其版本。

    如果没有指定集合列表,来自端点的所有内容都会同步。

    ---
    collections:
    - name: my_namespace.my_collection
      version: 1.2.3

    如需更多信息,请参阅 Galaxy 用户指南中的安装带有要求文件的多个集合

  9. 进行身份验证。

    1. 要从 Private Automation Hub 同步 Satellite,请在 Auth Token 字段中输入您的令牌。

      如需更多信息,请参阅连接到 Hub 中的连接私有 Automation Hub

    2. 要从 console.redhat.com 同步 Satellite,请在 Auth Token 字段中输入您的令牌,并在 Auth URL 字段中输入您的 SSO URL。

      如需更多信息,请参阅开始使用自动化中心

    3. 要从 Satellite 同步 Satellite,请将两个身份验证字段留空。
  10. 点击 Save
  11. 导航到 Ansible Collections 存储库。
  12. Select Action 菜单中,选择 Sync Now

第 2 章 使用 Ansible 角色在客户端上自动化重复的任务

2.1. 为现有主机分配 Ansible 角色

您可以使用 Ansible 角色来远程管理 Satellite 客户端。

前提条件

  • 确保您已经配置并导入了 Ansible 角色。

流程

  1. 在 Satellite Web UI 中,导航到 Hosts > All Hosts
  2. 选择主机,再单击 Edit
  3. Ansible Roles 选项卡中,从 Available Ansible Roles 列表中选择您要添加的角色。
  4. 单击 + 图标,将角色添加到主机。您可以添加多个角色。
  5. Submit

将 Ansible 角色分配到主机后,您可以使用 Ansible 进行远程执行。更多信息请参阅 第 3.13 节 “为远程执行分发 SSH 密钥”

覆盖参数变量

Parameters 选项卡上,点 Add Parameter 添加您要在运行时传递给作业模板的任何参数变量。这包括您要与主机关联的所有 Ansible playbook 参数和主机参数。要将参数变量与 Ansible 作业模板搭配使用,您必须添加一个 Host Parameter

2.2. 从主机中删除 Ansible 角色

使用以下步骤从主机中删除 Ansible 角色。

流程

  1. 在 Satellite Web UI 中,导航到 Hosts > All Hosts
  2. 选择主机,再单击 Edit
  3. 选择 Ansible Roles 选项卡。
  4. 分配的 Ansible Roles 区域中,单击 - 图标,将角色从主机中删除。重复移除更多角色。
  5. Submit

2.3. 更改 Ansible 角色的顺序

使用以下步骤更改应用到主机的 Ansible 角色的顺序。

流程

  1. 在 Satellite Web UI 中,导航到 Hosts > All Hosts
  2. 选择主机。
  3. 选择 Ansible Roles 选项卡。
  4. 分配的 Ansible 角色 区域中,您可以通过将角色拖放到首选位置来更改角色顺序。
  5. 单击 Submit,以保存 Ansible 角色的顺序。

2.4. 在主机上运行 Ansible 角色

您可以通过卫星 Web UI 在主机上运行 Ansible 角色。

前提条件

流程

  1. 在 Satellite Web UI 中,导航到 Hosts > All Hosts
  2. 选中包含您要运行的 Ansible 角色的主机的复选框。
  3. Select Action 列表中,选择 Run all Ansible roles

您可以在 Run Ansible roles 页面中查看 Ansible 作业的状态。要重新运行作业,请点 Rerun 按钮。

2.5. 将 Ansible 角色分配到主机组

您可以使用 Ansible 角色来远程管理 Satellite 客户端。

前提条件

流程

  1. 在 Satellite Web UI 中,进入 Configure > Host Groups
  2. 单击您要为其分配 Ansible 角色的主机组名称。
  3. Ansible Roles 选项卡中,从 Available Ansible Roles 列表中选择您要添加的角色。
  4. 单击 + 图标,将角色添加到主机组。您可以添加多个角色。
  5. Submit

2.6. 在主机组上运行 Ansible 角色

您可以通过卫星 Web UI 在主机组上运行 Ansible 角色。

前提条件

流程

  1. 在 Satellite Web UI 中,进入 Configure > Host Groups
  2. 从主机组的 Actions 列中的列表,选择 Run all Ansible 角色

您可以在 Run Ansible roles 页面中查看 Ansible 作业的状态。要重新运行作业,请点 Rerun 按钮。

2.7. 在检查模式中运行 Ansible 角色

您可以通过卫星 Web UI 在检查模式下运行 Ansible 角色。

前提条件

流程

  1. 在 Satellite Web UI 中,导航到 Hosts &gt ; All Hosts
  2. Edit for the host to enable the check mode。
  3. Parameters 选项卡中,确保主机有一个名为 ansible_roles_check_mode 的参数,类型为 布尔值 设为 true
  4. Submit

第 3 章 配置和设置远程作业

使用本节作为配置卫星在远程主机上执行作业的指南。

要应用到远程主机的任何命令都必须定义为作业模板。在定义了作业模板后,您可以多次执行它。

3.1. 关于在主机上运行作业

您可以使用 shell 脚本或 Ansible 任务和 playbook 远程对主机运行作业。这称为远程执行。

对于您创建的自定义 Ansible 角色或您下载的角色,您必须安装包含胶囊基础操作系统上角色的软件包。在使用 Ansible 角色前,您必须将角色从安装它们的胶囊导入到卫星中。

通信通过胶囊服务器进行,这意味着卫星服务器不需要直接访问目标主机,并可扩展到管理许多主机。更多信息请参阅 第 3.4 节 “远程执行的传输模式”

卫星使用 ERB 语法作业模板。有关更多信息,请参阅管理主机中的模板编写参考

默认包括用于 shell 脚本和 Ansible 的几个作业模板。如需更多信息,请参阅管理主机中的设置作业模板

注意

任何胶囊服务器基础操作系统都是卫星服务器的内部胶囊的客户端,因此本节适用于连接到卫星服务器的任何类型的主机,包括胶囊。

您可以一次在多个主机上运行作业,并且可以使用命令中的变量来更精细地控制您运行的作业。您可以使用主机事实和参数来填充变量值。

另外,您可以在运行 命令时为模板指定自定义值。

如需更多信息,请参阅 管理主机 中的 执行远程作业

3.2. 远程执行工作流

当您在主机上运行远程作业时,卫星将执行以下操作来查找要使用的远程执行胶囊。

卫星仅搜索启用了 Ansible 功能的胶囊。

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

如果您已启用了 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。这可确保卫星在主机上由他们注册到的胶囊执行 REX 作业。

如果卫星没有在此阶段发现远程执行胶囊,并且启用了 Fallback 到任何胶囊 设置,卫星会添加另一组胶囊来从中选择远程执行胶囊。Satellite 从分配给主机的以下胶囊类型选择最轻加载的胶囊:

  • 分配给主机的子网的 DHCP、DNS 和 TFTP 胶囊
  • 分配给主机的域的 DNS 胶囊
  • 分配给主机域的域胶囊
  • Puppet 服务器胶囊
  • Puppet CA Capsule
  • OpenSCAP Capsule

如果卫星没有在此阶段发现远程执行胶囊,如果启用了 Enable Global Capsule 设置,卫星会从主机的组织中的所有胶囊集中选择加载的远程执行胶囊。

3.3. 远程执行的权限

您可以控制哪些角色可以运行基础架构中哪些作业,包括哪些主机可以作为目标。远程执行功能提供了两个内置角色:

  • 远程执行管理器 :可以访问所有远程执行功能和功能。
  • 远程执行用户 :只能运行作业。

您可以克隆 Remote Execution User 角色,并自定义其过滤器,以增加粒度。如果您使用自定义角色上的 view_job_templates 权限调整过滤器,则只能根据匹配的作业模板查看和触发作业。您可以使用 view_hostsview_smart_proxies 权限来限制角色可见的主机或胶囊。

execute_template_invocation 权限是一个特殊权限,在执行作业开始前立即检查该权限。此权限可定义您可以在特定主机上运行的作业模板。这可在指定权限时提高粒度。

您可以针对红帽卫星运行远程执行作业,并在主机中注册为带有 execute_jobs_on_infrastructure_hosts 权限的胶囊。默认情况下,标准的 ManagerSite Manager 角色已具有这个权限。如果您使用 ManagerSite 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

使用本例中的第一行将 Reboot 模板应用到一个选定的主机。使用第二行定义一个主机池,其名称以 .staging.example.com 结尾。使用第三行将模板与主机组绑定。

注意

分配给具有这些角色的用户的权限可能会随着时间而变化。如果您已调度了一些作业在将来运行,并且权限更改,这可能会导致执行失败,因为在作业执行前会立即检查权限。

3.4. 远程执行的传输模式

您可以将卫星配置为使用两种不同的传输模式进行远程作业执行。

ssh 模式下,远程执行使用 SSH 服务传输作业详情。这是默认的传输模式。SSH 服务必须在目标主机上启用并激活。远程执行胶囊必须有权访问目标主机上的 SSH 端口。除非具有不同的设置,否则标准的 SSH 端口是 22。

pull-mqtt 模式的胶囊上,远程执行使用 Message Queueing Telemetry Transport (MQTT)来发布它从卫星服务器接收的作业。主机使用 yggdrasil 拉取客户端,在胶囊上订阅 MQTT 代理以进行作业通知。主机收到通知后,它会通过 HTTPS 从胶囊中提取作业详情,运行作业,并将结果报告回胶囊。

要使用 pull-mqtt 模式,您必须在胶囊服务器上启用它,并在目标主机上配置 pull 客户端。

其他资源

3.5. 配置主机以使用 Pull 客户端

对于配置为使用 pull-mqtt 模式的胶囊,主机可以使用远程执行 pull客户端订阅远程作业。受管主机不需要与其胶囊服务器建立 SSH 连接。

前提条件

  • 您已将主机注册到卫星。
  • 主机的胶囊配置为使用 pull-mqtt 模式。如需更多信息,请参阅安装 Capsule 服务器中的为 Pull 客户端配置远程执行
  • 红帽卫星客户端 6 存储库在卫星服务器上启用并同步,并在主机上启用。
  • 主机可以使用端口 1883 与 MQTT 与其胶囊通信。
  • 主机可以通过 HTTPS 与胶囊通信。
注意

创建 katello-pull-transport-migrate 软件包,帮助用户从 Katello Agent 迁移到使用 pull 客户端的远程执行。但是,主机上安装了 Katello Agent 并不是必需的。无论安装了 Katello Agent,都可以使用 katello-pull-transport-migrate

流程

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

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

      # dnf install katello-pull-transport-migrate
    • On Red Hat Enterprise Linux 7 hosts:

      # yum install katello-pull-transport-migrate

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

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

    # systemctl status yggdrasild
  3. 可选:在安装软件包后,您可以从主机中删除 katello-agent

    警告

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

3.6. 创建作业模板

使用此流程创建作业模板。要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程

流程

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

3.7. 根据名称导入 Ansible Playbook

您可以从胶囊上安装的集合,将名称导入到卫星,以导入 Ansible playbook。

前提条件

  • 卫星中的 Ansible 插件已启用

流程

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

    # curl -X GET 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/fetch?proxy_id=My_capsule_ID
  2. 选择您要导入的 Ansible playbook 并记下其名称。
  3. 使用名称导入 Ansible playbook:

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

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

3.8. 导入所有可用 Ansible Playbook

您可以从胶囊上安装的集合将所有可用 Ansible playbook 导入到卫星。

前提条件

  • 卫星中的 Ansible 插件已启用

流程

  • 使用以下 API 请求导入 Ansible playbook:

    # curl -X PUT 'Content-Type: application/json' https://satellite.example.com/ansible/api/v2/ansible_playbooks/sync?proxy_id=My-capsule-ID

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

3.9. 在卫星中将 Fallback 配置为任何胶囊远程执行设置

您可以启用 Fallback to Any Capsule 设置,将卫星配置为从分配给主机的胶囊列表中搜索远程执行胶囊。如果您需要在没有配置子网的主机上运行远程作业,或者将主机的子网分配给未启用远程执行功能的胶囊,这将非常有用。

如果启用了 Fallback 到 Any Capsule 设置,卫星会添加另一组胶囊来从中选择远程执行胶囊。Satellite 还从分配给主机的所有胶囊集选择最轻量加载的胶囊,如下所示:

  • 分配给主机的子网的 DHCP、DNS 和 TFTP 胶囊
  • 分配给主机的域的 DNS 胶囊
  • 分配给主机域的域胶囊
  • Puppet 服务器胶囊
  • Puppet CA Capsule
  • OpenSCAP Capsule

流程

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

CLI 过程

  • 在卫星中输入 hammer 设置 命令,将 Fallback 配置为将 Fallback 配置为任何胶囊 设置。要将值设为 true,输入以下命令:

    # hammer settings set \
    --name=remote_execution_fallback_proxy \
    --value=true

3.10. 在卫星中配置全局胶囊远程执行设置

默认情况下,卫星会在主机的组织和位置中搜索远程执行胶囊,无论胶囊是分配给主机的子网。如果要将搜索限制到分配给主机的子网的胶囊,您可以禁用 Enable Global Capsule 设置。

如果启用了 Enable Global Capsule 设置,卫星添加了另一组胶囊,以选择远程执行胶囊。卫星还从主机的组织及位置的所有胶囊集选择最轻量加载的远程执行胶囊,以执行远程作业。

流程

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

CLI 过程

  • 在卫星 中输入 hammer 设置 命令以配置 Enable Global Capsule 设置。要将值设为 true,输入以下命令:

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

3.11. 配置卫星以使用其他目录在主机上执行远程作业

Ansible 将自己的文件放在 $HOME/.ansible/tmp 目录中,其中 $HOME 是远程用户的主目录。如果需要,您可以选择设置其他目录。

流程

  1. 创建新目录:

    # mkdir /My_Remote_Working_Directory
  2. 从默认 var 目录中复制 SELinux 上下文:

    # chcon --reference=/var /My_Remote_Working_Directory
  3. 将系统配置为:

    # satellite-installer \
    --foreman-proxy-plugin-ansible-working-dir /My_Remote_Working_Directory

3.12. 更改权限提升方法

默认情况下,基于推送的远程执行使用 sudo 从 SSH 用户切换到在主机上执行脚本的有效用户。在某些情况下,您可能需要使用其他方法,如 sudzdo。您可以在 Satellite 设置中全局配置替代方法。

前提条件

  • 您的用户帐户分配了一个授予 view_settingsedit_settings 权限的角色。
  • 如果要将 dzdo 用于 Ansible 作业,请确保已安装了包含所需 dzdo become 插件的 community.general Ansible 集合。如需更多信息,请参阅 Ansible 文档中的安装 集合

流程

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

3.13. 为远程执行分发 SSH 密钥

对于 ssh 模式中的胶囊,远程执行连接是使用 SSH 进行身份验证。胶囊中的公共 SSH 密钥必须分发到您要管理的附加主机上。

确保 SSH 服务已经启用并在主机上运行。配置任何基于网络的或基于主机的防火墙,以启用对端口 22 的访问。

使用以下任一方法将公共 SSH 密钥从胶囊分发到目标主机:

卫星将远程执行功能的 SSH 密钥分发到默认情况下从卫星调配的主机。

如果主机在 Amazon Web Services 上运行,请启用密码身份验证。如需更多信息,请参阅 新用户帐户

3.14. 为远程执行分发 SSH 密钥

要手动分发 SSH 密钥,请完成以下步骤:

流程

  • 将 SSH 公钥从 Capsule 复制到您的目标主机:

    # ssh-copy-id -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy.pub root@client.example.com

    对您要管理的每个目标主机重复此步骤。

验证

  • 要确认密钥已成功复制到目标主机,请在 Capsule 上输入以下命令:

    # ssh -i ~foreman-proxy/.ssh/id_rsa_foreman_proxy root@client.example.com

3.15. 使用 Satellite API Obtain SSH Keys 进行远程执行

要使用 Satellite API 从胶囊下载公钥,请在每个目标主机上完成这个步骤。

流程

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

    # mkdir ~/.ssh
  2. 从胶囊下载 SSH 密钥:

    # curl https://capsule.example.com:9090/ssh/pubkey >> ~/.ssh/authorized_keys
  3. 配置 ~/.ssh 目录的权限:

    # chmod 700 ~/.ssh
  4. authorized_keys 文件配置权限:

    # chmod 600 ~/.ssh/authorized_keys

3.16. 在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥

您可以在自定义 Kickstart 模板中添加 remote_execution_ssh_keys 片断,以便在置备过程中将 SSH 密钥部署到主机。默认情况下,卫星附带的 Kickstart 模板包括此代码片段。Satellite 在调配期间将用于远程执行的 SSH 密钥复制到系统。

流程

  • 要在新置备的主机中包含公钥,请在您使用的 Kickstart 模板中添加以下代码片段:

    <%= snippet 'remote_execution_ssh_keys' %>

3.17. 为 Kerberos Ticket Granting Tickets 配置 keytab

使用这个流程将 Satellite 配置为使用 keytab 来获取 Kerberos ticket 授权问题单。如果没有设置 keytab,您必须手动检索 ticket。

流程

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

    # id -u foreman-proxy
  2. 修改 umask 值,以便新文件具有权限 600:

    # umask 077
  3. 为 keytab 创建目录:

    # mkdir -p "/var/kerberos/krb5/user/My_User_ID"
  4. 创建 keytab 或将现有 keytab 复制到目录中:

    # cp My_Client.keytab /var/kerberos/krb5/user/My_User_ID/client.keytab
  5. 将目录所有者更改为 foreman-proxy 用户:

    # chown -R foreman-proxy:foreman-proxy "/var/kerberos/krb5/user/My_User_ID"
  6. 确保 keytab 文件是只读的:

    # chmod -wx "/var/kerberos/krb5/user/My_User_ID/client.keytab"
  7. 恢复 SELinux 上下文:

    # restorecon -RvF /var/kerberos/krb5

3.18. 为远程执行配置 Kerberos 身份验证

您可以使用 Kerberos 身份验证来建立在卫星主机上远程执行的 SSH 连接。

前提条件

  • 在 Kerberos 服务器中注册 Satellite 服务器
  • 在 Kerberos 服务器中注册 Satellite 目标主机
  • 配置并初始化用于远程执行的 Kerberos 用户帐户
  • 确保 Satellite 上的 foreman-proxy 用户具有有效的 Kerberos ticket 授权票据

流程

  1. 要安装并启用 Kerberos 验证进行远程执行,请输入以下命令:

    # satellite-installer --scenario satellite \
    --foreman-proxy-plugin-remote-execution-script-ssh-kerberos-auth true
  2. 要编辑用于远程执行的默认用户,请在 Satellite Web UI 中进入到 Administer > Settings 并点 Remote Execution 选项卡。在 SSH User 行中,编辑第二列并添加 Kerberos 帐户的用户名。
  3. 导航到 remote_execution_effective_user,再编辑第二列以添加 Kerberos 帐户的用户名。

验证

  • 要确认 Kerberos 身份验证已准备好使用,请在主机上运行远程作业。如需更多信息,请参阅在 Red Hat Satellite 中使用 Ansible 集成管理配置中的执行远程作业

3.19. 设置作业模板

Satellite 提供了可用于执行作业的默认作业模板。要查看作业模板列表,请导航到 Hosts > Job templates。如果要使用没有经过改变的模板,执行管理主机中的执行一个远程作业

您可以使用默认模板作为自行开发的基础。默认任务模板已锁定以供编辑。克隆模板并编辑克隆。

流程

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

作业模板使用嵌入式 Ruby (ERB)语法。有关编写模板的更多信息,请参阅管理主机中的模板编写参考

Ansible 注意事项

要创建 Ansible 作业模板,请使用以下步骤而不是 ERB 语法,请使用 YAML 语法。以 --- 开始模板。您可以将 Ansible playbook YAML 文件嵌入到作业模板正文中。您还可以添加 ERB 语法来自定义 YAML Ansible 模板。您还可以在卫星中导入 Ansible playbook。如需更多信息,请参阅管理主机中的同步存储库模板

参数变量

在运行时,作业模板可以接受您为主机定义的参数变量。请注意,只有主机编辑页面中的 Parameters 选项卡上的参数可以用作作业模板的输入参数。如果您不希望 Ansible 作业模板在运行时接受参数变量,请在卫星 Web UI 中导航到 Administer > Settings 并点 Ansible 选项卡。在 顶级 Ansible 变量 行中,将 Value 参数更改为 No

3.20. 执行远程作业

您可以针对一个或多个主机执行基于作业模板的作业。

要使用 CLI 而不是 Satellite Web UI,请参阅 CLI 过程

流程

  1. 在 Satellite Web UI 中,进入 Hosts > All Hosts 并选择您要在其上执行远程作业的目标主机。您可以使用 search 字段来过滤主机列表。
  2. Select Action 列表中,选择 Schedule a Job
  3. Job invocation 页面中,定义主作业设置:
  4. 选择要使用的 Job categoryJob template
  5. 可选:在 Bookmark 列表中选择一个存储的搜索字符串来指定目标主机。
  6. 可选:通过输入搜索查询来限制目标主机。系统将 解析到 行,显示受查询影响的主机数量。使用刷新按钮在更改查询后重新计算数字。preview 图标列出了目标主机。
  7. 剩余的设置取决于所选作业模板。如需有关在模板中添加自定义参数的信息,请参阅创建作业模板
  8. 可选: 要为作业配置高级设置,请点击 Display advanced fields。有些高级设置依赖于作业模板,以下设置是常规的:

    • 有效的用户 定义了执行作业的用户,默认为 SSH 用户。
    • 并发级别定义 一次执行的最大作业数,这样可防止在大量主机上执行作业时防止超载系统资源。
    • 终止的 超时 会定义作业应终止的时间间隔(如果尚未完成)。在定义的时间间隔期间无法启动的任务,例如,如果上一任务用了很长时间才能完成,则会取消。
    • 查询类型定义了搜索查询 何时被评估。这有助于保持查询最新调度任务。
    • 执行排序 决定了在主机上执行作业的顺序:字母或随机化。

      并发级别 和超时, 可以终止设置,以便根据基础架构硬件和需求定制作业执行。

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

CLI 过程

  1. 在 Satellite 上输入以下命令:

    # hammer settings set \
    --name=remote_execution_global_proxy \
    --value=false
  2. 查找您要使用的任务模板的 ID:

    # hammer job-template list
  3. 显示模板详情以查看模板所需的参数:

    # hammer job-template info --id My_Template_ID
  4. 使用自定义参数执行远程作业:

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

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

3.21. 为主机调度周期性 Ansible 作业

您可以计划周期性作业,以在主机上运行 Ansible 角色。

前提条件

  • 确保您有 view_foreman_tasksview_job_invocationsview_recurring_logics 权限。

流程

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

3.22. 为主机组调度周期性 Ansible 作业

您可以计划周期性作业,以在主机组上运行 Ansible 角色。

流程

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

3.23. 监控作业

您可以在作业运行时监控作业的进度。这对可能需要进行的任何故障排除有所帮助。

Ansible 作业批量运行 100 个主机,因此您无法取消特定主机上运行的作业。只有在 Ansible playbook 在批处理中的所有主机上运行后,作业才完成。

流程

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

CLI 过程

  1. 查找作业的 ID:

    # hammer job-invocation list
  2. 监控作业输出:

    # hammer job-invocation output \
    --host "My_Host_Name" \
    --id My_Job_ID
  3. 可选: 要取消作业,请输入以下命令:

    # hammer job-invocation cancel \
    --id My_Job_ID

第 4 章 集成 Red Hat Satellite 和 Ansible Automation Controller

您可以集成 Red Hat Satellite 和 Ansible Automation Controller,以使用 Satellite 服务器作为 Ansible Automation Controller 的动态清单源。Ansible Automation Controller 是 Red Hat Ansible Automation Platform 的一个组件。

您还可以使用置备回调功能,从主机或 Ansible Automation Controller 在由 Satellite 管理的主机上运行 playbook。从 Satellite 服务器置备新主机时,您可以使用置备回调功能从 Ansible Automation Controller 触发 playbook 运行。playbook 在置备过程后配置主机。

4.1. 将 Satellite 服务器添加到 Ansible Automation Controller 中作为 Dynamic Inventory Item

要将 Satellite 服务器作为动态清单项目添加到 Ansible Automation Controller 中,您必须在 Ansible Automation Controller 上为 Satellite Server 用户创建一个凭证,将 Ansible Automation Controller 用户添加到凭据中,然后配置清单源。

前提条件

  • 如果您的 Satellite 部署庞大,例如,管理数以千计的主机,使用非管理员用户可能会因为在授权检查期间可能出现可能出现的性能造成负面影响。对于大型部署,请考虑使用管理员用户。
  • 对于非管理员用户,您必须将 Ansible Tower 清单 Reader 角色分配给卫星服务器用户。有关管理用户、角色和权限过滤器的更多信息,请参阅管理 Red Hat Satellite 中的创建和管理角色
  • 您必须在同一网络或子网上托管 Satellite 服务器和 Ansible Automation Controller。

流程

  1. 在 Ansible Automation Controller Web UI 中,为您的 Satellite 创建凭证。有关创建凭证的更多信息,请参阅 自动化控制器用户指南中的 添加新 凭证和 Red Hat Satellite 凭证

    表 4.1. Satellite 凭证

    凭证类型Red Hat Satellite 6

    Satellite URL:

    https://satellite.example.com

    用户名

    Satellite 用户的用户名及集成角色。

    密码

    Satellite 用户的密码。

  2. 将 Ansible Automation Controller 用户添加到新凭据。有关将用户添加到凭证的更多信息,请参阅 自动化控制器用户指南中的 凭证入门
  3. 添加新清单。如需更多信息,请参阅 自动化控制器用户指南中的添加新清单http://docs.ansible.com/automation-controller/latest/html/userguide/inventories.html#add-a-new-inventory
  4. 在新清单中,将卫星服务器添加为清单源,并指定以下清单源选项:如需更多信息,请参阅 自动化控制器用户指南中的添加源https://docs.ansible.com/automation-controller/latest/html/userguide/inventories.html#add-source

    表 4.2. 清单源选项

    Red Hat Satellite 6

    凭证

    为卫星服务器创建的凭据。

    覆盖

    选择

    覆盖变量

    选择

    启动时更新

    选择

    缓存超时

    90

  5. 确保同步您添加的源。

4.2. 为主机配置置备回调

在 Satellite 中创建主机时,您可以使用 Ansible Automation Controller 运行 playbook 来配置新创建的主机。这在 Ansible Automation Controller 中称为 置备回调

置备回调功能会触发从 Ansible Automation Controller 运行 playbook,作为置备过程的一部分。playbook 在置备过程后配置主机。

有关置备回调的更多信息,请参阅 自动化控制器用户指南中的 部署回调

在 Satellite 服务器中,Kickstart 默认Kickstart 默认完成 模板包含三个片断:

  1. ansible_provisioning_callback
  2. ansible_tower_callback_script
  3. ansible_tower_callback_service

您可以将参数添加到主机或主机组,以提供这些代码片段可用于在新创建的主机上运行 Ansible playbook 的凭证。

前提条件

在配置置备回调前,您必须将 Satellite 添加为 Ansible Automation Controller 中的动态清单。如需更多信息,请参阅 集成 Satellite 和 Ansible Automation Controller

在 Ansible Automation Controller web UI 中,您必须完成以下任务:

  1. 为您的新主机创建计算机凭据。确保您在计划分配给您在卫星中创建的主机的凭据中输入相同的密码。如需更多信息,请参阅 自动化控制器用户指南中的 添加新凭据
  2. 创建一个项目。有关更多信息,请参阅 Ansible Automation Controller 用户指南中的 项目。
  3. 将作业模板添加到您的项目中。如需更多信息,请参阅 自动化控制器用户指南中的 作业模板
  4. 在作业模板中,您必须启用置备回调,生成主机配置密钥,并记录作业模板的 template_ID。有关作业模板的更多信息,请参阅 自动化控制器用户指南中的 作业模板

流程

  1. 在 Satellite Web UI 中,进入 Configure > Host Group
  2. 创建主机组或编辑现有主机组。
  3. 在主机组窗口中,单击 参数 选项卡。
  4. Add Parameter
  5. 输入每个新参数的以下信息:

    表 4.3. 主机参数

    名称Description

    ansible_tower_provisioning

    true

    启用调配回调。

    ansible_tower_fqdn

    controller.example.com

    Ansible Automation Controller 的完全限定域名(FQDN)。不要添加 https,因为这由 Satellite 附加。

    ansible_job_template_id

    template_ID

    您可以在模板的 URL 中找到的调配模板的 ID: /templates/job_template/5

    ansible_host_config_key

    config_KEY

    作业模板在 Ansible Automation Controller 中生成的主机配置密钥。

  6. Submit
  7. 使用 主机组创建主机。
  8. 在新主机上输入以下命令启动 ansible-callback 服务:

    # systemctl start ansible-callback
  9. 在新主机上,输入以下命令输出 ansible-callback 服务的状态:

    # systemctl status ansible-callback

    如果命令返回以下输出,则置备回调会被正确配置:

    SAT_host systemd[1]: Started Provisioning callback to Ansible Automation Controller...

手动置备回调

  • 您可以使用主机的置备回调 URL 和主机配置密钥来调用 Ansible Automation Controller:

    # curl -k -s --data curl --insecure --data host_config_key=my_config_key \
    https://controller.example.com/api/v2/job_templates/8/callback/

    在进入置备回调 URL 时,请确保使用 https

这会触发为主机在模板中指定的 playbook 运行。

第 5 章 作业模板示例和扩展

使用本节作为帮助修改、自定义和扩展作业模板以满足您的要求的引用。

5.1. 自定义作业模板

创建作业模板时,您可以在模板编辑器字段中包含一个现有模板。这样,您可以组合模板,或者从一般的模板创建更为具体的模板。

以下模板组合了默认模板,以在客户端上安装和启动 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") %>

使用以上模板,您必须从渲染的模板导入参数定义。为此,请导航到 Jobs 选项卡,单击 Add Foreign Input Set,然后从 Target template 列表中选择呈现的模板。您可以导入所有参数或指定以逗号分开的列表。

5.2. 默认任务模板类别

作业模板类别Description

软件包

用于执行与软件包相关的操作的模板。默认情况下会包括安装、更新和删除操作。

Puppet

用于在目标主机上运行 Puppet 的模板。

power

执行与电源相关的操作的模板。默认包括重启和关闭操作。

命令

用于在远程主机上执行自定义命令的模板。

服务

用于执行服务相关操作的模板。默认包括 start、stop、restart 和 status 操作。

Katello

用于执行内容相关操作的模板。这些模板主要与卫星 Web UI 的不同部分(例如,内容主机的批量操作 UI)使用,但可以单独用于执行勘误表安装等操作。

5.3. restorecon 模板示例

本例演示了如何创建名为 Run Command - restorecon 的模板,用于恢复目标主机上所选目录中所有文件的默认 SELinux 上下文。

流程

  1. 在 Satellite Web UI 中,导航到 Hosts > Job templates。单击 New Job Template
  2. Name 字段中输入 Run Command - restorecon。选择 Default,使模板可供所有组织使用。在模板编辑器中添加以下文本:

    restorecon -RvF <%= input("directory") %>

    & lt;%= input ("directory")% > 字符串在作业调用期间被用户定义的目录替代。

  3. Job 选项卡上,将 Job category 设置为 Commands
  4. 单击 Add Input 以允许作业自定义。在 Name 字段中输入 目录。输入名称必须与模板编辑器中指定的值匹配。
  5. 单击 Required,以便在没有用户指定参数的情况下无法执行命令。
  6. Input type 列表中选择 User input。输入在作业调用期间要显示的描述,如 Target directory for restorecon
  7. Submit。如需更多信息,请参阅管理主机中的在多个主机上执行 restorecon 模板

5.4. 渲染 restorecon 模板

本例演示了如何创建从 Example restorecon Template 中创建的 Run command - restorecon 模板派生出的模板。此模板在在作业执行时不需要用户输入,它将在目标主机上的 /home/ 目录下的所有文件中恢复 SELinux 上下文。

按照 设置作业模板 所述创建新模板,并在模板编辑器中指定以下字符串:

<%= render_template("Run Command - restorecon", :directory => "/home") %>

5.5. 在多个主机上执行 restorecon 模板

本例演示了如何在多个主机中在基于示例 restorecon 模板中创建的模板运行作业。作业在 /home/ 目录下的所有文件中恢复 SELinux 上下文。

流程

  1. 在 Satellite Web UI 中,进入 Hosts > All hosts 并选择 target hosts。从 Select Action 列表中,选择 Schedule Remote Job
  2. Job invocation 页面中,选择 Commands 作业类别和 Run Command - restorecon 作业模板。
  3. 目录 字段中键入 /home
  4. Schedule 设置为 Execute now
  5. Submit。您要进入 Job invocation 页面,您可以在其中监控作业执行的状态。

5.6. 模板中包括 Power Actions

本例演示了如何设置作业模板来执行电源操作,如重启。此过程可防止 Satellite 将重新引导时断开连接异常解释为错误,因此远程执行作业可以正常工作。

按照 设置作业模板 所述创建新模板,并在模板编辑器中指定以下字符串:

<%= render_template("Power Action - SSH Default", :action => "restart") %>

法律通告

Copyright © 2024 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.