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

流程

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

2. 在您要在主机上运行 Ansible 角色的所有胶囊服务器上，启用 Ansible 插件：

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

   Copy to Clipboard Toggle word wrap
3. 分发 SSH 密钥，以启用胶囊，以使用 SSH 连接到主机。如需更多信息，请参阅管理主机中的为远程执行分配 SSH 密钥。卫星运行 Ansible 角色的方式与运行远程执行作业的方式相同。
4. 将 Ansible 角色导入到卫星。
5. 继续 第 2 章 使用 Ansible 角色在客户端上自动化重复任务。

流程

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

流程

1. 在 Satellite Web UI 中，导航到 Configure > Variables。
2. 选择您要通过 Satellite 覆盖和管理的 Ansible 变量。
3. 在 Default Behavior 区域中，选中 Override 复选框。
4. 在 Parameter Type 字段中，选择验证的值类型，如 字符串或 布尔值。type 数组 和 hash 在变量匹配时具有进一步处理的选项。如需更多信息，请参阅 以下优先级 属性顺序 区域。
5. 在 Default Value 字段中，如果变量没有匹配项，请输入您要使用的默认值。
6. 可选：如果您不想在 Satellite Web UI 中以纯文本形式显示变量的值，请选择 Hidden Value 复选框，以将变量的值显示为星号。这可用于密码或机密令牌等敏感值。

7. 可选：扩展 Optional Input Validator 区域，并指定用于验证变量的具体值的条件：

   • 如果要强制用户填写此变量，请选择 Required。

   • 在 Validator Type 字段中，选择如何验证值：

     • list - 值将根据允许的值的枚举进行验证。
     • regex - 值将根据正则表达式模式进行验证。

8. 可选： 优先级属性顺序 区域中，指定优先级顺序，按主机属性与主机匹配。top 的顺序具有较高的优先级。第一个匹配项胜出。

   您可以使用逗号作为 AND 操作将多个属性组合成单个匹配键。例如，hostgroup 的 matcher 键，环境 预期匹配者，如 hostgroup = "web servers" AND environment = production。

   如果使用参数类型 数组 或 哈希，您可以进一步设置：

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

将变量添加到主机

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

将变量添加到主机组

1. 在 Satellite Web UI 中，导航到 Configure > Host Groups，然后选择您要使用的主机组。
2. 单击 Parameters 选项卡，然后在 Host Group 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. 确保启用了以下软件仓库：

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

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

     Copy to Clipboard Toggle word wrap

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

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

     # subscription-manager repos --enable=rhel-7-server-extras-rpms

     Copy to Clipboard Toggle word wrap

2. 安装 rhel-system-roles 软件包：

   # satellite-maintain packages install rhel-system-roles

   Copy to Clipboard Toggle word wrap

   rhel-system-roles 软件包下载到 /usr/share/ansible/roles/。您可以在导入前查看并记录您想要文件的任何修改。

3. 在 Satellite Web UI 中，导航到 Configure > Roles，再点击包含您要导入的角色的 Capsule。
4. 从 Ansible 角色列表中，选中您要导入的角色的复选框，然后单击 Update。

流程

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

   Copy to Clipboard Toggle word wrap

   如需更多信息，请参阅 Galaxy 用户指南中的 从同一 requirements.yml 文件安装角色和集合。

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。

流程

1. 如果您自定义 /etc/ansible/ansible.cfg，请将配置从 /etc/ansible/ansible.cfg 复制到 /usr/share/foreman-proxy/.ansible.cfg。

2. 使用 ansible-vault 命令加密敏感文件：

   # ansible-vault encrypt /etc/ansible/roles/Role_Name/vars/main.yml

   Copy to Clipboard Toggle word wrap

   请注意，ansible-vault 将文件权限改为 600。

3. 更改加密文件的组和权限，以确保 foreman-proxy 用户可以读取它：

   # chgrp foreman-proxy /etc/ansible/roles/Role_Name/vars/main.yml
   # chmod 0640 /etc/ansible/roles/Role_Name/vars/main.yml

   Copy to Clipboard Toggle word wrap
4. 创建 /usr/share/foreman-proxy/.ansible_vault_password 文件，并在其中输入 Vault 密码。

5. 更改 .ansible_vault_password 文件的用户和权限，以确保只有 foreman-proxy 用户可以读取它：

   # chown foreman-proxy:foreman-proxy /usr/share/foreman-proxy/.ansible_vault_password
   # chmod 0400 /usr/share/foreman-proxy/.ansible_vault_password

   Copy to Clipboard Toggle word wrap

6. 将 Vault 密码文件的路径添加到 /usr/share/foreman-proxy/.ansible.cfg 中的 [defaults] 部分：

   [defaults]
   vault_password_file = /usr/share/foreman-proxy/.ansible_vault_password

   Copy to Clipboard Toggle word wrap

   Vault 密码文件的路径必须是绝对的。

流程

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

流程

1. 在 Satellite Web UI 中，导航到 Hosts > All Hosts。
2. 选择主机，然后单击 编辑。
3. 选择 Ansible Roles 选项卡。
4. 在 Assigned Ansible Roles 区域中，单击 - 图标，将角色从主机移除。重复删除更多角色。
5. 点 Submit。

