This role install the VSTS Build Agent on Windows or Linux servers.

There are no external requirements for this role.

There are a few variables that can be set from the playbook if you like.

This is the directory where the VSTS installation package will be downloaded to.

  download_dir: "C:\\Windows\\Temp"

  download_dir: "/tmp"

This is the directory where VSTS will be extracted into

  vsts_dir: "C:\\vsts"

  terraform_dir: "/opt/vsts"

This is the version of the VSTS agent that will be installed, the complete list can be found on the Azure Pipelines Github Releases page.

  vsts_version: 2.175.2

The following list of variables are used for installation of the agent, this role deploys a specific way currently, hopefuly as I progress more with Ansible this role will become more flexible. The complete list of options for Windows or Linux.

This is your Azure Devops Organization URL

  vsts_url: https://dev.azure.com/myorganizationame

This variable defines the authentication option, we default to PAT

This is the PAT token that is generated from within your Azure Devops Organization see here.

This is the name of the pool that your server will belong to see here.

This is used for the Windows Installation, an admin account for the service to run as, currently this role does not create a user account.

This is used for the Windows Installation, an admin account for the service to run as, currently this role does not create a user account.

There are no external dependencies for this role.

This example shows the basic use of this role.

    - hosts: all
      roles:
         - vsts
      vars:
        vsts_url: "https://dev.azure.com/myorganization"
        vsts_token: "PAT TOKEN"
        vsts_pool: "BuildAgents"
        vsts_account: "Administrator"
        vsts_password: "P@ssw0rd"

MIT

My name is Jeff Patton, feel free to contact me via issues.