makertec/azure-pipelines-agent

Azure Pipelines Agent Docker Image

This repository contains Dockerfile definitions for https://github.com/makertec/azure-pipelines-agent.

This project allows the Azure Pipelines Agent to run on Docker or Kubernetes (with bind-mount the Docker socket).

https://img.shields.io/docker/pulls/makertec/azure-pipelines-agent.svg](https://registry.hub.docker.com/u/makertec/azure-pipelines-agent)

Supported tags

• latest

Configuration

For latest, you need to set these environment variables:

• AZP_URL - The URL of the Azure DevOps or Azure DevOps Server instance. Required.
• AZP_TOKEN - The personal access token from Azure Pipelines. Required. See Microsoft Docs for instructions on how to create the PAT.
• AZP_AGENT_NAME - Agent name (default value: the container hostname).
• AZP_POOL - The agent pool. Optional. Default value: Default
• AZP_WORK - Work directory (default value: _work).

Running

Which tag you should use

• Use latest if you want to run the latest agent

Docker

bash
docker run -e AZP_URL=<Azure DevOps instance> -e AZP_TOKEN=<PAT token> -e AZP_AGENT_NAME=mydockeragent makertec/azure-pipelines-agent:latest

Important: If you build using Docker containers, be careful with volume mounts, as they will be mounted on the Docker host, not on the agent's file system. For the agent to work as expected mount /azp/_work from the host to the agent container, adding to docker run -v /azp/_work:/azp/_work. This will keep the agent staging directory (and other work directories) persistent across agent restarts. Also, it is recommended that you mount to a directory that is relative to this directory, like the staging directory, so when it is mounted on the host, it is also available for the agent.

Use Docker within a Docker container

Important: bind-mount the Docker socket /var/run/docker.sock and Azure Pipeline Agent work directory /azp/_work. See below:

CODE_TOKEN_1`

See Microsoft Docs for instructions.

Software installed

Based on the Ubuntu LTS 22.04 image, with the following added packages:

• apt-transport-https
• apt-utils
• ca-certificates
• locales
• tzdata
• curl
• git
• iputils-ping
• jq
• lsb-release
• software-properties-common
• docker.io

Plus:

• Azure CLI
• Docker CLI
• OpenJDK LTS [8 (default JAVA_HOME), 11 and 17]
• Apache Maven 3.9.1

Extra ENV vars:

• LANG pt_BR.UTF-8
• LANGUAGE pt_BR
• LC_ALL pt_BR.UTF-8
• TZ America/Sao_Paulo

See the Dockerfile for more information.

Maintainers

• Luiz Fernando Altran

License

This software is open source, licensed under the Apache License, Version 2.0.