Download the latest Octopus Deploy release

Octopus Deploy Release Notes

Find out what's new in the latest Octopus Deploy release, or compare the latest release to what you're currently running to see what's changed.

Choose two versions to see what's new:

Major features

New Features in 3.3

  • Script-steps can source the script from a package
  • Script-steps can execute on the Octopus server without requiring a Tentacle
  • Server-based steps (i.e. email, manual-intervention, and the new server-script steps) can be child steps
  • Support for zip and tar packages
  • OctoPack.js + gulp and grunt wrappers Guide for deploying Node.js
  • Azure Service Principal account type
  • Azure Resource Group Template step type
  • ASP.NET 5 (Sorry, ASP.NET Core) JSON configuration support
  • Breaking change: Sensitive Properties have changed to resolve a number of issues on deployment steps and templates, affecting octo.exe, Octopus.Client and the TeamCity plugin (see below for more details)

Read our blog post announcing 3.3

Please Note: you will need to upgrade octo.exe, Octopus.Client and the TeamCity plugin when upgrading to Octopus Deploy 3.3

Breaking Change: Sensitive Properties

As part of this release we have resolved a number of minor issues with sensitive properties on deployment steps and step templates. The issues resolved include:

  • Windows Service Custom account and password properties no longer retained when switching account types (#2264).
  • Sensitive fields in steps can now be cleared/reset (#2311)
  • Username/password fields on IIS and Windows Service features will remain visible if account-type/identity is bound to a variable (#2333)
  • Sensitive fields now use a consistent UI control across the entire portal.

Breaking Change

This introduces a breaking change to our API, and will affect those using the following endpoints:

  • /api/deploymentprocesses
  • /api/actiontemplates

It also affects octo.exe, Octopus.Client and the TeamCity plugin. If you are using any of these components please upgrade them when upgrading to Octopus Deploy 3.3.

See Sensitive Property API Changes in Release 3.3 for more details.

Upgrading

Read the upgrade guide for more details on upgrading from your current version to Octopus 3.3.

Please upgrade octo.exe, Octopus.Client and the TeamCity plugin when upgrading to Octopus Deploy 3.3.

Detailed release notes

Changes in 3.3.8

  • 2300 - Add new variable Octopus.Action.Package.InstallationDirectoryPath as replacement for Package.InstallationDirectoryPath
  • 2438 - Switching a script step from "script in package" to "inline script" should not attempt to download the package
  • 2443 - Add support for "No Managed code" for App Pool .NET CLR
  • 2446 - Allow parallel SSH tasks to take place on targets with different fingerprints.
  • 2451 - Audit event references should be mapped to to the new IDs
  • 2452 - When steps are deleted or renamed, the channel rule references to them should update
  • 2457 - Bugfix for variables grid not expanding to full width
  • 2460 - 3.3.7 Upgrade fails on script steps with sensitive variables

Changes in 3.3.6

  • 2434 - Allowing packages deployed to SSH targets to exceed 2GB in size

Changes in 3.3.5

  • 2432 - Fix to allow custom expressions in Nuget feeds for projects on import/export
  • 2439 - Authentication token no longer expires during long running Azure Resource Group deployments

Changes in 3.3.4

  • 2278 - An additional warning will be logged if a release is not automatically created due to the package version being the greatest/maximum
  • 2312 - Variables link not added to Deployment resource if variable-set is no longer available.
  • 2396 - Configured scripts in package steps now support Unicode characters.
  • 2399 - Importing scripts now succeeds even if the project has the same name as something else (such as lifecycle or project group)
  • 2429 - Tentacle Manager now supports all TLS versions
  • 2430 - Task start time displayed on hover incorrectly shows queued time rather than start time
  • 2431 - The “Run on” radio button in a script template step now retains its selection after updating to a new version of the template
  • 2437 - Fixed a bug that broke Project cloning in certain circumstances with an ArgumentNullException

Changes in 3.3.3

  • 2392 - You can now configure your Authentication Mode (Username/Password or Active Directory) when adding a node to an Octopus HA cluster using the wizard
  • 2403 - You can now choose whether to use Timestamp or Checksum for WebDeploy to Azure Web App, and the default has been changed to Timestamp when creating new Azure Web App steps
  • 2415 - When creating a deployment channels will now be taken into account when validating the deployment process
  • 2417 - When cloning a Project the Channels will now be correctly re-mapped for Project Variables and Automatic Release Creation
  • 2423 - Fixed an issue that prevented you from saving Azure Web App deployment targets with the error 'Web Space' should not be empty
  • 2426 - Prevent integer-overflow error during long-running Azure Resource Group deployments.
  • 2427 - Octo.exe Update channels information in steps that have been scoped to a channel when importing a project

Changes in 3.3.2

  • 2391 - Add missing repositories (Channels, Accounts, Retention Policies, Defects and Server Nodes) to OctopusRepository in Octopus.Client
  • 2404 - Fix Javascript error preventing uploading of custom Azure Resource Manager certificates
  • 2405 - Removed paging from channels so that more than 30 can be used at a time
  • 2407 - Allow script steps that run on the server to be run across roles as a standalone step or as the first action in a rolling deployment
  • 2410 - Octo.exe Import and export project channels when running the project import and export commands
  • 2411 - Add push command to Octo.exe and a push package build runner to the Octopus Deploy TeamCity plugin
  • 2412 - When the NuGetFeed for a Package Step is set to a channel-scoped variable, it will now be resolved correctly when creating a release in those channels
  • 2414 - Adds support for TLS protocols for Octo.exe to communicate with TLS-only installations of Octopus Server

Changes in 3.3.1

  • 2376 - Fixed scenarios that were failing when the host server is required to be FIPS 140 compliant
  • 2390 - On-screen help text added to Azure PowerShell step explaining Service Management cmdlets can't be used with Service Principal accounts and Resource Manager cmdlets can't be used with Management Certificate accounts
  • 2395 - Immediately executing code in Script Modules now have access to Octopus Variables
  • 2398 - Exporting a step template is now prevented until any changes are saved
  • 2402 - Fixed an issue that was preventing Calamari from updating on multiple SSH endpoints due to a file lock

Changes in 3.3.0

  • 641 - Email, Manual Steps and Azure Powershell steps can now be executed in a rolling step. Also added support to run a PowerShell Script on the Octopus Server.
  • 2069 - Enable Azure Active Directory auth for Azure Accounts
  • 2091 - Show warning if file is missing during config transformation
  • 2133 - Azure Resource Group deployment step type
  • 2183 - Support .zip and .tar.gz package formats
  • 2189 - Script step embedded in a NuGet package
  • 2304 - Support for ASP.NET Core

Changes in 3.3.0-beta0002

  • 2345 - Corrected instructions for pushing packages via the api to the built-in repository
  • 2354 - Improve the error message when using the JSON config feature and a folder is specified as the target file
  • 2355 - Delete parameters that have been renamed/removed from the action properties collection
  • 2356 - The selected Resource Group in the “Deploy an Azure Resource Group” step now binds correctly when editing an existing step
  • 2357 - The display of long parameter names for Azure Resource Manager templates will now wrap instead of overflowing underneath the input control
  • 2359 - The display of Web Apps in the select list has been updated to display the Region and Resource Group (where available)
  • 2363 - The http://ASP.NET|ASP.NET Core JSON AppSettings feature is now the JSON configuration variables feature
  • 2364 - JSON config feature only replaces variables it can find instead of inserting all available project variables
  • 2374 - Invoke Set-AzureRmContext when authenticating with service-principal