https://github.com/jenkinsci/tacotruck-plugin
Tacotruck jenkins plugin
https://github.com/jenkinsci/tacotruck-plugin
automation junit testing
Last synced: 11 days ago
JSON representation
Tacotruck jenkins plugin
- Host: GitHub
- URL: https://github.com/jenkinsci/tacotruck-plugin
- Owner: jenkinsci
- License: mit
- Created: 2025-10-08T15:51:56.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-10-22T04:21:18.000Z (9 months ago)
- Last Synced: 2026-06-19T08:41:51.651Z (16 days ago)
- Topics: automation, junit, testing
- Language: Java
- Homepage: https://plugins.jenkins.io/tacotruck/
- Size: 61.5 KB
- Stars: 0
- Watchers: 0
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# TacoTruck Jenkins Plugin
[](https://github.com/jenkinsci/tacotruck-plugin/releases/latest)
[](https://github.com/jenkinsci/tacotruck-plugin/actions/workflows/jenkins-security-scan.yml)
[](https://github.com/jenkinsci/tacotruck-plugin/blob/master/LICENSE)
A Jenkins plugin that provides build step integration with [TacoTruck](https://github.com/testfiesta/tacotruck)
## Configuration
### Global Configuration
Currently, no global configuration is required for this plugin.
### Job Configuration
#### Freestyle Jobs
1. Add a build step "TacoTruck Integration"
2. Configure the following parameters:
- **Provider**: Select the provider from the dropdown (currently supported: `testfiesta`)
- **Run Name**: A descriptive name for this integration step
- **API URL**: The TacoTruck service endpoint URL
- **Project**: (Optional) Project identifier
- **Credentials**: Select appropriate credentials from the dropdown
- **Results Path**: Path to the test results file
- **Handle**: username or organization handle
- **Source**: (Optional) Source identifier for the test results
#### Pipeline Jobs
Use the `tacotruck` step in your Jenkinsfile with the nodejs buildwrapper:
```groovy
pipeline {
agent any
tools { nodejs 'Node 20.x' }
stages {
stage('Submit Test Results') {
steps {
tacotruck(
provider: 'testfiesta',
runName: 'My TacoTruck Run',
apiUrl: 'https://staging.api.testfiesta.com',
handle: 'TestHandle',
project: 'testProjectKey',
credentialsId: 'YOUR_CREDENTIALS_ID',
resultsPath: './test-results.xml',
source: 'jenkins-ci' // Optional: source identifier
)
}
}
}
}
```
**Note**: The `tacotruck` step must be wrapped inside a `nodejs` buildwrapper block to ensure npm and npx are available in the PATH.
### Credentials Setup
This plugin supports both username/password and API token credentials:
1. Go to **Manage Jenkins** → **Manage Credentials**
2. Add credentials of type:
- **Username with password** for basic authentication
- **Secret text** for API token authentication
## Requirements
- Jenkins 2.479.3 or later
- Java 17 or later
## Development
### Building the Plugin
```bash
mvn clean package
```
### Running Tests
```bash
mvn test
```
### Local Development
```bash
mvn hpi:run
mvn hpi:run -Dport=5000 (running on port 5000)
```
This will start a Jenkins instance with the plugin loaded at `http://localhost:8080/jenkins`
## Issues and Support
Report issues and feature requests on [GitHub Issues](https://github.com/jenkinsci/tacotruck-plugin/issues).
### Development Setup
1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests for new functionality
5. Ensure all tests pass
6. Submit a pull request
## License
Licensed under the MIT License. See [LICENSE](LICENSE.md) for details.