The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Octopus Deploy

View this plugin on the Plugins site

octopusDeployRelease: Octopus Deploy: Deploy Release

  • serverId : String
    The identifier of the Octopus Server instance which you want to use for deploying this release.
    Server Id is set in the global OctopusDeploy Plugin configuration.
  • toolId : String
    The Octopus Deploy Command Line executable which you want to use for creating this release.
    Octopus Deploy Command Line executable is set in the Octopus CLI configuration on the Global Tool Configuration page.
  • spaceId : String
    If left empty the Default space for the Octopus Server instance will be used.
    Otherwise, specify a space by name. The space specified must exist in the Octopus Server instance.
  • project : String
    The project name in OctopusDeploy.
    This field is case-sensitive.
  • releaseVersion : String
    The version of the release to move.
    This field is case-sensitive.
  • environment : String (optional)
    The environment to deploy to.
    This field is case-sensitive.
  • additionalArgs : String (optional)
    Additional arguments to be passed to the Octo executable.
  • cancelOnTimeout : boolean (optional)
    If checked then the deployment will be explicitly canceled if the time to wait has expired and the task has not completed.
  • deploymentTimeout : String (optional)
    The amount of time, specified in timespan format, to wait for the deployment to complete. Default is 00:10:00 if left blank. The deployment task itself does not timeout, this timeout is purely how long the client will keep polling to see if it has completed.
  • tenant : String (optional)
    The tenant to deploy to.
    This field is case-sensitive.
  • tenantTag : String (optional)
  • variables : String (optional)
    List of variable to pass to the Deployment process
    Use Java properties notation, e.g. propertyName=propertyValue each on a new line For pipeline syntax separate each entry with a new-line character \n
  • verboseLogging : boolean (optional)
  • waitForDeployment : boolean (optional)
    If selected, this build will wait until the deployment is complete.
    When this is selected, the deployment state will fail the build if the state ends as "Failed"

octopusPack: Octopus Deploy: Package application

  • toolId : String
    The Octopus Deploy Command Line executable
  • packageId : String
    The ID of the package; e.g. MyCompany.MyApp
  • packageFormat : String
    ZIP is the recommended format.
  • sourcePath : String
    The root folder containing files and folders to pack. Defaults to the working directory.
  • additionalArgs : String (optional)
    Additional arguments to be passed to the Octo executable.
  • includePaths : String (optional)
    Newline-separated files to include in the package. Defaults to **
  • outputPath : String (optional)
    The folder into which the generated package file will be written. Defaults to the working directory.
  • overwriteExisting : boolean (optional)
    Overwrite any existing package
  • packageVersion : String (optional)
    The version number of the package. Defaults to a timestamp-based version.
  • verboseLogging : boolean (optional)
    Enable debug logging

octopusPushBuildInformation: Octopus Deploy: Push build information

  • serverId : String
    The identifier of the Octopus Server instance which you want to use for deploying this release.
    Server Id is set in the global OctopusDeploy Plugin configuration.
  • spaceId : String
    If left empty the Default space for the Octopus Server instance will be used.
    Otherwise, specify a space by name. The space specified must exist in the Octopus Server instance.
  • toolId : String
    The Octopus Deploy Command Line executable
  • packageId : String
    Newline-separated package IDs; e.g.
    MyCompany.MyApp
    MyCompany.MyApp2
  • packageVersion : String
    The version number of the package. Defaults to a timestamp-based version.
  • commentParser : String
    Octopus can associate the work items or issues addressed by the changes in the package to the package. Select the issue tracking system that you use, or leave this option blank if you do not use a supported issue tracker.
  • overwriteMode
    Normally, if the same build information already exists on the server, the server will reject the build information push. This practice ensures build information isn't accidentally overwritten or ignored. Enable this setting to override allow build information to be overwritten.
    • Values: FailIfExists, OverwriteExisting, IgnoreIfExists
  • additionalArgs : String (optional)
    Additional arguments to be passed to the Octo executable.
  • gitBranch : String (optional)
  • gitCommit : String (optional)
  • gitUrl : String (optional)
  • verboseLogging : boolean (optional)

