DevStack 技术文档

1. 安装指南

DevStack 是一套脚本和实用程序，用于快速部署 OpenStack 云环境。以下是在 Ubuntu 或 Fedora 环境中安装 DevStack 的步骤：

• 确保您的系统是干净的 Ubuntu 或 Fedora 环境。

• 克隆 DevStack 仓库到您的机器上：

  git clone https://github.com/openstack-dev/devstack.git
  cd devstack
  

• 根据需要，切换到特定版本的分支（例如稳定版）：

  git checkout stable/diablo
  

• 创建并编辑 localrc 文件以覆盖默认环境变量。

• 运行 stack.sh 脚本：

  ./stack.sh
  

• 请确保在运行脚本之前仔细阅读 stack.sh 以及您将要执行的任何其他脚本，因为它们会安装软件并可能更改您的网络配置。

2. 项目使用说明

安装完成后，您可以访问 OpenStack 的端点：

• Horizon: http://myhost/
• Keystone: http://myhost:5000/v2.0/

要使用命令行与您的云交互，您需要先加载环境文件：

source openrc

然后，您可以使用以下命令：

nova list

如果您希望使用 EC2 API，您可以使用以下命令生成凭证并设置环境：

source eucarc

然后使用 EC2 API 列出实例：

euca-describe-instances

3. 项目 API 使用文档

DevStack 本身并不提供特定的 API，但它部署了 OpenStack，后者具有丰富的 API。您可以使用 OpenStack 的官方文档来了解和使用这些 API。

4. 项目安装方式

DevStack 提供了几种安装和配置选项：

• 自定义环境变量：通过创建 localrc 文件，您可以覆盖 stack.sh 脚本中使用的环境变量，以调整网络配置等。

• 数据库后端：DevStack 支持多种数据库后端，包括 MySQL 和 PostgreSQL。在 localrc 文件中设置相应的变量来选择数据库：

  use_database postgresql
  

• RPC 后端：DevStack 支持多种 RPC 后端，包括 RabbitMQ、Qpid 和 ZeroMQ。您可以在 localrc 文件中选择一个后端。

• Swift：Swift 默认不安装，但您可以通过在 localrc 文件中添加以下行来轻松启用它：

  enable_service swift
  

• Swift3：如果您需要 Swift 3 兼容性，可以通过添加以下行来启用 swift3 中间件：

  ENABLED_SERVICES="$ENABLED_SERVICES,-rabbit,-qpid,swift3"
  

通过以上步骤，您可以轻松部署和使用 DevStack，从而开始您的 OpenStack 开发工作。