云数据库GaussDB管理平台（TPOPS）--自动化验收工具使用指南

自动化验收工具使用指南

工具介绍

在云数据库GaussDB管理平台（TPOPS）安装或者升级后，可以通过使用该工具来自动化实现实例的安装、创建备份、参数修改、重启实例、删除实例这五个基本功能的验证。

约束限制

• 需要提前准备好安装实例所需的主机，并且参考添加主机章节完成主机上线。
• 目前只预制了集中式单节点、三节点以及分布式版单节点、三节点这四种形态。
• 需要提前在云数据库GaussDB管理平台上录入可用的NAS存储设备，在创建实例的时候会从存储设备列表中取默认设备用来挂载NAS，如果检测到无可用的NAS设备，则备份任务有可能会失败。

操作步骤

1. 使用前需要检查pytest、pytest-html插件是否已经安装。

    

   • 执行以下命令进行检查pytest是否安装。

     pytest --version

     回显如下，说明pytest插件已安装。

     

     如果未安装pytest，则执行如下命令进行安装，推荐安装pytest的版本为7.4.4。

     pip3 install pytest==7.4.4

   • 执行以下命令进行检查pytest-html是否安装。

     pip3 show pytest-html

     回显如下，说明pytest-html插件已安装。

     

     如果未安装pytest-html，则执行如下命令进行安装，推荐安装pytest-html的版本为4.0.0.RC7。

     pip3 install pytest-html==4.0.0.RC7

   

   如果执行结果返回“-bash: pip: command not found”，请先安装PIP工具。有关PIP工具的安装方法，请联系系统提供商获取或者参考PIP官网进行安装。

    

2. 以4.2.5 上传软件包 步骤二的目录为例，执行以下命令进入到验收工具所在目录。

    

   cd /data/docker-service/action/autoTest

    

3. 执行如下命令，修改环境信息文件。

    

   vi /data/docker-service/action/autoTest/common/env_const.py

   文件内容如下：

   

   • tpops_ip_port为云数据库管理平台（TPOPS）任一IP:8002，只需要修改前面IP部分，端口固定为8002。
   • user_name为云数据库管理平台（TPOPS）用户名。
   • password为user_name用户名对应的密码。

    

4. 修改完成后，执行:wq!命令保存并退出。
5. 执行如下命令，查看安装实例的配置文件。

    

   ll config/

   可以看到该目录下内容为：

   

   • test_create_centralize_single_instance_operation.json为集中式版单节点实例形态的配置文件。
   • test_create_centralize_triset_instance_operation.json为集中式版三节点实例形态的配置文件。
   • test_create_combined_single_instance_operation.json为分布式版单节点实例形态的配置文件。
   • test_create_combined_triset_instance_operation.json为分布式版三节点实例形态的配置文件

    

6. 参考自动化验收工具实例配置文件参数说明章节，根据自己的主机信息，对实例配置文件中arch、cpu_spec、host_type、os_type、small_os_version、manage_ip参数进行修改。

    

   例如：如果要启动集中式版单节点实例的自动化验收用例，则修改test_create_centralize_single_instance_operation.json文件即可。

    

7. 修改完安装实例的配置文件后，执行如下命令，即可启动对应的自动化验收用例。

    

   • pytest -m centralize_single：此命令用来启动集中式版单节点形态用例。
   • pytest -m centralize_triset：此命令用来启动集中式版三节点形态用例。
   • pytest -m combined_single：此命令用来启动分布式版单节点形态用例。
   • pytest -m combined_triset：此命令用来启动分布式版三节点形态用例。

    

8. 当所有用例都完成后，在当前的执行目录，即/data/docker-service/action/autoTest目录下会生成一份名为“report_时间戳”格式的验收报告文件，其中包括了每个用例的执行情况、运行日志等。

    

   

   • 在所有用例执行完成后，实例会自动进行删除，无需进行手动删除操作。
   • 验收报告文件请放在英文路径下进行查看，如果路径中包含中文，则可能会导致报告乱码。

    

 

更多详情请参考GaussDB 文档中心：https://doc.hcs.huawei.com/db/zh-cn/gaussdbqlh/24.1.30/productdesc/qlh_03_0001.html