Please read the general information about External Update Agents before any Teamcity specific documentation.
The plugin integrates automatic open source management with Jetbrains TeamCity.
Once set up, all usage of open source software in the organization will be continuously and automatically in sync with White Source.
- New projects will be created
- Existing projects will be updated
- Policies will be enforced on every action, failing the build if necessary.
The plugin currently support projects built using maven, ant, and shell scripts.
How it works
On execution, the plugin will determine which open source is currently used by your project and send it to White Source.
No source code is scanned. Only descriptive information is sent over the wire.
White Source uses the collected information to create new projects or update existing ones.
Policy check flow
The plugin will check each new library against the organizational policies. If any library should be automatically rejected by some policy the build will fail. Otherwise your account will be updated.
An informative report of the results will be generated regardless of the outcome.
Installing the plugin
Download the plugin
|Teamcity version||White Source plugin|
Copy the packaged file into Teamcity's plugin folder located at $TEAMCITY_USER_HOME/.BuildServer/plugins
Restart the server
Using the plugin
Start by configuring the global settings, this settings will be applies to every project in your TeamCity. Then setup which jobs should interact with White Source.
Once the plugin is installed go to Administration -> Server Configuration -> White Source.
A unique identifier of the organization. You can get yours in the administration section in your White Source account.
Checking this option will check policies before any update.
Optional. If your TeamCity is behind a firewall you should configure it here in order to allow communication with the White Source servers.
Job specific settings
Only supported runner types will have this options visible.
Build runners that have no concise system for managing dependencies require a different configuration.
What we're looking for is descriptive information about each library used. What we need to know is which libraries to include and where we can find them, that is the sole purpose of the configuration.
Install the plugin and import data into White Source.
Apply policy check before updating White Source.
- Communication with White Source servers is now encrypted using SSL by default.
- Several bug fixes in policy check report
- Code refactor
First release of the plugin.