Microsoft Azure DevOps Server (UA) Integration
Overview
This topic describes how to run the Unified Agent from within Microsoft Azure DevOps Server (previously Team Foundation Server).
Prerequisites
- Download and install the Java JRE/JDK. See the Unified Agent prerequisites for supported Java versions.
- Set your JAVA_HOME system variable to the relevant Java version (see version in previous step).
- Make sure you have the Team Foundation Server 2018 Update 2 or a later version.
Integrating Microsoft Azure DevOps Server
- Open a browser and navigate to your Azure DevOps Server / TFS (for example: http://SERVER_NAME:8080/tfs/DefaultCollection).
- Create a new project or open an existing one. Make sure your project has a valid repository.
- Download the TFS agent (If you haven't already). To download the agent, apply the following:
- Go to your project settings and select 'Agent Queues'.
- Click on 'Download agent' and follow the instructions for setting up the agent and running it.
- You should have an agent running at this step.
- Go to 'Build and Release'
- Click on 'New definition' or select an existing definition.
- For a new definition, select a relevant source, click 'Continue', then create an 'Empty process'.
Go to your 'Tasks'.
- Add a new Task:
- Search for 'Command Line'
- Click on 'Add' next to the task.
- Click on the task from the left-hand section. Enter 'Run curl jar' in the 'Display name' field.
Enter 'curl' in the 'Tool' field.
- Enter "-LJO https://github.com/whitesource/unified-agent-distribution/releases/latest/download/wss-unified-agent.jar" in the 'Arguments' field.
- Copy the above task by right clicking on it, and then click on 'Clone task(s)'.
- Click on the task from the left-hand section and enter 'Run curl config' in the 'Display name' field.
- Enter 'curl' in the 'Tool' field.
- Enter '-LJO https://github.com/whitesource/unified-agent-distribution/raw/master/standAlone/wss-unified-agent.config' in the 'Arguments' field.
- Copy the above task by right clicking on it, and click on "Clone task(s)".
- Click on the task from the left-hand section and enter 'Run FSA' in the 'Display name' field.
- Enter 'java' in the 'Tool' field.
- Enter '-jar wss-unified-agent.jar -c wss-unified-agent.config -apiKey YOUR_WHITESOURCE_API_KEY -project PROJECT_NAME' in the 'Arguments' field.
- Click on 'Save & queue'.
- Congratulations, Unified Agent is now running on your Azure DevOps Server / TFS repository!