14. 项目¶

14.1. 添加新的项目¶

要创建新的项目

1. 点击 按钮，这将启动 **创建项目** 窗口。

2. 在以下必填字段中输入相应的信息

• 名称

• **描述**（可选）

• **组织** - 项目必须至少有一个组织。现在选择一个组织来创建项目，然后在项目创建后，您可以添加其他组织。

• **Ansible 环境**（可选） - 从下拉菜单列表中选择要在其上运行此项目的自定义虚拟环境。此字段仅在先前创建了自定义环境时才出现。在Ansible Tower 升级和迁移指南中查看 使用虚拟环境与 Ansible Tower。

• **SCM 类型** - 从下拉菜单列表中选择与该项目关联的 SCM 类型。后续部分中的选项将根据您选择的类型而变为可用。有关更多详细信息，请参阅后续部分中的 手动管理剧本 或 使用源代码控制管理剧本。

14.2. 从源代码管理更新项目¶

1. 通过选择项目并单击按钮来更新现有的基于 SCM 的项目。

注意

请注意，在添加使用源代码管理的项目设置后，会立即启动“同步”，它会从配置的源代码管理中获取项目详细信息。

2. 单击**状态**下的点（最左边，在项目名称旁边）以获取有关更新过程的更多详细信息。

14.3. 使用权限¶

分配给此项目的一组权限（基于角色的访问控制）提供读取、修改和管理项目、清单、作业模板和其他 Tower 元素的能力，这些权限被称为特权。

您可以通过**详细信息**选项卡旁边的**权限**选项卡访问项目权限。此屏幕显示当前具有此项目权限的用户列表。列表可以按**用户**、**角色**或**团队角色**排序和搜索。

14.3.1. 添加权限¶

**权限**选项卡允许您查看、授予、编辑和删除与用户和团队成员相关的权限。要为特定用户分配此资源的权限

1. 单击**权限**选项卡。

2. 单击按钮以打开添加用户/团队窗口。

3. 指定将拥有访问权限的用户或团队，然后为其分配特定角色

1. 单击以选中用户或团队名称旁边的一个或多个复选框以选中它们。

注意

您可以在不保存的情况下，在**用户**和**团队**选项卡之间导航，同时选择多个用户和团队。

进行选择后，该窗口将扩展，允许您从下拉菜单列表中为所选的每个用户或团队选择一个角色。

上面的示例显示了与清单相关的选项。不同的资源具有不同的可用选项

• **管理员**允许读取、运行和编辑权限（适用于所有资源）

• **使用**允许在作业模板中使用资源（适用于除作业模板以外的所有资源）

• **更新**允许通过 SCM 更新来更新项目（适用于项目和清单）

• **临时**允许使用临时命令（适用于清单）

• **执行**允许启动作业模板（适用于作业模板）

• **读取**允许仅查看访问权限（适用于所有资源）

提示

使用角色选择窗格中的**键**按钮来显示每个角色的描述。有关更多信息，请参阅本指南的角色部分。

2. 选择要应用于所选用户或团队的角色。

注意

您可以在不保存的情况下，在**用户**和**团队**选项卡之间导航，同时为多个用户和团队分配角色。

4. 查看每个用户和团队的角色分配。

5. 完成后，单击**保存**，添加用户/团队窗口将关闭，显示为每个用户和团队分配的更新角色。

   

要删除特定用户的权限，请单击其资源旁边的取消关联（x）按钮。

这将启动一个确认对话框，要求您确认取消关联。

14.4. 使用通知¶

单击**通知**选项卡允许您查看已设置的任何通知集成。

使用切换按钮来启用或禁用要与特定项目一起使用的通知。有关更多详细信息，请参阅启用和禁用通知.

如果尚未设置任何通知，请单击灰色框内的**通知**链接以创建新的通知。

有关配置各种通知类型的更多详细信息，请参阅通知类型。

14.5. 使用作业模板¶

点击作业模板，您可以添加和查看与该项目关联的任何作业模板或工作流模板。点击展开以查看每个模板的详细信息，包括使用该模板运行的作业的状态和其他有用信息。您可以根据各种标准对列表进行排序，并执行搜索以筛选感兴趣的模板。

