ecu.test Linux Runner(ecu.test Linux 测试运行器)

ecu.test Linux Runner 不带图形用户界面,因此特别适合测试自动化;由于没有用户界面,它具有更高的执行速度和更少的依赖项。 它可以在 Linux 系统上执行现有 Workspace(工作区)中的 Package(测试包)和 Project(测试项目)等工件。 ecu.test Linux Runner 通过命令行启动,并通过 REST API 或 Command line (batch interface)(命令行(批处理接口)) 进行控制。

信息

可用的控制台参数可以通过 --help 输出:

ecu.test --help

具体用法详见 Basic Workflow on Linux Tutorial(Linux 基本工作流教程)。

此外,也可以使用 ecu.test Tool Server(工具服务器)连接 Linux 系统上的工具。 有关 ecu.test Tool Server 的更多信息,请参见 Tool Server(工具服务器) 章节。 在 Linux 上的使用方式见 Tool Server on Linux Tutorial(Linux 上的 Tool Server 教程)。

信息

如果已经安装 ecu.test Linux GUI,则命令 ecu.test 始终会启动 ecu.test Linux GUI。 ecu.test Linux Runner 可通过 ecu.test_runner 使用。

安装

ecu.test Linux Runner 可在不同环境中运行:

  • 物理机

  • 虚拟机

  • Windows Subsystem for Linux (WSL)

  • Docker

物理机、虚拟机或 WSL 的安装方式见章节 Installation on Linux(在 Linux 上安装)。 下一节介绍在 Docker 环境中使用 ecu.test Linux Runner 的方式。

在 Docker 容器中安装

提供了扩展名为 .tar.gz 的 UBI9 镜像,可在 Dockerfile 中用于启动 ecu.test Linux Runner。或者,也可以使用 Dockerfile 构建基于 Ubuntu 的自定义镜像。

安装

  1. 将镜像文件传输到 Linux 系统。

  2. 加载镜像:

    docker load --input <path_to_image.tar.gz>
    
  3. 列出所有镜像,以确定 ecu.test 镜像的 IMAGE ID:

    docker images
    
  4. 基于该镜像创建并运行容器:

    docker run -p 5050:5050 \
    -v <path_to_ecutest_workspace_on_host>:/app/workspace \
    -e TRACET_LICENSE=<license_server_url> \
    <IMAGE ID> \
    --workspaceDir /app/workspace \
    --restApiEnableRemoteAccess
    

    此命令完成以下操作:

    • 将主机系统的 5050 端口绑定到容器内的 5050 端口

    • 将 Workspace(工作区)<path_to_ecu.test_workspace_on_host> 挂载到容器中的 /app/workspace

    • 设置环境变量 TRACET_LICENSE,以便 ecu.test 可以获取有效许可证

    • 在容器中启动 ecu.test 并打开 Workspace(工作区)/app/workspace

    • 启用对 REST API 的访问

随后,主机可通过 http://localhost:5050/api/v2/ui 访问 REST API。

也可以在命令行中直接使用 execute 子命令执行 Package 或 Project:

docker run -p 5050:5050 \
-v <path_to_ecu.test_workspace_on_host>:/app/workspace \
-e TRACET_LICENSE=<license_server_url> \
<IMAGE ID> \
execute --workspace /app/workspace \
--testconfiguration myTCF.tcf \
--testbenchconfiguration myTBC.tbc \
testcase.pkg