puppet-openstack-specs

  1. 模块讲解

本节作者：余兴超
阅读级别：选读
阅读时间: 0.5小时

本章节也是选读章节，仅对模块做了一个简单介绍。
puppet-openstack-specs模块是用于管理Blueprint design document，对Openstack了解的同学应该知道，在早年，社区使用Launchpad来管理BluePrint(BP)，后来过渡到使用这种Markdown语法编写+Code review的方式来管理功能开发文档，我觉得这是一个非常好的设计，在文档的格式定义，归档，搜索上有非常有益的尝试。

模块讲解

与PuppetOpenstack相关的specs放在specs/目录下，并根据release版本不同，划分出了不同的目录。

例如以Newton的某个BP为例：Configuration File Deprecation Support

它使用如下目录对BP进行详细地描述:

  • Problem description #问题描述
  • Proposed change #提出的改进计划
    • Alternatives #其他替代方案
    • Data model impact #对数据模型的影响
    • Module API impact #对模块API的影响
    • End user impact #对终端用户的影响
    • Performance Impact #对性能的影响
    • Deployer impact #对部署人员的影响
    • Developer impact #对开发人员的影响
  • Implementation # 实现相关
    • Assignee #指派人
    • Work Items #任务列表
  • Dependencies #依赖
  • Testing #测试
  • Documentation Impact #对文档的影响
  • References #参考链接

总结为四个字：非常专业。