在此视图中，您还可以启动 ()、复制 () 或删除 () 模板配置。注意，上面的示例显示了展开视图。

14.6. 使用计划¶

点击计划，您可以查看为此项目设置的任何计划。

14.7. Ansible Galaxy 支持¶

在项目更新结束时，Tower 会在 roles 目录（位于 <project-top-level-directory>/roles/requirements.yml）中搜索名为 requirements.yml 的文件。如果找到此文件，则会自动运行以下命令

ansible-galaxy role install -r roles/requirements.yml -p <project-specific cache location>/requirements_roles -vvv

此文件允许您引用 Galaxy 角色或其他存储库中的角色，这些角色可以在您的项目中一起检出。添加此 Ansible Galaxy 支持消除了创建 git 子模块以实现此结果的需要。鉴于 SCM 项目（以及角色/集合）被拉入并从私有作业环境执行，因此默认情况下会在 /tmp 中创建特定于项目的 <private job directory>。但是，您可以在“配置 Tower”窗口的“作业设置”选项卡中根据您的环境指定其他作业执行路径

缓存目录是全局项目文件夹中的一个子目录。内容可以从缓存位置复制到 <job private directory>/requirements_roles 位置。

默认情况下，Ansible Tower 具有一个系统范围的设置，允许从 roles/requirements.yml 文件中为 SCM 项目动态下载角色。您可以在“设置”（）菜单的“作业”选项卡中，通过将启用角色下载切换按钮切换到关闭来关闭此设置。

每当项目同步运行时，Tower 都会确定项目源以及来自 Galaxy 和/或集合的任何角色是否与项目过时。项目更新将在更新中下载角色。

如果作业需要获取对上游角色所做的更改，则更新项目将确保发生这种情况。角色的更改意味着将新的提交推送到provision-role源代码控制。要使此更改在作业中生效，您不需要将新的提交推送到playbooks存储库，但您需要更新项目，这会将角色下载到本地缓存。例如，假设您的源代码控制中有两个 git 存储库。第一个是playbooks，Tower 中的项目指向此 URL。第二个是provision-role，它由playbooks git 存储库中的 roles/requirements.yml 文件引用。

简而言之，作业将在每次作业运行之前下载最新的角色。出于性能原因，角色和集合在本地缓存，您需要在项目 SCM 更新选项中选择启动时更新版本以确保在每次作业运行之前重新下载上游角色

更新发生在流程的更早阶段，而不是同步，因此这会更快地以更逻辑的方式显示错误和详细信息。

有关 requirements.yml 文件语法的更多信息和示例，请参阅 Ansible 文档中的角色需求部分。

如果需要专门公开任何目录，您可以在“配置 Tower”屏幕的“要向隔离作业公开的路径”中指定它们，或通过更新设置文件中的以下条目

AWX_PROOT_SHOW_PATHS = ['/list/of/', '/paths']

注意

您可能想要添加到 AWX_PROOT_SHOW_PATHS 的主要文件是 /var/lib/awx/.ssh，如果您的剧本需要使用在那里定义的密钥或设置。

如果您在设置文件中进行了更改，请确保在保存更改后使用 ansible-tower-service restart 命令重新启动服务。

在 Tower 用户界面中，您可以在“作业设置”窗口中配置这些设置。

14.8. 集合支持¶

Tower 支持作业运行中特定于项目的 Ansible 集合。如果您在 SCM 中的 collections/requirements.yml 中指定了集合需求文件，Tower 将在作业运行之前隐式项目同步中安装该文件中的集合。要指定集合需求

ansible-galaxy collection install -r requirements.yml -p <job tmp location>

默认情况下，Ansible Tower 具有一个系统范围的设置，允许从 collections/requirements.yml 文件中为 SCM 项目动态下载集合。您可以在“设置”（）菜单的“作业”选项卡中，通过将启用集合下载切换按钮切换到关闭来关闭此设置。

出于性能原因，角色和集合在本地缓存，您需要在项目 SCM 更新选项中选择启动时更新版本以确保这

14.8.1. 在 Tower 中使用集合¶

