Rally-OpenStack/xRally-OpenStack 镜像文档

镜像概述和主要用途

Rally 是一个工具和框架，允许用户编写简单插件并将其组合成复杂的测试场景，从而执行各类测试。Rally-OpenStack 是为 OpenStack 平台提供的 Rally 插件包。本镜像包含带有 OpenStack 插件的 xRally（扩展 Rally）框架，便于用户在容器环境中快速部署和使用 Rally 测试 OpenStack 平台。

核心功能和特性

• 插件框架：支持编写简单插件并组合成复杂测试场景，满足多样化测试需求。
• OpenStack 支持：集成专为 OpenStack 平台设计的插件，可针对 OpenStack 进行测试。
• 配置灵活性：默认配置文件位于 /etc/rally/rally.conf，用户可通过 /home/rally/.rally/rally.conf 覆盖配置选项（Rally 仅加载主配置文件）。
• 数据持久化：默认数据库文件为 /home/rally/.rally/rally.sqlite，支持通过 Docker 卷或目录挂载实现数据持久化。

使用场景和适用范围

适用于需要对 OpenStack 平台进行测试的开发人员、测试工程师或运维人员，可在容器环境中快速部署 Rally，执行各类 OpenStack 测试场景，如性能测试、功能测试等。

使用方法和配置说明

1. 拉取镜像

建议使用最新标记版本，例如拉取 3.0.0 版本：

bash
$ docker pull xrally/xrally-openstack:3.0.0

2. 重要警告

警告：切勿将文件夹或卷挂载到容器内的 /rally 目录，这可能导致功能异常。

3. 配置文件说明

• 默认配置文件路径：/etc/rally/rally.conf（用户通常无需关注）。
• 如需覆盖配置选项，使用 /home/rally/.rally/rally.conf 路径，Rally 将优先加载此文件。

4. 数据库持久化

为使数据在容器重启后保持持久，可通过以下两种方式实现：

方法一：使用 Docker 卷（推荐，最简单）

bash
# 创建 Docker 卷
$ docker volume create --name rally_volume

# 使用卷运行容器（示例：创建名为 "foo" 的环境）
$ docker run -v rally_volume:/home/rally/.rally xrally/xrally-openstack:3.0.0 env create --name "foo"

方法二：挂载外部目录

bash
# 创建外部目录（可自定义位置，建议放置在所有用户可访问的路径）
$ sudo mkdir /var/lib/rally_container

# 为使容器内的 Rally 用户（uid: 65500）可访问该目录，需确保外部目录对 uid 65500 有访问权限
$ sudo chown 65500 /var/lib/rally_container

# 初始化 Rally 数据库（与 Docker 卷不同，挂载外部目录时需手动初始化）
$ docker run -v /var/lib/rally_container:/home/rally/.rally xrally/xrally-openstack:3.0.0 db create

# 运行容器执行操作（示例：创建名为 "foo" 的环境）
$ docker run -v /var/lib/rally_container:/home/rally/.rally xrally/xrally-openstack:3.0.0 env create --name "foo"

相关链接

• 开源协议：Apache 许可证
• 文档：[***]
• 源码：[***]
• Bug 跟踪：[***]
• Gitter 聊天：[***]