项目
项目是ansible playbook的集合。
通过在Tower服务器上的项目基本路径下手动放置playbooks和playbook目录,默认情况下,项目基本路径是/var/lib/awx/projects,管理员能对此进行了修改。它配置在/etc/tower/settings.py。
添加一个新项目
输入适当的详细信息:
- 名称
- 说明(可选)
- 组织
- SCM类型
- 手动管理剧本
创建一个或多个目录以在Project Base Path下存储playbooks(例如,/ var / lib / awx / projects /)
创建playbook文件或将其复制到playbook目录中。
确保playbook目录和文件归tower服务运行的同一UNIX用户和组所有。
确保权限适用于playbook目录和文件。 - 使用Source Control管理剧本
SCM URL - 请参阅帮助救命文本中的示例。
SCM分支 - 可选择输入Mercurial的SCM分支,或Git的SCM分支,标记或修订
修订版# - 可选择输入Subversion的版本号
SCM凭据 - 如果需要身份验证,请选择适当的SCM凭据
SCM更新选项:- 清除 - 在执行更新之前删除所有本地修改。
- 删除更新 - 在执行更新之前完整删除本地存储库。根据存储库的大小,这可能会显着增加完成更新所需的时间。
-
启动时更新 - 每次使用此项目运行作业时,请在启动作业之前对本地存储库执行更新。如果作业生成的速度快于项目可以同步的速度,则可以避免作业溢出,选择此选项可以配置缓存超时以缓存先前项目同步的特定秒数。
- 手动管理剧本
在添加项目设置以使用源代码管理后,会立即启动“同步”,从配置的源代码管理中获取项目详细信息,单击状态下的点(最左侧,项目名称旁边)以获取有关更新过程的更多详细信息。
权限
配给此项目的权限集(基于角色的访问控制)提供了读取,修改和管理项目,库存,作业模板和其他Tower元素的权限。
上面的示例显示了与库存相关的选项。不同的资源有不同的选择:
- Admin 允许读取,运行和编辑权限(适用于所有资源)
- use 允许在作业模板中使用资源(应用除作业模板之外的所有资源)
- update允许通过SCM更新更新项目(适用于项目和库存)
- Ad Hoc允许使用Ad Hoc命令(适用于库存)
- execute允许启动作业模板(适用于作业模板)
使用角色选择窗格中的“ key”按钮显示每个角色的描述
要删除特定用户的权限,请单击其资源旁边的取消关联(x)按钮。
通知
单击“ 通知”可以查看已设置的任何通知集成。
作业模板
单击“ 作业模板”可以查看与此项目关联的任何作业模板或工作流程模板。
添加新计划
以下字段中输入适当的详细信息:
- 姓名(必填)
- 开始日期(必填)
- 开始时间(必填)
- 本地时区 - 输入的开始时间应为此时区
- UTC开始时间 - 从开始时间+本地时区计算
- 重复频率 - 根据您选择的频率显示适当的调度选项
该算法说明允许您查看设定的时间表,并在选定的本地时区安排事件的列表。
您可以使用ON / OFF切换按钮来停止活动计划或激活已停止的计划。
项目的计划概述屏幕还会显示计划第一次,下一次和最终运行的时间。
Galaxy
在项目更新结束时,Tower搜索目录中调用的文件requirements.yml,该roles文件位于<project-top-level-directory> / roles / requirements.yml
。如果找到此文件,则会自动运行以下命令:
ansible-galaxy install -r roles/requirements.yml -p ./roles/ --force
此文件允许您在其他存储库中引用Galaxy角色或角色,这些角色或角色可以与您自己的项目一起检出。添加此Ansible Galaxy支持消除了创建git子模块以实现此结果的需要。