Skip to content

Getting Started

What this plugin does

The plugin adds a Jenkins Cloud provider that provisions one-shot macOS agents from Jeballto. Jenkins requests a label, the plugin chooses an OCI image and host, then deletes the VM after the build.

Core model

  • Label assignments map Jenkins labels to OCI images.
  • Agent configurations represent Macs running the Jeballto Agent.
  • A host only serves labels assigned to that host.
  • Multiple hosts can serve the same label for failover.

Example first label:

xcode26 -> ghcr.io/org/macos-ci:xcode-26

Prerequisites

  • Jenkins controller compatible with Java 21
  • Apple Silicon Mac with the Jeballto Agent
  • macOS 26.0+ on the Jeballto host
  • OCI image with Xcode 26 and a Java runtime compatible with Jenkins remoting
  • Jenkins credentials for Jeballto API token and guest SSH
  1. Install the released .hpi.
  2. Add one Jeballto Cloud.
  3. Add one agent configuration.
  4. Add one label assignment.
  5. Run one pipeline against xcode26.

Add more hosts or priority rules only after this path works.