将共享文件系统 (manila) 添加到配置参考
Launchpad蓝图
https://blueprints.launchpad.net/openstack-manuals/+spec/manila-config-ref
应将共享文件系统 (manila) 添加到配置参考中，类似于块存储 (cinder)。
问题描述
目前配置参考中未包含共享文件系统 (manila)。文档当前保存在 manila devref 树中。使用块存储、对象存储和共享文件系统的管理员期望在配置参考中找到所有三个项目的类似参考。应利用自动配置文档工具。
提议的变更
内容将类似于块存储，将包含介绍、驱动程序、日志文件和选项等部分。但是，驱动程序部分将使用更短、更稳定的驱动程序描述，并使用链接到供应商网站和树内供应商文档。
在可能的情况下，应使用自动生成的配置表。
备选方案
应在配置参考中包含多少供应商驱动程序文档尚待讨论。目前的趋势是使用链接到其他文档，以处理那些版本之间发生变化的内容。对于共享文件系统，我们可以使用链接到现有的 devref。devref 对于开发者来说易于在树中维护。这对于技术细节来说是好的。不幸的是，如果我们不在配置参考中保留“适量的”信息，阅读体验将会受到影响。因此，我们需要努力找到这个适量。
实现
负责人
- 主要负责人
- Mark Sturdevant (mark-sturdevant)
- 其他贡献者
- manila 树内 devref 中的现有供应商文档。
工作项
- shared-file-systems 章节
- 生成的配置文件表
依赖项
- Manila 接近 RC1，功能已冻结。
- Manila devref Liberty 文档尚未最终确定。一些供应商应在进行此操作的同时改进其文档。一旦我们获得基本的配置参考，某些页面可能需要重新同步——或者我们可以使用单独的提交来尝试捕获每个供应商的 Liberty 更新的第一次提交。
