# 使用前准备
用户想将已有项目的测试用例对接到CodeArts TestPlan自动化测试工厂，需要按照以下条件进行准备：
#### 购买功能测试增值特性
- 用户在[功能测试购买页](https://console.huaweicloud.com/devcloud/#/period-new/apply?package_type=codearts_testplan_feature)已购买测试自动化工厂增值特性，可参考[测试自动化工厂增值特性](https://support.huaweicloud.com/price-testman/cloudtest_bill_2004.html#section1)。
 
#### 接入执行器前准备
- 使用测试自动化工厂需要打通调度平台和执行器之间的网络连接，需要配置VPCEP，可参考[配置VPC终端节点 VPCEP](https://support.huaweicloud.com/usermanual-vpcep/zh-cn_topic_0131645189.html)。
  在配置VPC终端节点中，服务名称可在测试计划服务"测试执行 \> 功能自动化 \> \> 执行器管理"中获取：
  图1获取终端节点服务名称   
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002407863722.png "点击放大")
  图2配置VPC终端节点的服务名称   
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002393753333.png "点击放大")
  购买完成后，根据服务节点名称，记录"服务地址"。拼接协议类型（https）和端口号（固定为8043）得到可用的对接地址。如下图，拼接为https://192.168.0.214:8043。
  ![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002289040956.png "点击放大")
  
- 准备ECS资源：测试自动化工厂特性需要依赖ECS资源打通云上云下网络，请参考[申请弹性云服务器ECS](https://support.huaweicloud.com/usermanual-ecs/ecs_03_7002.html)，购买时请选择"华南-广州"局点，当前测试自动化测试工厂只支持该局点。若您已经有满足条件的ECS资源，可忽略此操作。
  
  
您可以根据"通用测试框架场景（满足多个测试框架接入）"或"自定义测试框架场景"，选择接入通用执行器或自主设计、改造的自定义执行机。
- [通用测试框架场景]
  1. 登录测试计划服务首页，单击"首页"，选择项目。
  
  2. 在导航栏单击"测试 \> 测试执行"。
  
  3. 选择"功能自动化"。
  
  4. 单击"执行器管理 \> 执行器接入"。
  
  5. 在弹框中，选择"通用测试框架场景"。
  
  6. 根据需要选择以下测试框架（默认为Pytest）： 
     - Pytest：用于Python语言的单元自动化测试框架，支持简单的单元测试和复杂的功能测试和接口自动化测试，可以很好地与Jenkins集成。
     
     - Selenium：用于自动化Web应用程序测试的工具，支持多种浏览器和平台，并提供了多种编程语言的绑定，如 Python、Java、C# 等。
     
     - Hypium：适用于构建跨设备应用的自动化测试体系，支持Python语言编写脚本，提供控件定位、多设备并行测试等核心功能。
     
     - Appium：用于自动化移动应用（iOS、Android）的测试，使用 WebDriver 协议，允许开发者使用 Selenium/WebDriver 的 API 来控制移动设备上的应用。
     
     
     
     
  
  7. 确认主机有访问外网方式，并且已安装[JAVA8](https://openjdk.org/install/index.html)和[Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)。
  
  8. 输入"终端节点地址"，参考接入执行器前准备中的[获取终端节点的服务地址]。
  
  9. 单击"生成命令"。
  
  10. 单击![](https://support.huaweicloud.com/usermanual-testman/zh-cn_image_0000002289039772.png)，复制已生成的命令。
  
  11. 以管理员账户登录待安装主机，执行复制命令（windows通过git bash窗口），当显示【"success"】时，表示安装成功。
  
  12. 完成上述接入执行器步骤后，单击左侧导航栏"测试\>测试执行"，选择"功能自动化"页签，单击"新建套件\>创建任务"，在执行机列表中找到目标自执行器。
   
- [自定义测试框架场景]
  自定义测试框架场景需要开发并启动用户自定义的执行器（TepExecutor），TepExecutor开发示例您可以新建工单联系一线技术支持或您的客户经理获取。
  1. 登录测试计划服务首页，单击"首页"，选择项目。
  
  2. 在导航栏单击"测试 \> 测试执行"。
  
  3. 选择"功能自动化"。
  
  4. 单击"执行器管理 \> 执行器接入"。
  
  5. 在弹框中，选择"自定义测试框架场景"。
  
  6. 确认主机有访问外网方式，并且已安装[JAVA8](https://openjdk.org/install/index.html)和[Git](https://git-scm.com/book/en/v2/Getting-Started-Installing-Git)。
  
  7. 输入"终端节点地址"，参考接入执行器前准备中的[获取终端节点的服务地址]。
  
  8. 单击"下载Agent包"，下载执行器代理（TepAgent）软件包并在本地目录解压。
  
  9. 启动TepAgent，您可以参考以下配置信息，修改配置文件。 
     - tep.name：用户可自定义执行机名称，该名称在创建功能自动化测试任务中的执行机列表中展示。tep.name需要在tep.productId维度下唯一，如果执行机名称重复，注册时会删除已有重复名的执行机。
     
     - tep.type：执行机类型，对应用例的执行平台，可参考[设置CodeArts TestPlan测试用例字段](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0153.html)，配置"执行平台"字段后，功能自动化用例中可以选择该字段。
     
     
     
     
  
  10. 用户完成以上接入自定义执行器后，可单击左侧导航栏"测试\>测试执行"，选择"功能自动化"页签，单击"新建套件\>创建任务"，在执行机列表中找到tep.name名称的自定义执行机。
  
  
  
  
后续对自定义执行器的操作，可参考[执行器管理](https://support.huaweicloud.com/usermanual-testman/cloudtest_01_0239.html#cloudtest_01_0239__section3743241124415)。