Upgrading from version 1.x to version 2.x

Cloud Foundry API Compatibility

The version 2.x of the plugin only supports Cloud Foundry v2. You cannot target both v1 and v2 Cloud Foundry instances.

Cloud Foundry made architectural changes between v1 and v2 that affect how developers interact with the platform. In most cases only additional configuration values are required. In other cases such as pushing apps and creating services, some configuration that existed in v1 no longer exists and new configuration has been introduced. Please review the Task Configuration section for details.

Task Configuration

It is necessary that you review all your configured tasks and update them with information required for v2. There are no sensible defaults for these fields so user intervention is required when you upgrade.

All Tasks

All tasks now require that you specify an organization and a space to which the operation will be applied.

Push Task

The runtime and framework concepts have been removed from Cloud Foundry v2. They have been replaced by the buildpack. The Push Task no longer has runtime and framework fields. They have been replaced by an optional buildpack field.

The manifest.yml format has changed between v1 and v2. Please update any manifest.yml files accordingly. The old format no longer is accepted. The Push Task has a help screen with details and provides a link to the official Cloud Foundry documentation for manifest file formats.

Service Task

In creating a new service in v1, it was necessary to supply the following fields:

name
vendor
tier
version

In v2, the required fields to create a service are:

name
label
provider
version
plan

You will need to reselect the service you want from the dropdown list.