Buildkite agents on Microsoft Azure

The Buildkite agent can be run on Microsoft Azure by installing the agent on your self-managed virtual machines, or by running agent jobs within a Kubernetes cluster using Azure Kubernetes Service (AKS). This page covers common installation and setup recommendations for different scenarios of using the Buildkite agent on Azure.

Using the Buildkite Agent Stack for Kubernetes on Azure

The Buildkite agent's jobs can be run within a Kubernetes cluster on Azure using Azure Kubernetes Service (AKS).

To start, you will need your own Kubernetes cluster running on AKS. Learn more in the AKS documentation.

Once your Kubernetes cluster is running on AKS, you can then set up the Buildkite Agent Stack for Kubernetes to run in this cluster. Learn more about how to do this from its installation documentation.

Installing the agent on your own Azure instances

To run the Buildkite agent on your own Azure virtual machine, use whichever installer matches your instance operating system.

For example, to install on an Ubuntu-based virtual machine:

  1. Launch a virtual machine using the latest Ubuntu LTS image (create via the portal or az vm create).
  2. Connect using SSH (using the portal or az ssh vm).
  3. Follow the Buildkite agent installation instructions for Ubuntu. For other Linux distributions, see the Buildkite agent installation instructions for:

Auto-scaling Buildkite agents on Azure

If you're interested in auto-scaling your Buildkite agents on Azure, contact support@buildkite.com.