在 Automation Hub 中管理红帽认证的集合和 Ansible Galaxy 集合

Red Hat Ansible Automation Platform 1.2

配置 Automation Hub,为用户提供红帽认证的集合内容和 Ansible Galaxy 集合的内容。

摘要

提供反馈:
如果您对本文档有任何改进建议,或发现了任何错误,请在 http://issues.redhat.com 中创建问题。选择 Automation Hub(AAH)项目,并使用 Documentation组件。

前言

您可以同步 Automation Hub 来使用通过 Ansible Automation Platform 订阅提供的红帽认证的集合(Certified Collections),或使用通过 Ansible Galaxy 提供的社区集合。

您的机构可从 cloud.redhat.com 上托管的 Automation Hub 服务中的所有红帽认证内容中访问并策展到一组特定的集合。

第 1 章 在 Automation Hub 中管理红帽认证的集合同步列表

您可以通过创建同步列表,使用 Automation Hub 向用户分发相关的红帽认证的集合内容。

1.1. 关于红帽认证的集合同步列表

同步列表(synclist)是红帽认证集合的策展组,由您的机构管理员创建并同步到本地 Automation Hub。使用同步列表,可以管理您需要的内容,并排除不必要的集合内容。您可以根据 cloud.redhat.com 所提供的红帽认证集合的一部分来设计并管理您的同步列表。

每个同步列表都有其自身唯一的存储库 URL,您可以使用它指定为 Automation Hub 中内容的远程源,并使用 API 令牌对其进行安全访问。

1.2. 创建红帽认证的集合的同步列表

您可以在 cloud.redhat.com 上的 Automation Hub 中创建一个策展的红帽认证集合同步列表。您的同步列表存储库位于菜单[Automation Hub > Repo Management] 下,每当您选择管理红帽认证的集合中的内容时,这个菜单都会被更新。

默认情况下,您的初始机构同步列表中包含了所有红帽认证的集合。

前提条件

  • 有一个有效的 Ansible Automation Platform 订阅。
  • 具有 cloud.redhat.com 的机构管理员权限。

流程

  1. 登录到 cloud.redhat.com。
  2. 导航到 Automation HubCollections
  3. 在每个集合中使用切换开关来决定是否将其从同步列表中排除。

完成同步列表管理集合后,您可以进入 Automation HubRepo Management 以将远程存储库同步启动到本地 Automation Hub。如果已经配置了远程存储库,您可以手动将红帽认证的集合同步到本地 Automation Hub,以更为本地用户提供可用的集合内容。

第 2 章 配置 Automation Hub 远程存储库,以从红帽认证的集合和 Ansible Galaxy 集合中同步内容

您可以将本地 Automation Hub 配置为与云.redhat.com 上机构存储库中托管的红帽认证集合进行同步,或与您在 Ansible Galaxy 中选择的集合同步。

2.1. 关于远程软件仓库

您可以通过配置远程存储库,将本地 Automation Hub 配置为与 cloud.redhat.com 上机构存储库中托管的红帽认证集合进行同步,并与您选择的 Ansible Galaxy 中的集合进行同步。

位于菜单[Repo Management > Remote] 中的每个远程存储库都为 communityrh-certified 提供了关于存储库在什么时候被最后更新(last updated)以及什么时候内容被最后同步(last synced)的信息。您可以使用 Repo ManagementRemote 页面中包含的 EditSync 功能随时将新内容添加到 Automation Hub。

2.2. 检索您的红帽认证集合同步 URL 和 API 令牌。

您可以将您的机构从 cloud.redhat.com 提供的红帽认证的集合同步到本地 Automation Hub。

前提条件

  • 具有 cloud.redhat.com 的机构管理员权限。

流程

  1. 以机构管理员身份登录到 cloud.redhat.com。
  2. 进入 Automation HubRepo Management
  3. 找到 Sync URL,点 Copy to clipboard 。在配置 rh-certified remote 时,在使用的文件中粘贴 Sync URL
  4. More actions 并点 Get token
  5. Token Management 页面中,点 Load token
  6. Copy to clipboard 复制 API 令牌。。
  7. 将 API 令牌粘贴到文件中,并存储在安全位置。
重要

API 令牌是用于保护内容的 secret 令牌。将 API 令牌存储在安全位置。

2.3. 配置 rh-cerftized remote repository 并同步红帽认证的集合。

您可以编辑 rh-certent 的远程存储库,以便将托管在 cloud.redhat.com 中的 Automation Hub 的集合同步到本地 Automation Hub。默认情况下,您的本地 Automation Hub rh- certified 存储库包含 cloud.redhat.com 上整个红帽认证集合组的 URL。要只使用您的机构指定的集合,您需要包含一个唯一的 URL。

前提条件

  • 您有修改 Ansible 存储库内容的权限。如需了解更多有关权限的信息,请参阅 Automation Hub 中的管理用户访问权限
  • 您已从 cloud.redhat.com 上的 Automation Hub 托管服务中检索 Sync URL 和 API 令牌。

流程

  1. 登录到您的本地 Automation Hub。
  2. 进入 Repo Management
  3. Remotes 选项卡。
  4. rh-certified 远程中,点 More actions 并点 Edit
  5. 在相关界面中,粘贴您从 cloud.redhat.com 获取的 Sync URL 和 Token。
  6. Save

界面将关闭并返回到 Repo Management 页面。现在,您可以在 cloud.redhat.com 上的机构同步列表和本地 Automation Hub 间同步集合。

  1. Sync 进行同步集合。

Sync status 通知将更新为您在红帽认证的集合同步完成后通知您。

验证

您可以通过从集合内容下拉列表中选择 Red Hat Certified,确认您的集合内容已成功同步。

2.4. 配置社区远程存储库并同步 Ansible Galaxy 集合

您可以编辑 community 远程存储库,将所选的集合从 Ansible Galaxy 同步到本地 Automation Hub。默认情况下,您的本地 Automation Hub community 存储库定向到 https://galaxy.ansible.com/api/

先决条件

  • 您有修改 Ansible 存储库内容的权限。如需了解更多有关 权限的信息,请参阅在 Automation Hub 中管理用户访问权限。
  • 您有一个 requirements.yml 文件,用于标识要从 Ansible Galaxy 同步的集合。请参见以下示例。

Requirements.yml 示例

collections:
  # Install a collection from Ansible Galaxy.
  - name: geerlingguy.php_roles
    version: 0.9.3
    source: https://galaxy.ansible.com

流程

  1. 登录到您的本地 Automation Hub。
  2. 进入 Repo Management
  3. Remotes 选项卡。
  4. community 远程中,点 More actions 并点 Edit
  5. 在相应的界面中,点 Browse 并在本地机器上找到 requirements.yml 文件。
  6. Save

界面将关闭并返回到 Repo Management 页面。现在,您可以将在 requirements.yml 文件中指定的集合从 Ansible Galaxy 同步到本地 Automation Hub。

  1. Sync 以同步来自 Ansible Galaxy 和 Automation Hub 的集合。

Sync status 通知将会更新,以告知您 Automation Hub 与 Ansible Galaxy 集合的同步是否已完成或失败。

验证

您可以从集合内容下拉列表中选择 Community 来确认同步成功。

第 3 章 总结

完成上述步骤后,您就创建了一个同步列表,它会将相关的红帽认证的集合内容和 Ansible Galaxy 的集合内容同步到本地的 Automation Hub,以供您的用户使用。

用户现在可以从本地 Automation Hub 查看并下载集合内容。