OpenStack 安全规范¶
这个 git 仓库用于存放 OpenStack 安全项目的批准的设计规范。规范的评审在 gerrit 中进行,使用与我们评审和合并安全项目及支持工具变更相似的工作流程。
这个仓库的布局是
specs/<release>/
您可以在 doc/source/specs/template.rst 中找到一个示例规范。请用新的蓝图的细节填充它以进行文档编写。
对于安全项目,较大的、协调的项目需要蓝图,但小的修复不需要。是否需要规范取决于判断,所以请随时在 #openstack-security IRC 频道或 openstack-security 邮件列表中提问。
要为特定版本的项目提出规范,请将新文件添加到 specs/<release> 目录并提交以供评审。可以通过查看 Launchpad 中的蓝图(规范链接到 Launchpad)来查找给定版本的蓝图实施状态。
请注意,并非所有批准的蓝图都会完全实现。
安全蓝图是在 Liberty 开发周期中引入的,使用这个仓库。
请注意,Launchpad 蓝图仍然用于跟踪蓝图的当前状态。有关更多信息,请参阅 https://wiki.openstack.org/wiki/Blueprints。
有关使用 gerrit 的更多信息,请参阅 https://docs.openstack.org/infra/manual/developers.html#development-workflow。
为了验证规范在语法上是否正确(即,获得更多 Jenkins 结果的信心),请执行以下命令
$ tox
运行 tox 后,文档将以 HTML 格式在 doc/build/ 目录中提供以供查看。请不要将生成的 HTML 文件作为您提交的一部分签入。
文件发布在 https://specs.openstack.org/openstack/security-specs。
git 仓库位于 http://git.openstack.org/cgit/openstack/security-specs/。