流程

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

流程

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

流程

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

流程

1. 在 Satellite Web UI 中，导航到 Configure > Host Groups。
2. 从主机组的 Actions 列中的列表，选择 Run all Ansible roles。

流程

1. 在 Satellite Web UI 中，导航到 Hosts &gt ; All Hosts。
2. 为您要为其启用检查模式的主机点 Edit。
3. 在 Parameters 选项卡中，确保主机具有名为 ansible_roles_check_mode 的参数，其 type 布尔值 设为 true。
4. 点 Submit。

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

流程

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

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

     # dnf install katello-pull-transport-migrate

     Copy to Clipboard Toggle word wrap

   • On Red Hat Enterprise Linux 7 hosts:

     # yum install katello-pull-transport-migrate

     Copy to Clipboard Toggle word wrap

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

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

   # systemctl status yggdrasild

   Copy to Clipboard Toggle word wrap

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

   警告

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

流程

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

流程

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

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

   Copy to Clipboard Toggle word wrap
2. 选择您要导入的 Ansible playbook 并记下其名称。

3. 使用名称导入 Ansible playbook：

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

   Copy to Clipboard Toggle word wrap

   导入完成后，您将在 Satellite Web UI 中获取通知。

流程

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

流程

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

流程

1. 在 Satellite 服务器或 Capsule 服务器上创建新目录：

   # mkdir /My_Remote_Working_Directory

   Copy to Clipboard Toggle word wrap

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

   # chcon --reference=/tmp /My_Remote_Working_Directory

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

流程

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

1. 第 4.14 节 “为远程执行发布 SSH 密钥”.
2. 第 4.16 节 “使用 Satellite API 为远程执行提供 SSH 密钥”.
3. 第 4.17 节 “在置备过程中将 Kickstart 模板配置为分布式 SSH 密钥”.
4. 对于新的 Satellite 主机，您可以使用全局注册模板在注册过程中将 SSH 密钥部署到 Satellite 主机。如需更多信息，请参阅管理主机中的使用全局注册模板将主机注册到 Red Hat Satellite。

流程

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

   # mkdir ~/.ssh

   Copy to Clipboard Toggle word wrap

2. 从 Capsule 下载 SSH 密钥：

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

   Copy to Clipboard Toggle word wrap

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

   # chmod 700 ~/.ssh

   Copy to Clipboard Toggle word wrap

4. 为 authorized_keys 文件配置权限：

   # chmod 600 ~/.ssh/authorized_keys

   Copy to Clipboard Toggle word wrap

流程

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

   # id -u foreman-proxy

   Copy to Clipboard Toggle word wrap

2. 修改 umask 值，以便新文件具有权限 600 ：

   # umask 077

   Copy to Clipboard Toggle word wrap

3. 为 keytab 创建目录：

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

6. 确保 keytab 文件为只读：

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

   Copy to Clipboard Toggle word wrap

7. 恢复 SELinux 上下文：

   # restorecon -RvF /var/kerberos/krb5

   Copy to Clipboard Toggle word wrap

流程

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

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

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

流程

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

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Jobs 并点 Run job。

   注意

   卫星 6.13 具有新的作业向导。如果要使用早期 Satellite 版本中的作业向导，请单击作业向导右上角的 Use legacy 表单。请注意，本指南仅适用于新的作业向导。

2. 选择 Job category 和要使用的 Job 模板，然后单击 Next。

3. 选择您要在其上运行作业的主机。如果您没有选择任何主机，该作业将在当前上下文中可在所有主机上运行。

   注意

   如果要选择主机组及其所有子组，则不能选择主机组，因为该作业只会直接在该组的主机上运行，而不在子组中的主机上运行。反之，您必须选择主机组及其所有子组，或者使用此搜索查询：

   hostgroup_fullname ~ "My_Host_Group*"

   Copy to Clipboard Toggle word wrap

   将 My_Host_Group 替换为顶级主机组的名称。

4. 如果需要，请为作业模板提供输入。不同的模板有不同的输入，有些模板没有任何输入。输入所有必需的输入后，点 Next。
5. 可选： 要为作业配置高级设置，请填写 Advanced 字段。要了解更多有关高级设置的信息，请参阅 第 4.22 节 “作业向导中的高级设置”。
6. 点击 Next。

7. 作业计划时间。

   • 要立即执行作业，请保留预先选择的 Immediate 执行。
   • 要在以后执行作业，请选择 Future execution。
   • 要定期执行作业，请选择 Recurring execution。

8. 可选：如果您选择将来的或重复执行，请选择 Query 类型，否则点 Next。

   • 静态查询 意味着作业对您提供的主机的确切列表执行。
   • 动态查询 表示仅在执行作业前评估主机列表。如果您根据某些过滤器输入主机列表，则在首次使用该过滤器时结果可能会有所不同。

   选择查询类型后，单击 Next。

