Octopus Deploy plugin

The XL Release Octopus Deploy plugin allows you to create releases and trigger deployments on Octopus Deploy through the XL Release platform. The following task types are included:

  • Octopus: Create Release
  • Octopus: Deploy

In addition, the following task types were imported from the Octopus Deploy community plugin:

  • Octopus: Get Environment Id
  • Octopus: Get Project Id
  • Octopus: Get Project Package Information
  • Octopus: Get Project Version

These deprecated task types are included with the officially-supported plugin so as not to break templates and releases that used the community plugin. However, each of these task’s functionality has been included in the Octopus: Create release and Octopus: Deploy task types. New users can ignore these tasks and simply use the Create Release and Deploy task types when integrating Octopus Deploy into releases and templates.

Features

  • Create a release
  • Trigger a deployment

Requirements

The Octopus Deploy plugin requires the following:

  • XL Release 7.5 or higher

Installation

  1. Copy the latest JAR file from the XebiaLabs Distribution Site into the XL_RELEASE_SERVER/plugins/xlr-official directory.
  2. Restart the XL Release server.

Create a release

You can use the Octopus: Create Release task to create an Octopus Deploy release by providing the project name and Octopus channel to use for the release. You can provide a version name to use for the release, or if the field is left blank, the plugin will automatically increment from the most recent previous release version. You can also provide specific package version information in JSON format, or leave the field blank to allow the plugin to use the most recent package versions.

Create Release

Trigger a deployment

You can use the Octopus: Deploy task to trigger an Octopus deployment by providing the name of the project and release to deploy, and the environment in which to execute the deployment.

Deploy

Deprecated tasks

The following task types are now integrated into the Octopus: Create Release and Octopus: Deploy tasks, but they still function to support legacy users of the community plugin who may have these tasks integrated with templates and releases. XebiaLabs recommends replacing these deprecated task types with the ones available in the officially-supported Octopus Deploy plugin.

Get environment ID

Although this task is deprecated, you can still get the technical environment ID of an Octopus Deploy project by providing its human-readable name.

Get environment ID

Get project ID

Although this task is deprecated, you can still get the technical project ID of an Octopus Deploy project by providing its human-readable name.

Get project ID

Get project package information

Although this task is deprecated, you can still get package version information for an Octopus Deploy project by providing the technical project ID. The needed ID can be found using the Get project ID task.

Get project package information

Get project version

Although this task is deprecated, you can still get the previous version of an Octopus Deploy project by providing the technical project ID. The needed ID can be found using Get project ID task.

Get project version

Release notes

XL Release Octopus Deploy 9.0.0

  • Added compatibility with XL Release 9.0.0

XL Release Octopus Deploy 8.6.0

  • XLINT-480 - Fixed 404 error message when a project has a space in its name

XL Release Octopus Deploy 8.5.0

  • Added compatibility with XL Release 8.5.0