Documentation/InstallationGuideImprovements
安装指南改进
全局
要分配给自己一个全局任务,请将您的名字放在任务旁边。
- 将 openstack-config (crudini) 命令替换为通用的配置文件编辑。
- 更改 XML ID 以符合规范和一致性。(Joseph Robinson) 完成
- 统一章节和段落名称。
- 统一概念/概述段落名称。
- 在适当的时候为每个命令添加示例输出(酌情使用)并突出显示特别重要的组件(需要构建过程的补丁)。
- 提及项目和租户的使用。
- 将 "MySQL" 更改为引用通用的 SQL 数据库。
- 标准化 RabbitMQ 消息代理,适用于所有发行版,因为 RDO 不再使用 Qpid。(Andreas Jaeger) 完成
- RHEL/CentOS:考虑禁用 SELinux。
- 添加安装 "openstack-selinux" 或完全禁用的选项和摘要。
- 请参阅:http://openstack.redhat.com/SELinux
- 将 Solaris 11.2 添加到发行版列表。
- 定义本书的目标受众和范围。
- 不仅仅是安装指南,每个指南。
- 请参阅:https://bugs.launchpad.net/openstack-manuals/+bug/1319394
- 在先决条件中提及 openrc 和用户命令。
- 定期引用规范。
- 调整分段(分块)以减少浏览指南所需的点击次数。也许按章节分块,以便“下一页”链接仅为每个章节?
- 将安装指南模块化,以便作为培训指南的基本安装指南重复使用。(dguitarbite/Pranav Salunke)
- 更改 XML 文件,在编译后对安装指南的外观影响应为最小或零。
- 培训指南:https://etherpad.openstack.org/p/training-guides-developing-topics
- 培训指南的基本安装指南:https://etherpad.openstack.org/p/training-guides-install-guide
- 将 auth_port 和 auth_protocol 替换为 identity_uri,将 auth_host 替换为 auth_uri
唯一(特定章节/段落)
要将自己分配给章节/段落任务,请将您的名字放在 URL 旁边。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_basics.html (Matt Kassawara / Joseph Robinson) 完成
- 将章节重命名为“基本环境”并相应地更改 ID
https://docs.openstack.org/trunk/install-guide/install/apt/content/basics-ntp.html (Matt Kassawara) 完成
- 为每个节点提供示例配置
- 计算和网络节点应引用控制器节点上的服务器
https://docs.openstack.org/trunk/install-guide/install/apt/content/basics-passwords.html (Matt Kassawara) 完成
- 更新密码列表
https://docs.openstack.org/trunk/install-guide/install/apt/content/basics-database-controller.html (Matt Kassawara) 完成
- 包括 MariaDB
- 提供 PostgreSQL 作为替代数据库的链接
https://docs.openstack.org/trunk/install-guide/install/apt/content/basics-database-node.html (Matt Kassawara) 完成
- 本节是否仅适用于需要从计算节点访问数据库的 nova-net 环境?(希望在 Juno 中删除)
https://docs.openstack.org/trunk/install-guide/install/apt/content/basics-packages.html
- 澄清内容。
- RHEL/CentOS/Fedora:更新内容以包括 Scientific Linux。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_keystone.html (Alexandra Settle) 完成
- 考虑将章节重命名为“添加身份服务”。
https://docs.openstack.org/trunk/install-guide/install/apt/content/keystone-concepts.html (Alexandra Settle / Joseph Robinson) 完成
- 审查内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/keystone-install.html (Darren Chan / Matt Kassawara) 完成
- 我们是否应该安装客户端?在文本中说明我们假设您在控制器节点上执行这些操作。
- 重新排序说明。
- 创建数据库。
- 安装软件包。
- 生成管理引导令牌。
- 配置服务。
- 同步数据库。
- 启动或重新启动 keystone 服务。
https://docs.openstack.org/trunk/install-guide/install/apt/content/keystone-users.html (Matt Kassawara) 完成
- 尝试消除对 "ADMIN_TOKEN" 和 "$ADMIN_TOKEN" 的混淆。
- 前几次提及时,请务必参考密码/环境规范。
- 作为品牌的一部分,是否需要在每个页面上都链接到规范?
https://docs.openstack.org/trunk/install-guide/install/apt/content/keystone-services.html (Joseph Robinson) 完成
- 澄清内容。
- 考虑将描述移动到“概念”部分。
https://docs.openstack.org/trunk/install-guide/install/apt/content/keystone-verify.html (Matt Kassawara) 完成
- 澄清内容。
- 考虑删除 "openrc" 内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_clients.html (Matt Kassawara) 完成
- 考虑将章节重命名为“OpenStack 客户端”。
- 手动安装客户端是否仍然适用?
- 打包的客户端可能出现的问题较少。
- 该指南通常在安装每个服务时安装打包版本。
- 服务包通常会安装打包版本。
https://docs.openstack.org/trunk/install-guide/install/apt/content/section_cli_overview.html (Joseph Robinson) 完成
- 澄清内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/cli_openrc.html (Matt Kassawara) 完成
- 澄清内容。
- 将“项目”更改为“租户”,以符合指南的其余部分。同意。如果 Keystone v3 在 Juno 版本中成为“标准”,那么我们可以将整个指南更改为“项目”,但只要使用 Keystone v2.0,命令行参数就是“租户”。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_clients_openrc_files.html (Matt Kassawara) 完成
- 澄清内容。
- 考虑将所有“openrc”文件的创建步骤移动到本节。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_glance.html (Darren Chan) 完成
- 考虑将章节重命名为“添加镜像服务组件”。
https://docs.openstack.org/trunk/install-guide/install/apt/content/image-service-overview.html (Darren Chan) 完成
- 审查内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/glance-install.html (Matt Kassawara) 完成
- 考虑将该部分重命名为“安装和配置”。
- 引用 admin-openrc.sh。
- 重新排序说明。
- 创建数据库。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 同步数据库。
- 启动或重新启动服务。
https://docs.openstack.org/trunk/install-guide/install/apt/content/glance-verify.html (Matt Kassawara) 完成
- 考虑将该部分重命名为“验证”。
- 用简单 <replaceable> 值和示例输出替换复杂的命令说明。
- 考虑将该部分合并到安装部分。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_nova.html (Alexandra Settle) 完成
- 考虑将章节重命名为“添加计算组件”。
https://docs.openstack.org/trunk/install-guide/install/apt/content/compute-service.html (Darren Chan/Matt Kassawara) 完成
- 审查内容
https://docs.openstack.org/trunk/install-guide/install/apt/content/nova-controller.html (Matt Kassawara) 完成
- 考虑将该部分重命名为“控制器节点”。
- 重新排序说明。
- 创建数据库。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 同步数据库。
- 启动或重新启动服务。
- 显式配置 'glance_host = controller'。
- 考虑将验证步骤拆分为一个部分。
- 包括 "nova service-list" 命令的输出。
https://docs.openstack.org/trunk/install-guide/install/apt/content/nova-compute.html (Matt Kassawara) 完成
- 考虑将该部分重命名为“计算节点”。
- Ubuntu:将软件包 "nova-compute-kvm" 更改为 "nova-compute"。
- Ubuntu:考虑删除 "python-guestfs" 软件包,尽管 RHEL/CentOS/Fedora 的 "openstack-nova-compute" 软件包将其作为依赖项安装。
- Ubuntu:考虑删除内核权限解决方法。
- 考虑添加验证步骤或部分。
- 包括 "nova service-list" 命令的输出。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_networking.html (Darren Chan / Andreas Jaeger / Diane Fleming) 完成
- 考虑将章节重命名为“添加网络组件”。
https://docs.openstack.org/trunk/install-guide/install/apt/content/neutron-concepts.html (Joseph Robinson) 完成
- 审查内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/section_nova-networking.html
- 如果我们计划继续支持 nova-network,我们应该考虑使用与 neutron 架构平行的架构。
- 创建类似于 neutron 初始网络的图表。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_horizon.html
- 考虑将概念段落拆分为单独的部分。
- 考虑删除本节,因为此时所有系统都应支持仪表板。
https://docs.openstack.org/trunk/install-guide/install/apt/content/install_dashboard.html (Darren Chan)
- 我们是否需要 "memcached" 进行基本安装?
- 根据用户的经验,将删除 Ubuntu 仪表板主题从必需更改为可选。
- RHEL/CentOS/Fedora:考虑添加 "httpd" 到软件包列表以保持一致性。
- 考虑删除步骤 2,不再需要。
- Ubuntu:'ALLOWED_HOSTS' 键已在 local_settings.py 中注释掉。
- RHEL/CentOS/Fedora:在 local_settings.py 中注释掉 'ALLOWED_HOSTS' 键。
https://docs.openstack.org/trunk/install-guide/install/yum/content/dashboard-sessions.html
- 本节似乎比较高级。它是否属于安装指南?
https://docs.openstack.org/trunk/install-guide/install/apt/content/ch_cinder.html
- 考虑将章节重命名为“添加块存储组件”
https://docs.openstack.org/trunk/install-guide/install/apt/content/block-storage-service.html (Joseph Robinson) 完成
- 审查内容。
https://docs.openstack.org/trunk/install-guide/install/apt/content/cinder-controller.html (Darren Chan / Matt Kassawara) 完成
- 重新排序说明
- 创建数据库。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 同步数据库。
- 启动或重新启动服务。
- Ubuntu:也安装 "python-cinderclient" 软件包?
https://docs.openstack.org/trunk/install-guide/install/apt/content/cinder-node.html (Darren Chan)
- 重新排序说明。完成
- 删除 openstack-config 命令 完成
- 将 auth_port 和 auth_protocol 替换为 identity_uri,将 auth_host 替换为 auth_uri 完成
- 添加其他节点的图表和配置。
- cinder 卷节点是否需要直接访问数据库?
- Ubuntu:我们是否应该显式安装 iscsi 实用程序?
https://docs.openstack.org/trunk/install-guide/install/apt/content/cinder-verify.html(Darren Chan) 更改已忽略:这是 https://docs.openstack.org/trunk/install-guide/install/zypper/content/ch_clients_openrc_files.html 中引用的 demo-openrc.sh 文件
-
将卷名称更改为 "demo-volume1",以与其他指南部分一致。
https://docs.openstack.org/trunk/install-guide/install/apt/content/object-storage-service.html (Darren Chan)
- 审查内容。
- 考虑更好地解释仅使用 keystone 和 swift 的安装。也许构建另一个文档?
- 对于与完整堆栈集成的对象存储,我们应该修改它以基于架构和基本环境配置章节的内容。对于独立对象存储,构建另一个文档将大大减少混淆。
- 用更实用的首次安装示例替换示例,并与架构和基本环境配置部分集成。我们能否减少首次安装的节点数量?
- 考虑分离集成安装和独立安装。
- 将先决条件合并到控制器/代理安装部分。
- swift 是否与 SQL 数据库通信?
https://docs.openstack.org/trunk/install-guide/install/apt/content/adding-proxy-server.html
- 考虑将其移动到更高级的配置章节。
https://docs.openstack.org/trunk/install-guide/install/apt/content/orchestration-service.html
- 审查内容
https://docs.openstack.org/trunk/install-guide/install/apt/content/heat-install.html (Darren Chan / Matt Kassawara) 完成
- 重新排序说明
- 创建数据库。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 同步数据库。
- 启动或重新启动服务。
https://docs.openstack.org/trunk/install-guide/install/apt/content/metering-service.html
- 审查内容。
- 提供每个节点上代理位置的图表。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ceilometer-install.html (Darren Chan/ Matt Kassawara) 完成
- 考虑将章节重命名为“配置控制器节点”。
- 重新排序说明
- 创建前提条件章节,并将 MongoDB 的安装/配置移动到该章节。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 启动或重新启动服务。
https://docs.openstack.org/trunk/install-guide/install/apt/content/ceilometer-install-nova.html (Darren Chan)
- 杂项
https://docs.openstack.org/trunk/install-guide/install/apt/content/trove-service.html (Darren Chan) 完成
- 审查内容
https://docs.openstack.org/trunk/install-guide/install/apt/content/trove-install.html (Matt Kassawara / Darren Chan)
- RHEL/CentOS/Fedora:关于软件包呢(FIXME 待处理)?
- 重新排序说明
- 创建数据库。
- 创建身份服务凭据。
- 安装软件包。
- 配置服务。
- 同步数据库。
- 启动或重新启动服务。
- 我们需要编辑 api-paste.ini 吗?
https://docs.openstack.org/trunk/install-guide/install/apt/content/trove-verify.html (Darren Chan)
- 审查内容
- 考虑添加一些示例 SQL 命令来验证操作。
https://docs.openstack.org/trunk/install-guide/install/apt/content/launch-instance-neutron.html
- 添加关于 SSH 密钥密码短语的说明。
https://docs.openstack.org/trunk/install-guide/install/apt/content/launch-instance-nova.html
- 添加关于 SSH 密钥密码短语的说明。