{"id":18148263,"url":"https://github.com/jenkinsci/ecu-test-execution-plugin","last_synced_at":"2025-09-11T06:35:19.609Z","repository":{"id":61796680,"uuid":"521584800","full_name":"jenkinsci/ecu-test-execution-plugin","owner":"jenkinsci","description":"This plugin enables a platform-independent test execution. It integrates ecu.test and trace.check with Jenkins and allows report generation and its upload of automated test execution.","archived":false,"fork":false,"pushed_at":"2025-08-13T09:36:25.000Z","size":646,"stargazers_count":8,"open_issues_count":8,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-08-13T10:24:38.243Z","etag":null,"topics":["builder","ecu-test","external","jenkins","jenkins-plugin","report","rest-api","test-guide","testautomation","trace-check","tracetronic"],"latest_commit_sha":null,"homepage":"https://plugins.jenkins.io/ecu-test-execution/","language":"Groovy","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"tracetronic/ecu-test-execution-plugin","license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jenkinsci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-08-05T09:48:53.000Z","updated_at":"2025-08-13T09:36:27.000Z","dependencies_parsed_at":"2023-09-22T22:39:05.980Z","dependency_job_id":"afa19555-f502-4d53-80a2-931986b54704","html_url":"https://github.com/jenkinsci/ecu-test-execution-plugin","commit_stats":null,"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/jenkinsci/ecu-test-execution-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fecu-test-execution-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fecu-test-execution-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fecu-test-execution-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fecu-test-execution-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jenkinsci","download_url":"https://codeload.github.com/jenkinsci/ecu-test-execution-plugin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jenkinsci%2Fecu-test-execution-plugin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274589627,"owners_count":25312971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-11T02:00:13.660Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["builder","ecu-test","external","jenkins","jenkins-plugin","report","rest-api","test-guide","testautomation","trace-check","tracetronic"],"created_at":"2024-11-01T23:07:47.723Z","updated_at":"2025-09-11T06:35:19.601Z","avatar_url":"https://github.com/jenkinsci.png","language":"Groovy","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ecu.test execution plugin\n\n[![Build Status](https://ci.jenkins.io/buildStatus/icon?job=plugins/ecu-test-execution-plugin/main)](https://ci.jenkins.io/job/plugins/job/ecu-test-execution-plugin/job/main) [![Jenkins Plugin](https://img.shields.io/jenkins/plugin/v/ecu-test-execution.svg)](https://plugins.jenkins.io/ecu-test-execution) [![Jenkins Release](https://img.shields.io/github/release/jenkinsci/ecu-test-execution-plugin.svg?label=changelog\u0026color=orange)](https://github.com/jenkinsci/ecu-test-execution-plugin/releases) [![Plugin Installs](https://img.shields.io/jenkins/plugin/i/ecu-test-execution.svg?color=blue\u0026logo=jenkins\u0026logoColor=white)](https://plugins.jenkins.io/ecu-test-execution) [![License](https://img.shields.io/badge/license-3--clause%20BSD-blue.svg?style=flat\u0026logo=opensourceinitiative\u0026logoColor=white\u0026color=green)](https://github.com/jenkinsci/ecu-test-execution-plugin/blob/main/LICENSE)\n\nThis plugin enables a platform-independent test execution. Due to the reduced complexity and communication via REST API,\nit provides an easy and reliable entry into continuous testing. It integrates\n[ecu.test](https://www.tracetronic.com/products/ecu-test)\nand [trace.check](https://www.tracetronic.com/products/trace-check/) with Jenkins and allows report generation and its\nupload of\nautomated test execution.\u003cbr\u003e\u003cbr\u003e\n\n\u003cimg src=\"docs/images/ecu.test.png\" align=\"left\" alt=\"ecu.test Logo\" style=\"padding-right: 15px;height:150px\"\u003e \n\necu.test is a test automation software for the validation of embedded systems in automotive environments developed by\ntracetronic GmbH.\u003cbr/\u003e\nThis software executes regression tests which are essential for validating complex technical products such as electronic\ncontrol units (ECUs).\u003cbr/\u003e\nIt supports standardized access to a broad range of test tools and provides automation of distributed test\nenvironments (SiL – MiL – HiL – vehicle).\u003cbr\u003e\u003cbr\u003e\n\n**tracetronic ecu.test Jenkins Plugin** project is part of\nthe [Automotive DevOps Platform](https://www.tracetronic.com/products/automotive-devops-platform/) by tracetronic. With\nthe **Automotive DevOps Platform**, we go from the big picture to the details and unite all phases of vehicle software\ntesting – from planning the test scopes to summarizing the test results. At the same time, continuous monitoring across\nall test phases always provides an overview of all activities – even with several thousand test executions per day and\nin different test environments.\u003cbr\u003e\u003cbr\u003e\n\nPlease consider other open-source automation solutions by [tracetronic](https://github.com/tracetronic?type=source),\nespecially [Jenkins Library](https://github.com/tracetronic/jenkins-library)\nand [CX Templates](https://github.com/tracetronic/cx-templates).\n\n## Table of Contents\n\n- [Features](#features)\n- [Configuration](#configuration)\n    - [Tool configuration](#tool-configuration)\n    - [Pipeline job configuration](#pipeline-job-configuration)\n- [Migration](#migration)\n- [Contribution](#contribution)\n- [Known Issues](#known-issues)\n- [Compatibility](#compatibility)\n- [Support](#support)\n- [License](#license)\n\n## Features\n\n- Provides an easy integration and control of ecu.test and trace.check with Jenkins\n- Enables perfoming package and project checks with rules defined in ecu.test.\n    - [Custom-Checks](https://github.com/tracetronic/ecu-test_custom-checks) provides an easy way to configure and\n      import these checks.\n- Enables the execution of ecu.test packages and projects with their respective configurations\n- Enables the upload of generated test reports to [test.guide](https://www.tracetronic.com/products/test-guide/)\n- Using \"pipelines first\" approach to improve the automated process and traceability\n\n## Configuration\n\n### Tool configuration\n\necu.test and trace.check installations are administrated in the global tool configuration at section \"ecu.test\". An\ninstallation entry\nis specified by an arbitrary name and the full path including the executable file extension. The execution on a Jenkins\nagent requires\nthe adaptation of the path to the executable of the tool on the agent configuration page.\n\n![ecu.test](docs/images/ecu.test-config.png \"ecu.test-config\")\n\n### Pipeline job configuration\n\nThe [Pipeline Plugin](https://plugins.jenkins.io/workflow-aggregator) allows to orchestrate automation simple. This\nplugin supports the use of all provided build steps from within a Jenkins Pipeline build. The appropriate DSL syntax for\nthese steps and actions can be easily generated with help of\nthe [Pipeline Snippet Generator](https://github.com/jenkinsci/pipeline-plugin/blob/master/TUTORIAL.md#exploring-the-snippet-generator)\n.\n\n```groovy\nnode('windows') {\n    stage('Start Tools') {\n        ttStartTool toolName: 'ecu.test', workspaceDir: './workspace', settingsDir: './settings'\n    }\n    stage('Package Checks') {\n        ttCheckPackage testCasePath: 'sample.pkg'\n        ttCheckPackage testCasePath: 'sample.prj'\n    }\n    stage('Test Execution') {\n        ttRunProject testCasePath: 'sample.prj', testConfig: [tbcPath: 'sample.tbc', tcfPath: 'sample.tcf', constants: [[label: 'sample', value: '123']]]\n        ttRunPackage testCasePath: 'sample.pkg', testConfig: [tbcPath: '', tcfPath: '', forceConfigurationReload: true, constants: [[label: 'sample', value: '\\'sampleValue\\'']]]\n    }\n    stage('Provide ecu.test logs in jenkins') {\n        ttProvideLogs(publishConfig: [allowMissing: true, timeout: 10, keepAll: true])\n    }\n    stage('Provide ecu.test trf/prf reports in jenkins') {\n        ttProvideReports(publishConfig: [allowMissing: true, timeout: 10, keepAll: true])\n    }\n    stage('Generate Reports') {\n        ttGenerateReports 'HTML'\n    }\n    stage('Upload Reports') {\n        ttUploadReports credentialsId: 'tgAuthKey', projectId: 1, testGuideUrl: 'http://HOST:Port'\n        ttUploadReports tgConfiguration: 'jenkinsTGConfigurationName'\n    }\n    stage('Stop Tools') {\n        ttStopTool 'ecu.test'\n    }\n}\n```\n\nThe [test.guide](https://www.tracetronic.com/products/test-guide/) authentication key has to be set as a Jenkins\n[credential](https://www.jenkins.io/doc/book/using/using-credentials/) (secret text) to be used in the\n*ttUploadReports* step.\nThe usage of username and password credentials is only there for compatibility reasons.\n\nCheck out the [advanced usage docs](./docs/AdvancedUsage.md) for more detailed information\n\n## Migration\n\nSee [migration guide](docs/Migration.md) for information about how to migrate from previous plugin version 2.x to 3.x\nusing the new pipeline syntax.\n\n## Contribution\n\nTo report a bug or request an enhancement to this plugin please raise a\nnew [GitHub issue](https://github.com/jenkinsci/ecu-test-execution-plugin/issues/new/choose).\n\n## Known Issues\n\nWhen encountering problems or error messages, please check the installed plugin version at first and update to the most\nrecent version, if any.\nIf the problem still exists search the following list of issues for possible solutions, otherwise you are asked to\ncreate an [issue](#contribution).\n\n\u003cdetails\u003e\n    \u003csummary\u003eWhen executing ttRunTestFolders, an error with the messages that the path does not exist occurs.\u003c/summary\u003e\n\n\u003e This is an issue related to the path resolution. To resolve paths correctly, ecu.test needs to be run either\n\u003e on the server or on a machine together with the step-executing Jenkins agent. This means, in particular, that, when\n\u003e using a containerized version of ecu.test, the executing Jenkins agent needs to be within the same container.\n\u003c/details\u003e\n\n## Compatibility\n\n- Jenkins LTS 2.332.3 or higher\n- Java SE Runtime Environment 11 or higher\n\n \u003cdetails\u003e\n    \u003csummary\u003e\u003ca href=\"https://www.tracetronic.com/products/ecu-test\"\u003eecu.test\u003c/a\u003e/\n    \u003ca href=\"https://www.tracetronic.com/products/trace-check/\"\u003etrace.check\u003c/a\u003e compat matrix (min 2022.4) \u003c/summary\u003e\n\n| Version         |    latest - 3.7    |     3.6 - 3.5      |     3.4 - 3.1      |        3.0         |\n|-----------------|:------------------:|:------------------:|:------------------:|:------------------:|\n| 2024.4 - 2025.2 | :heavy_check_mark: |        :x:         |        :x:         |        :x:         |\n| 2024.2 - 2024.3 | :heavy_check_mark: | :heavy_check_mark: |        :x:         |        :x:         |\n| 2023.3 - 2024.1 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |        :x:         |\n| 2022.4 - 2023.2 | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: |\n\n:warning: Please note that compatibility for trace.check is only warranted for __Windows__ OS.\n\n\u003c/details\u003e\n\u003cdetails\u003e\n    \u003csummary\u003eoptional: \u003ca href=\"https://www.tracetronic.com/products/test-guide\"\u003etest.guide\u003c/a\u003e compat matrix (min 1.142.0)\u003c/summary\u003e\n\n| Version | latest - 3.6       |     3.5 - 3.0      |\n|---------|--------------------|:------------------:|\n| 1.180.0 | :heavy_check_mark: | :heavy_check_mark: |\n| 1.178.0 | :heavy_check_mark: | :heavy_check_mark: |\n| 1.147.0 | :x:                | :heavy_check_mark: |\n| 1.142.0 | :x:                | :heavy_check_mark: |\n\n \u003c/details\u003e\n\n## Support\n\nIf you have any further questions, please contact us at [support@tracetronic.com](mailto:support@tracetronic.com).\n\n## License\n\nThis plugin is licensed under the terms of the [3-Clause BSD license](LICENSES/BSD-3-Clause.txt).\n\nUsing the [REUSE helper tool](https://github.com/fsfe/reuse-tool), you can run `reuse spdx` to get a bill of materials.\nFor 3rd party dependencies you can use `./gradlew checkLicense`. The third-party dependencies are generated in\n_./build/licenses/_.\n\nTo generate a software bill of material (sbom) for the project run ```./gradlew cyclonedxBom```. The generated _sbom_\ndestination is ```build/reports/bom.json```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fecu-test-execution-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjenkinsci%2Fecu-test-execution-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjenkinsci%2Fecu-test-execution-plugin/lists"}