This page provides step-by-step instructions on how to run the Unified Agent from Azure DevOps Services.
NOTE: Before you begin, make sure that the relevant package manager is installed. For details, see https://whitesource.atlassian.net/wiki/spaces/WD/pages/1140852201/Getting+Started+with+the+Unified+Agent#Prerequisites.
Unified Agent Configuration
The below integration uses environment variables to configure the Unified Agent so that the default configuration values are used.
For more information, see the following articles
Setting up Your Build Pipeline
Go to Pipelines > Builds > New > New Build Pipeline.
Select the source for your code. You can create a pipeline using YAML (Option 1), or use the classic editor to create a pipeline without YAML (Option 2).
Option 1: Creating a Pipeline Using YAML
In the Where is your code? screen, select a YAML-enabled option.
In the Select a repository screen, select your repository.
In Configure your pipeline, select the relevant pipeline configuration.
In Review your pipeline YAML, add the following text as a post-build step. This activates the WhiteSource integration on your build pipeline.
- script: |
curl -LJO https://unified-agent.s3.amazonaws.com/wss-unified-agent.jar
echo Unified Agent downloaded successfully
java -jar wss-unified-agent.jar
displayName: 'WhiteSource Unified Agent Scan'
Add environment variables for APIKEY, USERKEY, and WSS_URL, as described by the Microsoft documentation, https://docs.microsoft.com/en-us/azure/devops/pipelines/process/variables?view=azure-devops&tabs=yaml%2Cbatch
Click Save and run.
Option 2: Creating a Pipeline Without YAML (Classic Editor)
Select the type of repository:
Select an Empty job:
Enter a name for the job and select an Agent pool:
Add the relevant build task (Maven, npm, Gradle, .NET Core, etc.).
Add a Command Line task and update the following fields to activate the WhiteSource integration on your build pipeline.
Click Save & queue.