OpenStack Liberty 安装指南：Debian¶

问题描述¶

在重新发布 OpenStack Debian 安装指南之前，需要执行以下步骤：

• 转换为 RST 格式
• 测试和修订内容

提议的变更¶

1. 由于 Debian 和 Ubuntu 之间的相似性，大多数 Debian 用户可以遵循 Ubuntu 的安装说明。大多数 Debian 特定的配置内容预计将保存在 Debconf 章节中。

   注意

   Debconf 系统是 Debian 与其用户之间的通用接口。它用于更改 OpenStack 服务的配置指令。但是，我们理解目标不仅仅是教授如何安装 OpenStack，还要理解应该在哪个文件的哪个部分配置什么指令。因此，Debconf 章节将包含对 Debian 包自动处理的指令的解释。

   为了确保 Debian 用户获得与其他用户相同的理解水平，Debconf 章节将记录以下元素：

   • Debconf 提示
   • 受提示影响的指令
   • 显示配置结果的截图
   • 请注意，这些信息也可以用于预配置和 puppet 脚本。

2. 将安装指南的 Debconf 章节转换为 RST 格式。本章节描述了以下过程：

   • 设置数据库
   • RabbitMQ 凭据（登录名、密码、主机）
   • [keystone_authtoken]（登录名、密码、租户和主机）
   • API 端点

   注意

   这些需要放在一个章节中，以避免为每个服务重复相同的内容。

3. 将每个组件的“安装和配置”部分转换为包含对 Debconf 章节的引用，作为配置包的替代方法。

4. 使用“debian”标签根据主要规范指定 Debian 内容的条件：https://specs.openstack.org/openstack/docs-specs/specs/liberty/installguide-liberty-rst.html。您可以在这里找到添加的标签：https://review.openstack.org/#/c/191516。

5. 在 RST 迁移进行时，测试指南并在 launchpad 上报告错误。

6. 准备草稿以修复错误。

7. 迁移完成后，审查修复。

8. 更新后，发起讨论以在 docs.openstack.org 上发布 Debian 安装指南。

实现¶

依赖项¶

主要依赖项是主要安装指南转换，如 https://specs.openstack.org/openstack/docs-specs/specs/liberty/installguide-liberty-rst.html 中所述。

测试¶

与 https://specs.openstack.org/openstack/docs-specs/specs/liberty/installguide-liberty-rst.html 中指定的相同程序。

参考资料¶

Debian 安装指南转换的计划和状态将在 Etherpad 中跟踪。

可以使用任何官方媒介进行讨论，包括 IRC 中的 #openstack-doc，带有 [install-guide][debian] 标签的主题的 openstack-docs 邮件列表，每周的 安装指南专业团队会议，每周的 文档团队会议，以及潜在的 etherpads。

此外，可以在周一 13:00 UTC 在 Google Hangout 中安排 Debian 安装指南会议，以讨论阻塞问题。