| Table of Contents |
|---|
...
Overview
CircleCi is a continuous integration development platform that is being used by software teams in order to enable them to build, test and deploy applications easier and faster on multiple platforms.
How
...
CircleCI Integration Works
To integrate CircleCi with WhiteSource, apply the following proceduredo as follows:
Add the following build steps to your circle.yml file:
Info title Notice on periodically fetching the Unified Agent It is advised to use the below curl command only once a week to download the latest version of the Unified Agent for performance reasons and not as part of every build. You can do this using a task scheduler, such as cron.
Code Block language bash theme Midnight title Sample circle.yml with WhiteSource integration steps: - run: bash <(curl -s -L https://github.com/whitesource/unified-agent-distribution/raw/master/standAlone/wss_agent.sh) -apiKey xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx -c [path to config file] -project circle-ci_test -d ~/
- This command runs the script "wss_agent.sh". It downloads the latest version of the WhiteSource Unified Agent jar file and config file to your CircleCI host.
...
Make sure to edit the Unified Agent configuration file to match your needs.
| Info |
|---|
The API key is confidential and should be hidden. Consider using it as an environment variable in your .yml file. |
See the Unified Agent command line parameters for further information.
Use the API key and determine the name of the WhiteSource project.
2. Run the build. After the CircleCI build completes with a WhiteSource scan, you can review the scanning results in your WhiteSource organization.
Examples
Basic Example:
script: - pipe: WhitesourceSoftware/whitesource-scan:1.3.0 |
Advanced Example:
script: - pipe: WhitesourceSoftware/whitesource-scan:1.3.0 variables: API_KEY: $API_KEY DIRECTORY: '.' CONFIG_FILE_PATH: './someFolder/wss-unified-agent.config' COMMANDS_FILE_PATH: './someFolder/install-commands.sh |
...