Azure / Azure/Azure-Verified-Modules

[Module Proposal]: `Container job hosted GitHub runner with automatic updates`

Open
#1,878 16 comments 1 reaction 0 assignees View on GitHub
Class: Pattern Module :package: Language: Bicep :muscle: Needs: Module Owner :mega: Status: In Triage :mag: Type: New Module Proposal :bulb:
Dominant language
PowerShell
Stars
580
Forks
161
Avg merge
11h 3m
Merged PRs (30d)
15

Description

### Check for previous/existing GitHub issues/module proposals

- [x] I have checked for previous/existing GitHub issues/module proposals.

### Check this module doesn't already exist in the module indexes

- [x] I have checked for that this module doesn't already exist in the module indexes.

### Bicep or Terraform?

Bicep

### Module Classification?

Pattern Module

### Module Name

avm/ptn/github-runner-container

### Module Details

Hi!
Here at InterIKEA I have created a nice Bicep template for a Github self-hosted runner deployed as an Azure container job. There are many features you would expect from an enterprisy template. Possibly the nicest one is automatic daily rebuilds of the runner container image from the source dockerfile. Others include KEDA scaling, customizing the dockerfile / startup script, PEM/PAT auth, support for reusing existing Azure resources and finally a simple UI to support providing the template as a TemplateSpec.

![Image](https://github.com/user-attachments/assets/32d48dbc-e63f-43be-a9d4-f40a21faeeab)

So how does the update magic happen? The Bicep template uses deployment scripts to dynamically download ORAS and uses that tool to push the source dockerfile and startup script into the container registry. Next it schedules a container registry task to perform a build operation on the dockerfile in that registry (which is referenced using the oci:// context).

I was wondering if there is interest in adopting this template and provide it to the broader community.

Cheers, Wouter

### Do you want to be the owner of this module?

No

### Module Owner's GitHub Username (handle)

_No response_

### (Optional) Secondary Module Owner's GitHub Username (handle)

_No response_

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the proposal and its comment thread, then check the module indexes to confirm the proposed avm/ptn/github-runner-container name and scope. The issue describes a Bicep template using an Azure Container Job, deployment scripts, ORAS, a Dockerfile, a startup script, and a TemplateSpec; the work is complete only if maintainership and an accepted contribution path are established.

Written by the indexing model from the issue text.

Assessment

Tech stack
azure, docker, github
Domain
cloud, devops, infrastructure
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.