0.40.0 Migration Guide

[sghill]

This migration guide accompanies version 0.40.0.

Prerequisites

Please upgrade to 0.39.0 first. See #139 for the 0.39.0 Migration Guide.

Breaking Changes

The server task has been rewritten as a subclass of JavaExec. Previously the server task was run in the current process, which caused bugs like #151.

Here is an example of configuring a system property for the server task and allocating additional memory (as in #134):

tasks.named('server').configure {
    execSpec {
        systemProperty 'some.property', 'true'
        maxHeapSize = '2g'
    }
}

See 8db6dfd.

Notable Differences

These changes are not expected to break users, but potentially could.

Removed mavenLocal()

The plugin no longer defines mavenLocal() in the target project. Users who relied on this behavior will need to add this to their build file:

repositories {
    mavenLocal()
}

See #161.

Removed org.jenkins-ci:version-number as a dependency

This plugin no longer relies on org.jenkins-ci:version-number:1.1. Users who relied on the hudson.util.VersionNumber class in their build files will need to declare a buildscript dependency:

buildscript {
    dependencies {
        classpath 'org.jenkins-ci:version-number:1.1'
    }
}

See 82355a5.

New Tasks

Some of the server task's functionality was broken out into other tasks that can be individually cached and skipped. New tasks could cause issues if other plugins or build files define tasks with the same names.

• checkOverlappingSources
• generateJenkinsServerHpl
• generateTestHpl
• installJenkinsServerPlugins

Deprecated Task Classes

Old task classes were left in place, but deprecated for removal in 1.0.0:

• org.jenkinsci.gradle.plugins.jpi.GenerateTestHpl
• org.jenkinsci.gradle.plugins.jpi.ServerTask