https://github.com/jenkinsci/plugin-compat-tester

Jenkins Plugin Compatibility Tester
https://github.com/jenkinsci/plugin-compat-tester

compatibility-testing jenkins pct

Last synced: 6 days ago
JSON representation

Jenkins Plugin Compatibility Tester

• Host: GitHub
• URL: https://github.com/jenkinsci/plugin-compat-tester
• Owner: jenkinsci
• License: mit
• Created: 2011-04-04T20:59:01.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2024-10-29T08:21:55.000Z (10 days ago)
• Last Synced: 2024-10-29T09:42:50.939Z (10 days ago)
• Topics: compatibility-testing, jenkins, pct
• Language: Java
• Homepage:
• Size: 2.26 MB
• Stars: 46
• Watchers: 101
• Forks: 53
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
Plugin Compatibility Tester (PCT)

------

[![GitHub release (latest by date)](https://img.shields.io/github/v/release/jenkinsci/plugin-compat-tester?label=changelog)](https://github.com/jenkinsci/plugin-compat-tester/releases)

Generates a compatibility matrix for plugins against Jenkins core.

## Running PCT

The PCT CLI requires passing a WAR file containing plugins (generated from `jenkinsci/bom`, for example) as input;

the versions of the plugins are inferred from the WAR file contents.

```shell

java -jar target/plugins-compat-tester-cli.jar \

    --war "$(pwd)/megawar.war" \

    --working-dir "$(pwd)/pct-work"

```

To test a subset of plugins in the WAR, use `--include-plugins`:

```shell

java -jar target/plugins-compat-tester-cli.jar \

    --war "$(pwd)/megawar.war" \

    --include-plugins ssh-slaves,credentials \

    --working-dir "$(pwd)/pct-work"

```

You can run the CLI with the `--help` argument to get a full list of supported options.

### Running PCT with custom Java versions

PCT simply invokes Maven, which relies on the `JAVA_HOME` environment variable.

If you want to use a custom Java version, set `JAVA_HOME` appropriately before running PCT.

## Useful links

* Devoxx '11 BOF Presentation about Plugin Compat Tester is available [here](http://www.slideshare.net/fcamblor/devoxx-2011-jenkins-bof-on-plugin-compatibility-tester). This presentation is partially obsolete (GAE feature was removed in recent versions)