fox-docker-agent

Azure DevOps Self-hosted Docker Build Agent + Python Template with uv

This repository provides a ready-to-use setup for a self-hosted Azure DevOps agent in Docker, optimized for Python projects using uv for dependency management and builds. The agent supports multiple Python versions using pyenv, and can be easily deployed with Docker Compose.

🚀 Key Features

• Self-hosted Azure DevOps build agent using Docker
• Pre-installed Python versions (3.10, 3.11, 3.12)
• Fast dependency resolution and build with uv
• Matrix build strategy to test across multiple Python versions
• Minimal and production-ready Azure Pipelines configuration

📁 Repository Structure

.
├── agent/                  # Self-hosted agent Docker setup
│   ├── docker-compose.yml  # Brings up the agent
│   ├── Dockerfile          # Builds the agent image
│   ├── start.sh            # Starts and registers the agent
│   └── secrets/PAT         # Personal Access Token (not checked in)
├── azure-pipelines.yml     # Azure Pipeline using uv to test/build Python project
├── pyproject.toml          # Python project metadata (setuptools/uv compatible)
├── src/                    # Project source code (follows `src/` layout)
│   └── fox_pypi/
├── tests/                  # Pytest-based test suite
└── uv.lock                 # uv-generated dependency lock file

🚀 Getting Started

1. Clone the repository

git clone https://github.com/fox-techniques/fox-docker-agent.git
cd fox-docker-agent

2. Set up the Agent

Edit .env file (create it if missing):

AZP_URL=https://dev.azure.com/YOUR_ORG
AZP_TOKEN=your_pat_token
AZP_POOL=your_azure_devops_pool

Then run the agent:

cd agent
docker compose up -d

💡 Ensure your PAT has agent pool and read/write access.

🧪 Azure Pipeline: Test & Build

This pipeline (azure-pipelines.yml) runs for each commit on main. It:

• Spins up a matrix of Python versions: 3.10, 3.11, 3.12
• Creates a virtual environment using uv
• Installs the project in editable mode with dev dependencies
• Runs pytest
• Builds the package