在Docker中运行ReadyAPI功能测试

镜像概述

ready-api-soapui-testrunner Docker镜像用于在容器内运行ReadyAPI功能测试。

许可证要求

使用此镜像必须拥有ReadyAPI Test浮动许可证。运行容器时，它会连接到指定的许可证服务器并获取许可证。许可证服务器必须对容器可用且配置正确。

• 对于基于文件的许可证，请访问ReadyAPI文档中的配置许可证服务器。
• 对于在manage.smartbear.com上分配给您的或转换并配置为本地使用的基于SmartBear ID的许可证，请访问此页面获取说明。

Docker命令语法

要在Docker容器中运行ReadyAPI功能测试，请使用以下命令行：

docker run -v="项目文件夹":/project -v="报告文件夹":/reports -v="扩展文件夹":/ext -e LICENSE_SERVER="许可证服务器地址" -e COMMAND_LINE="测试运行器参数" -it smartbear/ready-api-soapui-testrunner:latest

如果您已迁移到ReadyAPI 3.8.1中引入的新SmartBear ID-based许可证，必须在docker run命令中添加以下参数：

docker run -v="C:\TestDocker\Projects":/project -e SLM_LICENSE_SERVER="<SLM许可证服务器地址（在线或本地）>" -e API_KEY="<浮动SLM的API密钥>" -e COMMAND_LINE="'-EDefault environment' -sTestSuite-Main -cTestCase-Main '/%project%/Project-func-test.xml'" -it smartbear/ready-api-soapui-testrunner:<tag>

参数说明

• -v=项目文件夹:/project
  必填。指定包含ReadyAPI项目的文件夹路径。容器启动时，此文件夹会被复制到容器中。
  使用示例：-v="C:\Work\ReadyAPI Project":/project
  注意：在某些系统上，可能需要修改路径格式："C:\Work\ReadyAPI Project" -> "/host_mnt/C/Work/ReadyAPI Project"

• -v=报告文件夹:/reports
  指定用于导出测试报告的本地文件夹路径。
  使用示例：-v="C:\Work\Reports":/reports
  注意：在某些系统上，可能需要修改路径格式："C:\Work\Reports" -> "/host_mnt/C/Work/Reports"

• -v=扩展文件夹:/ext
  指定其内容应复制到容器中ReadyAPI安装的/bin/ext文件夹的文件夹。如果项目需要其他库（如数据库驱动程序或插件），请使用此参数。
  使用示例：-v="C:\Work\ReadyAPI Extensions":/ext
  注意：在某些系统上，可能需要修改路径格式："C:\Work\ReadyAPI Extensions" -> "/host_mnt/C/Work/ReadyAPI Extensions"

• -e LICENSE_SERVER="许可证服务器地址"
  必填。指定许可证服务器地址。容器运行时，会连接到指定服务器获取ReadyAPI Test浮动许可证。
  使用示例：-e LICENSE_SERVER="10.0.21.14:1099"

• -e SLM_LICENSE_SERVER="[*]"**
  必填（适用于SmartBear ID-based许可证）。指定SmartBear许可证管理服务器（SLM）地址。确保容器能够连接以下地址：

  • [***]
  • [***]
  • -e API_KEY="9a######-####-####-####-##########97"
    注意：如果使用本地SLM，请参考此页面的说明。

• -e COMMAND_LINE="测试运行器参数"
  必填。指定测试运行器的参数。使用%project%变量引用项目卷，%reports%变量引用报告卷。
  使用示例：-e COMMAND_LINE="-f/%reports% '-RJUnit-Style HTML Report' -FHTML '-EDefault environment' '/%project%/Sample-readyapi-project.xml'"

• -it
  必填。启用Docker容器内的交互式命令行界面。

• smartbear/ready-api-soapui-testrunner:latest
  必填。指定用于创建容器的镜像。

完整命令示例

docker run -v="C:\TestDocker\Projects":/project -e SLM_LICENSE_SERVER="<本地SLM许可证服务器地址>" -e API_KEY="<浮动SLM的API密钥>" -e COMMAND_LINE="'-EDefault environment' -sTestSuite-Main -cTestCase-Main '/%project%/Project-func-test.xml'" -it smartbear/ready-api-soapui-testrunner:<tag>

退出代码

除标准Docker退出代码（参见Docker文档）外，ready-api-soapui-testrunner Docker镜像使用以下代码：

故障排除

如果因Drive has not been shared（驱动器未共享）错误无法运行Docker，请执行以下步骤：

1. 右键点击通知区域中的Docker图标，选择设置。
2. 在设置对话框的共享驱动器页面，选择所有用于运行Docker镜像的驱动器。
3. 点击应用。可能需要输入系统账户凭据以应用更改。

注意：如果驱动器已共享但仍出现错误，请关闭共享。应用更改后，重复上述步骤重新共享驱动器。