CircleCI Integration

Image result for circleci

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, do as follows:

  1. Add the following build steps to your circle.yml file:

  2. 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.

          Then, the script runs the jar with the regular command line arguments of the Unified Agent.

          Make sure to edit the Unified Agent configuration file to match your needs.

          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

Commands File

The commands file prepares the environment for Circle CI Orbs integration to run as expected, in addition to adding NuGet to the resolution.

Commands file example: