octario 1.0.0

# Octario

**Openstack组件测试Ansible角色**

Octario是用于在RHEL/CentOS上测试Openstack组件的Ansible角色和剧本集合。

它支持以下测试器或测试框架

* PEP8
* 单元测试
* 功能测试
* 全栈测试
* API（树内）
* Tempest
* Robot

### 要求

1. 系统上已安装Ansible（Ansible >= 2）。
2. 组件源代码。可以使用`git clone git://git.openstack.org/openstack/<component_name>.git`下载。

注意：`octario`不会为其运行测试的节点进行配置。它假定测试节点由用户通过在hosts文件中指定提供。
它假定测试节点由用户通过在hosts文件中指定提供。

## 运行Octario

首先，创建一个包含您的测试节点IP地址或主机名的清单文件。

```
vi hosts

[tester]
my_tester_host ansible_user=cloud-user
```

使用您的组件详细信息编辑`octario.yml`。请确保指定名称和版本！

```
component
name: nova
version: 9
```

运行octario！在octario根目录下选择一个测试器并运行以下命令

```
ansible-playbook -vvv -i hosts playbooks/pep8.yml --extra-vars @octario.yml
```

pep8.yml可以用[unittest, functional, api, scenario].yml替换

### 自定义测试器

您可以指定自己的测试器

```
export TESTER=my_new_cool_tester
ansible-playbook -vvv -i hosts playbooks/custom-tester.yml --extra-vars @octario.yml
```

### 外部角色

您可以使用`octario`使用外部角色。

```
cp -r new_role octario/roles
导出 ROLE=new_role
ansible-playbook -vvv -i hosts playbooks/custom-role.yml --extra-vars @octario.yml
```

## 工作原理

以下插图添加以简化对简单测试者的`octario`工作流程概述。
包括 pep8、unittest 和功能测试。

<div align="center"><img src="./doc/octario_workflow.png" alt="Octario 工作流程"></div><hr />

### RPM 补丁

以下插图具体说明了使用 Octario 执行 RPM 补丁的方式。

要包含 patch_rpm 角色运行 playbooks/<tester>-with-patching.yml

<div align="center"><img src="./doc/patch_rpm.png" alt="Octario 补丁 RPM 工作流程"></div><hr />

## 更多文档

查看此存储库的 [/doc](https://github.com/redhat-openstack/octario/tree/master/doc) 目录。