btnguyen2k/azpagent-base repository overview

⁠Introduction

This repo provides pre-built images to run self-hosted Azure Pipelines agents.

GitHub repo: https://github.com/btnguyen2k/azp-k8s-agents⁠

⁠Prerequisites

Azure DevOps personal access token: A personal access token (PAT) is used as an alternate password to authenticate into Azure DevOps. Use PAT instead of your password to register the agent with Azure DevOps Agent Pool. Create one by following these instructions⁠.

The PAT must have at least Agent Pools (Read & manage) scope.

Azure Pipelines agent pool: The Azure Pipelines agent will join an agent pool⁠ so that it can be used. You can create a new agent pool or use an existing one.

⁠Deploy the agent to Docker

The Azure Pipelines agent can be deployed as Docker container using the following command:

docker run -d -e AZP_URL=<your-azuredepops-instance> -e AZP_TOKEN=<pat> -e AZP_POOL=<azp-agentpool-name> -e AZP_AGENT_NAME=<agent-name> --name myazpagent btnguyen2k/azpagent-base:latest

Environment variables⁠

Mount volumn to persist data in work directory

docker run -d -e AZP_URL=... -e AZP_TOKEN=... -e AZP_POOL=... -e AZP_AGENT_NAME=... -e AZP_WORK=/workspace -v /home/workspace/azp:/workspace --name mycontainer myazpagent:ubuntu-18.04