欢迎阅读 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 项目的贡献指南 在这里