Continuous Integration

Create automated, clean, and consistent application images with Turbo while keeping the build environment free from conflicting dependencies.

Existing build servers may have many varying libraries, runtimes, custom settings, and applications that are required for automated builds. These dependencies can collide and create inconsistent environments. With Turbo, all dependencies are captured into a container image, providing consistent and reproducible builds.

The recommended approach for CI builds is to use PowerShell build scripts from the powershell-builds repository.

PowerShell Build Scripts

The powershell-builds repo contains a collection of PowerShell scripts for automating the creation of Turbo images using Turbo Studio's capture workflow. Each application has its own folder with a BuildTurboImage.ps1 script that handles downloading the installer, running the capture, and building the final SVM image.

Prerequisites

On a clean packaging device:

1. Download and unzip the powershell-builds repo
2. Install Turbo Studio
3. Install the Turbo Client (required only if importing or pushing images to a Turbo Server)

Running a Build

Launch TurboImageBuilder.hta to use the graphical interface, or run a script directly from an elevated PowerShell prompt:

powershell -ExecutionPolicy Bypass -File .\<vendor_appname>\BuildTurboImage.ps1

To import the built image to the local repository after the build:

powershell -ExecutionPolicy Bypass -File .\<vendor_appname>\BuildTurboImage.ps1 -Import $true

To import and push to a Turbo Server:

powershell -ExecutionPolicy Bypass -File .\<vendor_appname>\BuildTurboImage.ps1 -Import $true -PushURL https://<server> -ApiKey <api-key>

Build Output

Completed builds are written to %USERPROFILE%\Desktop\Package\TurboCapture\:

• Capture.xappl — unmodified configuration from the capture
• FinalCapture.xappl — configuration after post-capture modifications
• build.svm — the completed Turbo image

Logs are written to %USERPROFILE%\Desktop\Package\Log\.

Script Structure

Each application folder follows the same structure:

<vendor_appname>\
  BuildTurboImage.ps1         # Main build script
  VersionCheck.ps1            # Checks if Hub version is already up to date
  SupportFiles\
    PostCaptureModifications.ps1  # XML customizations applied to the .xappl before build

The scripts rely on shared helper functions in !include\GlobalBuildScript.ps1, which provides utilities for downloading installers, starting and stopping Turbo Studio capture, building the SVM, and pushing the image.

Integrating into a CI Server

Add the following steps to your CI pipeline:

1. Check out or download the powershell-builds repo to the build agent
2. Place your Turbo Studio license at !include\License.txt
3. Run the build script for the target application
4. Optionally push the resulting image to your Turbo Server using -PushURL and -ApiKey

Example using environment variables for credentials:

powershell -ExecutionPolicy Bypass -File .\<vendor_appname>\BuildTurboImage.ps1 `
    -Import $true `
    -PushURL $env:TURBO_SERVER_URL `
    -ApiKey $env:TURBO_API_KEY

See the Command Line Interface page for more information on turbo commands.