Skip to content

Quickstart

This smoke test assumes the plugin is already installed. See Installation first.

1. Add the cloud

Open:

Manage Jenkins -> Clouds -> New Cloud -> Jeballto Cloud

2. Add one agent configuration

Start with:

  • one Jeballto host
  • one API token credential
  • one SSH credential
  • maxInstances = 2
  • assigned label xcode26

3. Add one label assignment

Example:

  • label: xcode26
  • image: ghcr.io/org/macos-ci:xcode-26
  • lifetime seconds: 7200
  • priority: 10

4. Run a test pipeline

pipeline {
    agent { label 'xcode26' }
    stages {
        stage('Smoke') {
            steps {
                sh 'sw_vers'
                sh 'xcodebuild -version'
            }
        }
    }
}

5. Confirm the lifecycle

You should see:

  1. Jenkins requests xcode26.
  2. The plugin picks the matching image and host.
  3. A VM is provisioned and SSH becomes ready.
  4. The Jenkins agent comes online.
  5. The build runs once.
  6. The VM is deleted after completion.