Parallels DevOps Jenkins Plugin

This plugin integrates Jenkins with Parallels DevOps Service, allowing Jenkins to dynamically provision, manage, and destroy macOS, Windows, or Linux virtual machines as temporary build agents on demand.

Features

• Dynamic Node Provisioning: Automatically requests cloned VMs from the prl-devops-service when the Jenkins queue is full.
• Orchestrator Mode Support: Integrates with the Parallels Catalog service to cache golden images and balance resources across a farm of Parallels DevOps VM hosts.
• Auto Cleanup: Automatically destroys the VMs after each build completes.

Usage

Cloud Configuration

1. Navigate to Manage Jenkins → Clouds → New Cloud and select Parallels DevOps Cloud.
2. Enter your Service URL and API Credentials (Secret text bearer token, or Username+Password).
3. Choose the Connection Mode: HOST for a single Parallels Desktop host, or ORCHESTRATOR for a federated multi-host setup.
4. Add one or more VM Templates, each with a label, SSH credentials, and a provisioning config:
   • Clone existing VM — clone a named VM registered in the host.
   • Create from catalog — pull a golden image from the Parallels DevOps catalog.

Pipeline Usage

Jobs run directly on the provisioned VM agent — use standard sh or bat steps:

node('macos-sonoma') {
    sh 'sw_vers'
    sh 'xcodebuild -version'
}

Contributing

See CONTRIBUTING.md for build instructions, Makefile targets, and contribution guidelines.