🚨 Maintainance notice 🚨

This project has been replaced by a more official implementation of cirruslabs at https://github.com/cirruslabs/gitlab-tart-executor and will not be maintained anymore.

Run GitLab Runner jobs with macOS virtualization for Apple Silicon

What is this?

A set of configuration files which allows gitlab-runner to make use of the macOS virtualization framework. Under the hood, these scripts use the tart commandline tool to provision VMs for jobs. The macOS virtualization framework allows running two macOS virtual machines in parallel.

Installation

Clone this repository onto your build machine and register a custom gitlab-runner to your instance. You need to adjust the paths in prepare_exec, run_exec and cleanup_exec which can also be found in gitlab-runner-example-config.toml.

Install dependencies: brew install gitlab-runner daemonize cirruslabs/cli/tart.

Ensure your host system has an SSH private key. If not, create one using ssh-keygen -t ed25519.

Configurations

• The image can be selected using Gitlab-CI's image: tag. Choose a different tart image, e.g. from https://github.com/orgs/cirruslabs/packages?tab=packages&q=macos. The current default is ghcr.io/cirruslabs/macos-monterey-xcode:14.

References

• Related GitLab.org issue: https://gitlab.com/gitlab-org/gitlab-runner/-/issues/29319