第 2 章 在自动化 hub 中管理集合
作为内容创建者,您可以使用自动化中心中的命名空间来策展和管理集合。例如,您可以:
- 使用权限创建团队来策展命名空间,并将集合上传到私有自动化中心
- 在命名空间中添加信息和资源,以帮助在其自动化任务中集合的最终用户
- 将集合上传到命名空间
- 查看命名空间导入日志,以确定上传集合及其当前批准状态是否成功或失败。
有关创建内容的详情,请参考 开发自动化内容。
2.1. 使用命名空间管理 Automation Hub 中的集合
命名空间是 Automation Hub 中的唯一位置,您可以上传并发布内容集合。对 Automation Hub 中的命名空间的访问取决于有权管理其中的内容和相关信息的团队。
您可以使用 Automation Hub 中的命名空间组织在您的机构内开发的集合,以用于内部发布和使用。
如果使用命名空间,则必须有一个具有创建、编辑和上传集合到命名空间的团队。上传到命名空间的集合需要管理员批准,然后才能发布并供使用。
2.1.1. 为内容 Curator 创建新团队
您可以在 Ansible Automation Platform 中创建一个新团队,旨在支持机构中的内容策展。此团队可以为内部开发的集合提供在私有自动化中心中发布。
为了帮助内容开发人员创建命名空间,并将其内部开发的集合上传到私有自动化中心,您必须首先创建和编辑团队并分配所需的权限。
前提条件
- 在 Ansible Automation Platform 中具有管理权限,并可创建团队。
流程
- 登录到您的 Ansible Automation Platform。
-
在导航面板中,选择
,再点 。 - 输入 Content Engineering 作为团队的名称。
- 为团队选择一个 机构。
- 点 。您已创建新团队,并打开团队 Details 页面。
- 选择 Roles 选项卡,然后选择 Automation Content 选项卡。
- 点 。
- 从 Resource type 列表中选择 Namespace 并点 。
- 选择将接收新角色的命名空间, 。
- 选择要应用到所选命名空间的角色,然后点 。
- 查看您的选择并点击 。
单击
以完成该过程。使用您分配的权限创建新团队。然后您可以将用户添加到团队中。
- 点 Teams 页面中的 Users 选项卡。
- 单击 。
- 选择用户并单击 。
有关使用团队管理访问权限的更多信息,请参阅 访问管理和身份验证指南中的 团队。
2.1.2. 创建命名空间
您可以创建一个命名空间来组织内容开发人员上传到自动化中心的集合。在创建命名空间时,您可以在自动化中心中分配一个团队作为该命名空间的所有者。
前提条件
- 您有 Add Namespaces 和 Upload to Namespaces 权限。
流程
- 登录到您的 Ansible Automation Platform。
-
在导航面板中,选择
。 - 点 Name。 并为您的命名空间输入一个
- 可选:在适当的字段中输入描述、公司、徽标 URL、资源或有用的链接。
- 点 。
- 选择 Team Access 选项卡,再点 将角色分配给您的命名空间。
- 选择您要授予角色的团队,然后点 。
- 选择您要应用到所选团队的角色,然后点 。
- 查看您的选择并点击 。
- 单击 以完成该过程。
您的内容开发人员现在可以将集合上传到新命名空间中,并允许团队中的用户作为所有者上传集合。
2.1.3. 在命名空间中添加额外信息和资源
您可以将信息添加到命名空间中包含的集合中,并为用户提供资源。例如,您可以添加徽标和描述,并将用户链接到 GitHub 存储库、签发跟踪器或其他在线资产。您还可以在 Resources 字段中输入标记文本,使其包含更多信息。这对在自动化任务中使用集合的用户非常有用。
前提条件
- 您有更改命名空间的权限。
流程
- 登录到 Ansible Automation Platform。
-
在导航面板中,选择
。 - 选择您要编辑的命名空间。
- 点 。
- 在字段中输入相关信息。
- 可选:在 Resources 字段中输入标记信息。
- 点 。
您的内容开发人员现在可以将集合上传到您的新命名空间中,或者允许团队中的用户作为所有者上传集合。
在创建命名空间时,具有上传权限的团队可以开始添加其集合以进行批准。批准后,命名空间中的集合会出现在 Published 存储库中。
2.1.4. 将集合上传到您的命名空间中
您可以将 tar.gz
文件格式内部开发的集合上传到私有自动化中心命名空间中,供自动化 hub 管理员审核和批准。批准后,集合将移到自动化中心用户可以查看并下载它的 Published 内容存储库。
按如下方式格式化您的集合文件名:<my_namespace-my_collection-1.0.0.tar.gz>
前提条件
- 您有一个命名空间,可以将集合上传到这个命名空间。
流程
- 登录到 Ansible Automation Platform。
-
在导航面板中,选择
并选择命名空间。 - 选择 Collections 选项卡。
- 点 。
- 点 Collection file 字段旁边的 。
- 选择要上传的集合。
选择以下选项之一:
- Staging 仓库
- 没有管道的存储库
- 点 。
验证
要验证集合是否上传成功,或者是否上传了
2.1.5. 查看命名空间导入日志
您可以查看上传到命名空间的集合状态,以评估进程是否成功或失败。
导入的集合信息包括:
- Status
- 完成或失败
- 批准状态
- 等待批准或批准
- 版本
- 上传的集合的版本
- 导入日志
- 在集合导入过程中执行的活动
前提条件
- 您可以访问可上传集合的命名空间。
流程
- 登录到您的 Ansible Automation Platform。
-
在导航面板中,选择
。 - 选择一个命名空间。
- 点 3.3.0 并选择 Imports。 图标
- 使用 search 字段或找到列表中导入的集合。
- 点导入的集合。
- 查看集合导入详情,以确定命名空间中的集合状态。
2.1.6. 删除命名空间
您可以删除不需要的命名空间来管理自动化中心服务器上的存储。您必须首先确保要删除的命名空间不包含具有依赖项的集合。
前提条件
- 您要删除的命名空间没有依赖项集合。
- 有 Delete namespace 权限。
流程
- 登录到您的 Ansible Automation Platform。
-
在导航面板中,选择
。 - 点要删除的命名空间。
点 ⋮, 然后点 。
图标注意如果
按钮被禁用,命名空间会包含带有依赖项的集合。检查此命名空间中的集合,并删除任何依赖项。
您删除的命名空间及其关联的集合现已从命名空间列表视图中删除。