octopusPushPackage: Octopus Deploy: Push packages

  • serverId : String
    The identifier of the Octopus Server instance which you want to use for deploying this release.
    Server Id is set in the global OctopusDeploy Plugin configuration.
  • toolId : String
    The Octopus Deploy Command Line executable
  • packagePaths : String
    Newline-separated paths of package files that will be pushed. Ant-style wildcards like dir/**/*.zip are supported.
  • overwriteMode
    Normally, if the same package already exists on the server, the server will reject the package push. This practice ensures a package isn't accidentally overwritten or ignored. Use this setting to override this behavior.
    • Values: FailIfExists, OverwriteExisting, IgnoreIfExists
  • additionalArgs : String (optional)
    Additional arguments to be passed to the Octo executable.
  • spaceId : String (optional)
    If left empty the Default space for the Octopus Server instance will be used.
    Otherwise, specify a space by name. The space specified must exist in the Octopus Server instance.
  • verboseLogging : boolean (optional)
    Enable debug logging

octopusCreateRelease: Octopus Deploy: Create Release

  • serverId : String
    The identifier of the Octopus Server instance which you want to use for creating this release.
    Server Id is set in the global OctopusDeploy Plugin configuration.
  • toolId : String
    The Octopus Deploy Command Line executable which you want to use for creating this release.
    Octopus Deploy Command Line executable is set in the Octopus CLI configuration on the Global Tool Configuration page.
  • project : String
    The name of the project as defined in OctopusDeploy.
    This field is case sensitive.
  • releaseVersion : String
    The version of the release to create.
  • spaceId : String (optional)
    If left empty the Default space for the Octopus Server instance will be used.
    Otherwise, specify a space by name. The space specified must exist in the Octopus Server instance.
  • additionalArgs : String (optional)
    Additional arguments to be passed to the Octo executable.
  • cancelOnTimeout : boolean (optional)
    If checked then the deployment will be explicitly canceled if the time to wait has expired and the task has not completed.
  • channel : String (optional)
    If left empty the Default channel for the project will be used.
    Otherwise, specify a channel by name. The channel specified must exist for the current project.
  • defaultPackageVersion : String (optional)
    The default version to use for all required packages that are not specified in Package Configurations. No default packages are used if a default version is not specified
  • deployThisRelease : boolean (optional)
    Select this when this release should be deployed immediately after it is created.
  • deploymentTimeout : String (optional)
    The amount of time, specified in timespan format, to wait for the deployment to complete. Default is 00:10:00 if left blank. The deployment task itself does not timeout, this timeout is purely how long the client will keep polling to see if it has completed.
  • environment : String (optional)
    The environment to deploy this release into.
  • gitCommit : String (optional)
    Git commit to use when creating the release for a version controlled Octopus Project.
    Use in conjunction with the GitRef parameter to select any previous commit.
  • gitRef : String (optional)
    Git reference to use when creating the release for a version controlled Octopus Project.
  • jenkinsUrlLinkback : boolean (optional)
    Adds a linkback to the Jenkins build that created the release in the Octopus Deploy release notes
  • packageConfigs (optional)
      Array / List of Nested Object
    • packageName : String
      The step-name that requires a version for a nuget package.
      This field is case-sensitive.
    • packageReferenceName : String
      The package reference name within the step. This value is required only if you are using the package referencing feature.
      This field is case-sensitive.
    • packageVersion : String
      The package's version for this release.
      This field is case-sensitive.
  • releaseNotes : boolean (optional)
    Select this option when you want to include release notes in this release.
  • releaseNotesFile : String (optional)
    Path to file, relative from workspace root, to read for release notes.
  • releaseNotesSource : String (optional)
  • tenant : String (optional)
    The tenant to deploy to.
    This field is case-sensitive.
  • tenantTag : String (optional)
  • variables : String (optional)
    List of variable to pass to the Deployment process
    Use Java properties notation, e.g. propertyName=propertyValue each on a new line. For pipeline syntax separate each entry with a new-line character \n
  • verboseLogging : boolean (optional)
  • waitForDeployment : boolean (optional)
    If selected, this build will wait until the deployment is complete.
    When this is selected, the deployment state will fail the build if the state ends as "Failed"

Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.