9. 可选：如果您选择的未来或重复执行，请提供额外的详情：

   • 对于未来执行，请输入开始时间和 时间。您还可以选择在日期和时间 之前选择 Starts。如果作业在该时间之前无法启动，它将被取消。
   • 对于 周期性执行，请选择开始日期和时间、频率以及结束周期性作业的条件。您可以选择永远不会结束、在特定时间结束，或者在指定次数的重复后结束。您还可以添加 Purpose - 跟踪作业的特殊标签。一次只能有一个具有给定目的的活跃作业。

   输入所需信息后，点 Next。

10. 查看作业详情。您可以选择返回到作业向导的任意部分，并编辑信息。
11. 单击 Submit 以计划执行的作业。

CLI 过程

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

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

   Copy to Clipboard Toggle word wrap

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

   # hammer job-template list

   Copy to Clipboard Toggle word wrap

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

   # hammer job-template info --id My_Template_ID

   Copy to Clipboard Toggle word wrap

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"

   Copy to Clipboard Toggle word wrap

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

流程

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

流程

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

流程

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

CLI 过程

1. 查找作业的 ID：

   # hammer job-invocation list

   Copy to Clipboard Toggle word wrap

2. 监控作业输出：

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

   Copy to Clipboard Toggle word wrap

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

   # hammer job-invocation cancel \
   --id My_Job_ID

   Copy to Clipboard Toggle word wrap

流程

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

   Expand

   表 5.1. Satellite 凭证

   凭证类型 ：	Red Hat Satellite 6
   Satellite URL ：	https://satellite.example.com
   用户名 ：	Satellite 用户与 integration 角色的用户名。
   密码 ：	Satellite 用户的密码。

   Show more
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

   Expand

   表 5.2. 清单源选项

   源	Red Hat Satellite 6
   凭证	您为 Satellite 服务器创建的凭据。
   覆盖	选择
   覆盖变量	选择
   启动时更新	选择
   缓存超时	90

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

1. ansible_provisioning_callback
2. ansible_tower_callback_script
3. ansible_tower_callback_service

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

流程

1. 在 Satellite Web UI 中，导航到 Configure > Host Group。
2. 创建主机组或编辑现有的主机组。
3. 在 Host Group 窗口中，单击 Parameters 选项卡。
4. 点 Add Parameter。

5. 输入每个新参数的以下信息：

   Expand

   表 5.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 中生成的主机配置密钥。

   Show more
6. 点 Submit。
7. 使用主机组创建主机。

8. 在新主机上输入以下命令来启动 ansible-callback 服务：

   # systemctl start ansible-callback

   Copy to Clipboard Toggle word wrap

9. 在新主机上输入以下命令输出 ansible-callback 服务的状态：

   # systemctl status ansible-callback

   Copy to Clipboard Toggle word wrap

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

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

   Copy to Clipboard Toggle word wrap

流程

1. 在 Satellite Web UI 中，导航到 Hosts > Job templates。
2. 单击 New Job Template。

3. 在 Name 字段中输入 Run Command - restorecon。选择 Default 使模板可供所有组织使用。将以下文本添加到模板编辑器中：

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

   Copy to Clipboard Toggle word wrap

   在作业调用过程中，<% = input ("directory")% > 字符串被替换为用户定义的目录。

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

流程

1. 在 Satellite Web UI 中，导航到 Monitor > Jobs 并点 Run job。
2. 选择 Commands as Job category and Run Command - restorecon as Job template，再单击 Next。
3. 选择您要在其上运行作业的主机。如果您没有选择任何主机，该作业将在当前上下文中可在所有主机上运行。
4. 在 目录 字段中，提供一个目录，如 /home，然后单击 Next。
5. 可选： 要为作业配置高级设置，请填写 Advanced 字段。要了解更多有关高级设置的信息，请参阅 第 4.22 节 “作业向导中的高级设置”。当您输入高级设置或不需要时，点 Next。

6. 作业计划时间。

   • 要立即执行作业，请保留预先选择的 Immediate 执行。
   • 要在以后执行作业，请选择 Future execution。
   • 要定期执行作业，请选择 Recurring execution。

7. 可选：如果您选择将来的或重复执行，请选择 Query 类型，否则点 Next。

   • 静态查询 意味着，作业会在您提供的确切主机列表上执行。

   • 动态查询 表示仅在执行作业前评估主机列表。如果您根据某些过滤器输入主机列表，则在首次使用该过滤器时结果可能会有所不同。

     选择查询类型后，单击 Next。

8. 可选：如果您选择的未来或重复执行，请提供额外的详情：

   • 对于未来执行，请输入开始时间和 时间。您还可以选择在日期和时间 之前选择 Starts。如果作业在该时间之前无法启动，它将被取消。

   • 对于 Recurring execution，请选择结束周期性作业的开始日期和时间、频率和条件。您可以选择永远不会结束、在特定时间结束，或者在指定次数的重复后结束。您还可以添加 Purpose - 跟踪作业的特殊标签。一次只能有一个具有给定目的的活跃作业。

     输入所需信息后，点 Next。

9. 查看作业详情。您可以选择返回到作业向导的任意部分，并编辑信息。
10. 单击 Submit 以计划执行的作业。