在自动化 hub 中管理软件仓库
在自动化中心中创建和管理自定义软件仓库
摘要
前言 复制链接链接已复制到粘贴板!
Red Hat Automation Hub 包括仓库管理。它允许您创建、编辑、修改和删除存储库。
使开源包含更多 复制链接链接已复制到粘贴板!
红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始:master、slave、黑名单和白名单。由于此项工作十分艰巨,这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情,请参阅我们的首席技术官 Chris Wright 提供的消息。
对红帽文档提供反馈 复制链接链接已复制到粘贴板!
我们非常感谢您对我们的技术内容提供反馈,并鼓励您告诉我们您的想法。如果您想添加评论,提供见解、纠正拼写错误甚至询问问题,您可以在文档中直接这样做。
您必须有一个红帽帐户并登录到客户门户网站。
要从客户门户网站提交文档反馈,请执行以下操作:
- 选择 Multi-page HTML 格式。
- 点文档右上角的 反馈 按钮。
- 突出显示您要提供反馈的文本部分。
- 点高亮文本旁的添加反馈对话框。
- 在页面右侧的文本框中输入您的反馈,然后点 Submit。
每次提交反馈时,我们都会自动创建跟踪问题。打开在点 Submit 后显示的链接,并开始监视问题或添加更多注释。
第 1 章 使用自动化中心进行存储库管理 复制链接链接已复制到粘贴板!
作为自动化中心管理员,您可以在存储库之间创建、编辑、删除和移动自动化内容集合。
Automation Hub 包括两种类型的软件仓库,您可以发布集合:
- Staging 软件仓库
- 任何有权上传到命名空间的用户都可以将集合发布到这些存储库中。这些存储库中的集合在搜索页面中不可用,而是显示在批准仪表板中供管理员验证。
- 自定义软件仓库
- 对存储库具有写入权限的任何用户都可以将集合发布到这些存储库。自定义软件仓库可以是私有存储库,只有具有查看权限的用户才能查看它们,或者是公共的存储库,所有用户都可以看到它们。这些存储库不会在批准仪表板中显示。如果搜索由存储库所有者启用,则它们可能会出现在搜索结果中。
staging 存储库使用 pipeline=staging
标签标记。默认情况下,Automation hub 附带了一个 staging 存储库,当没有指定存储库来上传集合时会自动使用。但是,用户可以在存储库创建期间创建新的暂存存储库。
1.1. 在自动化中心中批准自定义软件仓库的批准管道 复制链接链接已复制到粘贴板!
Automation hub 允许您将集合批准到标记为 pipeline=approved
标签的任何存储库中。默认情况下,自动化中心附带了一个用于批准的内容的存储库,但您可以选择从存储库创建屏幕中添加更多。带有此标签的存储库没有资格直接发布,集合必须来自其中一个 staging 存储库。
- 自动批准
-
启用自动批准后,任何上传到 staging 存储库的集合将自动提升到标记为
pipeline=approved
的所有存储库。 - 批准需要
从批准仪表板中,管理员可以查看上传到任何暂存存储库的集合。点
显示批准的存储库列表。从此列表中,管理员可以选择要提升内容的一个或多个存储库。如果只有一个已批准的存储库,则集合会自动提升到其中,管理员不会被提示选择存储库。
- 拒绝
- 拒绝的集合会自动放入预安装的拒绝存储库中。
1.2. 基于角色的访问控制 复制链接链接已复制到粘贴板!
基于角色的访问控制 (RBAC) 会根据定义的角色限制用户访问自定义存储库。默认情况下,用户可以在自动化中心中查看所有公共存储库,但除非他们有明确的权限,否则他们无法修改它们。存储库上的其他操作是一样的。例如,删除用户的权限会撤销他们从自定义存储库下载内容的能力。有关在自动化中心中管理用户访问权限的信息,请参阅为本地自动化中心配置用户访问。
1.3. 在自动化中心中创建自定义存储库 复制链接链接已复制到粘贴板!
您可以使用 Red Hat Ansible Automation Platform 创建存储库,并将其配置为私有或从搜索结果中隐藏它。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入到 → 。
- 点 。
- 输入存储库名称。
- 在 Description 中输入存储库用途。
要在每次进行更改时保留您的仓库的早期版本,请选择 保留的版本数量。保留的版本数量范围是 0 到无限。要保存所有版本,将此设置为 null。
注意如果对自定义存储库有更改有问题,您可以 恢复到保留的不同存储库版本。
为存储库选择 Pipeline。此选项定义可以将集合发布到存储库的人员。
- Staging
- 任何人都被允许将自动化内容发布到存储库中。
- 已批准
- 需要添加到此存储库的集合,才能通过暂存存储库通过批准过程进行。如果启用了自动批准,任何上传到 staging 存储库的集合将自动提升到所有批准的存储库。
- None
- 任何具有存储库权限的用户都可以直接发布到存储库,它不是批准管道的一部分。
- 可选: 要从搜索结果中隐藏存储库,请从 搜索中选择 Hide。此项会被默认选择。
- 可选: 要使存储库私有,请选择 Make private。这会防止没有权限的用户查看存储库。
- 要将内容从远程同步到此存储库,请选择 Remote,然后选择包含您要包含在自定义存储库中的集合的远程。如需更多信息,请参阅存储库同步。
- 点击 。
1.4. 提供对自定义自动化中心存储库的访问权限 复制链接链接已复制到粘贴板!
默认情况下,私有存储库和自动化内容集合在系统的所有用户中是隐藏的。所有用户都可以查看公共存储库,但不能修改。使用这个流程提供对自定义存储库的访问。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入到 → 。
- 在列表中找到您的存储库,然后点 Edit。 图标 HBAC,然后选择
- 选择 Access 选项卡。
为 Repository owners 选择一个组。
有关实施用户访问的信息,请参阅为本地自动化中心配置用户访问。
- 选择您要为所选组分配的角色。
- 点击 。
1.5. 在自动化中心存储库中添加集合 复制链接链接已复制到粘贴板!
创建存储库后,您可以开始向其中添加自动化内容集合。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入到 → 。
- 在列表中找到您的存储库,然后点 Edit。 图标 HBAC,然后选择
- 选择 Collections version 选项卡。
- 点 并选择您要添加到存储库中的集合。
- 点 。
1.6. 恢复到不同的自动化中心存储库版本 复制链接链接已复制到粘贴板!
当从存储库添加或删除自动化内容集合时,会创建一个新版本。如果对存储库有变化的问题,您可以恢复到以前的版本。恢复是一种安全操作,且不会从系统中删除集合,而是更改与存储库关联的内容。保存的版本数量在创建存储库时由 Retained number of versions 设置定义。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入到 → 。
- 在列表中找到您的存储库,然后点 Edit。 图标 HBAC,然后选择
- 找到您要回滚到的版本,然后点 Revert to this version。 图标 requirements,然后选择
- 点 。
第 2 章 Automation Hub 中的远程管理 复制链接链接已复制到粘贴板!
您可以将远程配置设置为运行自动化中心的任何服务器。远程配置允许您从外部集合源将内容同步到自定义存储库。
2.1. 在自动化中心中创建远程配置 复制链接链接已复制到粘贴板!
您可以使用 Red Hat Ansible Automation Platform 创建远程配置到外部集合源,并将这些集合的内容同步到自定义存储库。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入 → 。
- 点 。
- 为远程配置输入一个名称。
输入远程服务器的 URL,包括特定存储库的路径。
注意您可以通过进入到
→ ,选择存储库并点 来获取此信息。输入访问外部集合所需的 Token 或 Username 和 Password,将凭证配置为远程服务器。
注意可以通过
→ 生成 API 令牌,点 并复制载入的令牌。- 要从 console.redhat.com 访问集合,输入 SSO URL 以登录到身份提供程序(IdP)。
选择或创建 YAML 要求文件来标识集合和版本范围,以与自定义存储库同步。例如,要只下载 kubernetes 和 AWS 集合版本 5.0.0 或更高版本,要求文件类似如下:
Collections: - name: community.kubernetes - name: community.aws version:”>=5.0.0”
Collections: - name: community.kubernetes - name: community.aws version:”>=5.0.0”
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注意所有集合依赖项都会在同步过程中自动下载。
要进一步配置远程,请使用高级配置下可用的选项:
- 如果您的机构有一个公司代理,请输入 Proxy URL, Proxy Username 和 Proxy Password。
- 使用 TLS 验证复选框启用或禁用传输层安全性。
- 如果验证需要数字证书,输入客户端密钥和客户端证书。
- 如果您的服务器使用自签名 SSL 证书,在 CA certificate 字段中输入用于身份验证的 PEM 编码客户端证书。
- 要加快下载此远程集合的速度,在 Download concurrency 字段中指定可下载的集合数量。
要限制此远程上每秒的查询数量,指定 Rate Limit。
注意有些服务器可以设置特定的速率限制,如果超过,同步将失败。
2.2. 提供对远程配置的访问 复制链接链接已复制到粘贴板!
创建远程配置后,您可以通过执行以下操作来提供访问它:
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入 → 。
- 在列表中找到您的存储库,然后点 Edit。 图标 HBAC,然后选择
- 选择 Access 选项卡。
- 为 Repository owners 选择一个组。有关实施用户访问的信息,请参阅为本地 Automation Hub 配置用户访问。
- 为所选组选择适当的角色。
- 点击 。
第 3 章 在自动化中心中同步软件仓库 复制链接链接已复制到粘贴板!
您可以通过将存储库从一个自动化中心同步到另一个自动化中心,将相关的自动化内容集合分发到您的用户。您应该定期将自定义存储库与远程同步,以确保您有最新的集合更新。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入到 → 。
在列表中找到您的存储库,然后点 Sync。
配置的远程中的所有集合都下载到您的自定义存储库中。要检查集合同步的状态,请从 Navigation 面板中选择
。注意要将存储库同步限制为远程中的特定集合,您可以使用 requirements.yml 文件识别要拉取的特定集合。如需更多信息,请参阅创建远程。
其他资源
有关使用要求文件的更多信息,请参阅 Galaxy 用户指南中的安装带有要求文件的多个集合。
第 4 章 在自动化中心中导出和导入集合 复制链接链接已复制到粘贴板!
Ansible Automation hub 在存储库中存储自动化内容集合。这些集合由自动化内容创建者提供,因此同一集合的许多版本可以同时存在于相同或不同的存储库中。
集合存储为 tar 文件,可以导入和导出。这样可确保您导入到新存储库的集合与最初创建和导出的集合相同。
4.1. 在自动化中心中导出自动化内容集合 复制链接链接已复制到粘贴板!
完成集合后,您可以将其导入到可在您的机构中的其他位置。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入 → 。Collections 页面显示所有仓库中的所有集合,并允许您搜索特定集合。
- 选择您要导出的集合。此时会显示集合详情页面。
- 在 Installation 选项卡中,选择 Download tarball。tar 文件下载到您的默认浏览器下载文件夹中,并可导入到您选择的位置。
4.2. 在自动化中心中导入自动化内容集合 复制链接链接已复制到粘贴板!
作为自动化内容创建者,您可以导入要在自定义存储库中使用的集合。集合必须导入到您的命名空间中,并由自动化中心管理员批准,然后才能访问它们。
流程
- 登录到 Red Hat Ansible Automation Platform。
- 进入 → 。Namespaces 页面显示所有可用的命名空间。
- 点 。
- 点 。
- 进入到集合 tarball 文件,选择文件并点 。
点
。My Imports 屏幕提供了测试概述,并通知您集合上传成功或失败。
注意如果集合没有被批准,它不会显示在已发布的存储库中。