欢迎阅读 Adjutant 文档!¶
Adjutant 是一个基于 Django 和 Django-Rest-Framework 构建的基本工作流框架,旨在帮助自动化 OpenStack 集群中的管理任务。
Adjutant 的目标是提供一个场所和标准操作来填补 Keystone 中缺失的功能,并允许轻松地将业务逻辑添加到更复杂的任务中,以及与外部系统的连接。
任务围绕初始提交、管理员批准和令牌提交这三个状态构建。并非每个任务都总是使用所有状态,但这种格式允许轻松实现需要审批和检查最终用户数据的系统。
虽然这是一个 Django 应用程序,但它并不遵循标准的 Django 文件夹结构,因为存在某些打包要求。因此,该项目没有 manage.py 文件,必须通过 setup.py 或 pip 进行安装。
安装完成后,所有正常的 manage.py 函数都可以直接在 ‘adjutant-api’ 命令行函数上调用。
可以使用命令 tox -e venv {您的 命令},它将设置一个包含所有必需依赖项的虚拟环境。
例如,可以在端口 5050 上运行服务器,方法是
tox -e venv adjutant-api runserver 0.0.0.0:5050
客户端和 UI 库¶
Adjutant 存在命令行/python 和 horizon 插件。
测试和文档¶
测试和文档由 tox 管理,可以使用命令 tox 简单地运行它们。
要仅运行 action 单元测试
tox adjutant.actions
要运行单个 api 测试
tox adjutant.api.v1.tests.test_delegate_api.DelegateAPITests.test_duplicate_tasks_new_user
Tox 将在 Python 2.7、Python 3.5 中运行测试并生成覆盖率报告。
可以使用命令 tox -e api-ref 生成 Api 参考。 这将放置在 api-ref/build 目录中,可以使用命令 tox -e docs 生成这些文档,它们将放置在 doc/build 目录中。
贡献¶
Adjutant 及其 ui 和客户端的错误和蓝图在 launchpad 上管理 这里。
更改应通过 OpenStack gerrit 提交,OpenStack 项目的贡献指南 在这里。