VM instances and images for SaaS runners on macOS
When you use SaaS runners on macOS:
- Each of your jobs runs in a newly provisioned VM, which is dedicated to the specific job.
- The VM is active only for the duration of the job and immediately deleted. This means that any changes that your job makes to the virtual machine will not be available to a subsequent job.
- The virtual machine where your job runs has
sudoaccess with no password.
GitLab SaaS provides macOS build machines on Apple servers with Intel x86-64 processors. The expectation is that virtual machines running on the Apple M1 chip will be available in the second half of 2022.
At this time there is only one available machine type offered,
|Instance type||vCPUS||Memory (GB)|
Image update policy
GitLab expects to release new images based on this cadence:
For new OS versions: When Apple releases a new macOS version to developers (like macOS
12), GitLab will plan to release an image based on the OS within the next 30 business days. The image is considered
betaand the contents of the image (including tool versions) are subject to change until the first patch release (
12.1). The long-term name will not include
macos-12-xcode-13), so customers are moved automatically out of beta over time. GitLab will try to minimize breaking changes between the first two minor versions but makes no guarantees. Tooling often gets critical bug fixes after the first public release of an OS version.
After the first patch release (
- The image moves to
maintenancemode. The tools GitLab builds into the image with Homebrew and asdf are frozen. GitLab continues making Xcode updates, security updates, and any non-breaking changes deemed necessary.
- The image for the previous OS version (
11) moves to
frozenmode. GitLab then does only unavoidable changes: security updates, runner version upgrades, and setting the production password.
- The image moves to
Both macOS and Xcode follow a yearly release cadence. As time goes on, GitLab increments their versions synchronously (meaning we build macOS 11 with Xcode 12, macOS 12 with Xcode 13, and so on).
You can execute your build on one of the following images.
You specify this image in your
Each image is running a specific version of macOS and Xcode.