This repo provides instructions and configuration to setup Self Hosted Agents for Github running on an AKS cluster. It was derived from this article by John Bohannon @imjohnbo. This project utilizes terraform and helm to provide support for a repeatable infrastructure as code approach. The process can also be orchestrated through an Github workflow.
Fork this repo and pull your fork to your computer
Cd into the repo
Ensure you have the following dependencies:
- jq
- azure-cli (logged in to a subscription where you have contributor rights)
- github-cli (logged in)
- Create a github personal access token -- and export the value -- export GITHUB_TOKEN=paste_your_token_here
Run the setup.sh script
- Syntax: . ./setup.sh [-c CLUSTER_NAME] [-g RESOURCE_GROUP_NAME] [-s SUBSCRIPTION_ID] [-r REGION] (the extra dot is important)
- make setup_cmd provides an example version
This script does the following: - Create a service principal for use by terraform - Create a storage account to keep the terraform state - Create a resource group where your AKS cluster will be deployed - Save service principal and other provided variables in github screts
If running locally:
- make all_terraform
- make all_ghr
This uses the repo makefile to create your AKS cluster, create an ACR, and deploy the runner to the cluster
This repo is a work in progress, pull requests and suggestions are greatly appreciated
Thomas Gamble thgamble@microsoft.com
- dynamically set repo owner/repo name
- check for GITHUB_TOKEN before deploying
- remove helm install note
- check for all other variables in makefile (gh secret get?)
- add workflow / instructions
- Validate setup for an organization
- Multiple node pool
- Cluster autoscaling
- Virtual nodes?