在 Tower 可以将 Automation Hub 用作集合内容的默认源之前，您需要在 Automation Hub UI 中创建一个 API 令牌，以便可以在 Ansible Tower 中指定它。您可以连接到私有 Automation Hub 或公共 Automation Hub 集合，唯一的区别是您指定的 URL。

1. 导航到 https://cloud.redhat.com/ansible/automation-hub/token 并点击加载令牌。

2. 点击复制图标将 API 令牌复制到剪贴板。

3. 要在 Tower 中使用公共 Automation Hub，请使用复制的令牌创建一个 Automation Hub 凭据，并指向令牌页面中服务器 URL 和SSO URL 字段中显示的 URL

• Galaxy 服务器 URL = https://cloud.redhat.com/api/automation-hub/

• AUTH 服务器 URL = https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token

4. 要在 Tower 中使用私有 Automation Hub，请使用从您的本地 Automation Hub 的 Repo 管理仪表板中检索的令牌创建一个 Automation Hub 凭据，并指向已发布的存储库 URL，如

您可以在其中创建具有不同命名空间/集合的不同存储库。但对于 Automation Hub 中的每个存储库，您都需要创建不同的 Automation Hub 凭据。从 Automation Hub UI 中以 https://$<hub_url>/api/galaxy/content/<repo you want to pull from> 格式复制Ansible CLI URL 到Tower 创建凭据窗体的Galaxy 服务器 URL 字段

注意

在私有 Automation Hub 中生成的令牌用于所有内容。rh-certified 和 community 等存储库没有专用令牌。您应该使用为 ansible.cfg 文件中的所有适当 ansible-galaxy 定义生成的令牌。有关详细信息，请参阅Ansible Tower 管理指南中的查找和配置 Ansible 配置文件。

有关 Automation Hub UI 特定说明，请参阅在 Ansible Hub 中管理 Red Hat 认证和 Ansible Galaxy 集合。

5. 导航到您要从中同步 Automation Hub 内容的组织，并将新的 Automation Hub 凭据添加到组织。此步骤允许您将每个组织与您要从中使用内容的 Automation Hub 凭据（即存储库）关联起来。

注意

假设您有两个存储库

• Prod：Namespace 1 和 Namespace 2，每个都包含集合 A 和 B，因此：namespace1.collectionA:v2.0.0 和 namespace2.collectionB:v2.0.0

• Stage：Namespace 1 仅包含集合 A，因此：namespace1.collectionA:v1.5.0 在 Automation Hub 上，您将拥有Prod 和Stage 的存储库 URL。

您可以为每个存储库创建一个 Automation Hub 凭据。然后，您可以将不同级别的访问权限分配给不同的组织。例如，您可以创建一个开发人员组织，该组织可以访问这两个存储库，而操作组织只能访问 Automation Hub Prod 存储库。

有关 Automation Hub UI 特定说明，请参阅在 Ansible Hub 中管理用户访问权限。

6. 如果 Automation Hub 具有自签名证书，请点击切换以启用 Tower 设置忽略 Ansible Galaxy SSL 证书验证。对于公共 Automation Hub（使用已签署的证书），请点击切换以禁用它。注意，这是一个全局设置

7. 创建一个项目，其中源存储库在 collections/requirements.yml 文件中指定了需求文件中所需的集合。请参阅 Ansible 文档中描述的语法：https://docs.ansible.org.cn/ansible/latest/user_guide/collections_using.html#install-multiple-collections-with-a-requirements-file。

8. 在“项目”列表视图中，点击 对该项目运行更新。Tower 会从 collections/requirements.yml 文件中获取 Galaxy 集合并报告更改；现在，任何使用该项目的作业模板都会安装这些集合。

注意

如果 Galaxy 或集合需要更新，则会执行同步操作，该操作会下载所需的 roles，从而在您的 /tmp 文件中消耗更多空间。在您拥有大型项目（约 10 GB）的情况下，/tmp 上的磁盘空间可能会成为问题。

有关集合的更多信息，请参阅 使用集合。有关 Red Hat 如何发布这些官方集合之一的更多信息，这些集合可用于直接自动化您的 Tower 安装，请参阅 AWX Ansible 集合 文档。您可以在 Red Hat Ansible 自动化平台订阅中使用 Red Hat 客户凭据访问此页面。