Released: Monday, September 13, 2021

What's new in 2021.2

These are the most important features you'll get by upgrading.

Octopus 2021.2


Built-in support for Google Cloud makes it easier to manage deployments and runbook automation on Google infrastructure — including containerized applications with Kubernetes.

Other features allow you to:

  • Integrate Octopus Deploy with business workflows using our no-code Workato connector
  • Authenticate to Active Directory via LDAP when you're self-hosting Octopus on Linux
  • Create more dynamic run conditions with new variable substitution (Octostache) filters

Breaking changes

This release includes one breaking change.

Steps that use bundled tools require the OctopusUseBundledTooling property

The new upgrade script sets the OctopusUseBundledTooling property to False for steps that use an execution container. Otherwise, the script sets the property to True or respects the legacy variables. This change only impacts users with custom Windows execution containers who rely on Octopus to inject the Azure or AWS tooling. Read about the workaround for that use case in the GitHub issue.

Release notes

Changes in Octopus 2021.2.8200

  • 7475 - Project data is refreshed only when deployment process is saved successfully

Changes in Octopus 2021.2.8189

  • 7071 - Release versioning will only be updated when the step associated is updated, and better validation to prevent versioning package step changes to the referenced package
  • 7448 - Sync the deployment settings in portal once deployment process is saved successfully

Changes in Octopus 2021.2.8169

  • 7281 - Active Directory authentication will now correctly login users when forms authentication and Sign in with a domain options are used

Changes in Octopus 2021.2.8139

  • 7420 - Update project overview page to be more performant and load variables-missing endpoint asynchronously

Changes in Octopus 2021.2.8124

  • 7304 - Fix automatic release creation (ARC) skipping channel version rule checks

Changes in Octopus 2021.2.8084

  • 7371 - Fixed an issue where Structured Configuration Variables were not correctly applying to XML files
  • 6794 - Fixed an issue where Structured Configuration Variables were failing to correctly process XML files without the *.xml file extension (eg *.config)
  • 7177 - Fixed an issue where Structured Configuration Variables were failing to correctly process .properties files, and instead treating them as .yaml files

Changes in Octopus 2021.2.8062

  • 7350 - Fixed an issue where large amounts of Build Information data could cause high CPU and network load

Changes in Octopus 2021.2.8043

  • 7317 - Runbook environment selection does not include project default lifecycle
  • 7295 - Fixed a very specific scenario where lines were not being written to task logs
  • 7321 - /api/spaces used to support ids query params

Changes in Octopus 2021.2.8012

  • 7310 - Increased performance on tenant variable endpoints

Changes in Octopus 2021.2.8011

  • 7301 - Open redirect vulnerability in Octopus Server

Changes in Octopus 2021.2.8001

  • 7246 - Speed up cloning a step, filtering tenants and testing permissions by retrieving project summaries instead of full details
  • 7297 - SQL Aliases can be used again for server connection strings

Changes in Octopus 2021.2.7952

  • 7277 - Lifecycles no longer clear on UI when enabling ARC
  • 7270 - Lock trace logs are once again directed to the system log rather than the task log
  • 7143 - LdapAuthenticationProvider now handles escaped special characters such as '#' in group names

Changes in Octopus 2021.2.7939

  • 7031 - Tasks can now be filtered by date

Changes in Octopus 2021.2.7924

  • 7130 - Fixed "Stack empty" error when deploying multiple releases in parallel

Changes in Octopus 2021.2.7899

  • 7236 - Show loading message instead of Missing Resource when loading teams in a manual intervention step
  • 7237 - Speeding up progression endpoint

Changes in Octopus 2021.2.7897

  • 7204 - Speeding up project fetching when requesting an individual project, or taking a set number
  • 7235 - Fixing timeout from manual interventions after 30 minutes on Azure
  • 6915 - Events with long messages can now be exported with migrator

Changes in Octopus 2021.2.7879

  • 7231 - Speeding up teams API fetching

Changes in Octopus 2021.2.7870

  • 7224 - Updating a step template usage which is used in a channel's versioning rules will no longer result in an error

Changes in Octopus 2021.2.7865

  • 7223 - Azure Devops Fatal Error when running task: OctopusCreateRelease@4 with a commit message referencing a Jira Work Item that doesn't exist

Changes in Octopus 2021.2.7857

  • 7202 - Fix issue with auto-created space manager team not found when creating / retrieving space

Changes in Octopus 2021.2.7852

  • 7203 - Fix configuration settings being cached too long

Changes in Octopus 2021.2.7847

  • 7171 - Fix channel version rules being unexpectedly changed when renaming steps

Changes in Octopus 2021.2.7841

  • 7185 - Let's Encrypt configuration no longer gets stuck "Waiting for other tasks to complete"

Changes in Octopus 2021.2.7840

  • 7195 - Speeding up variables API fetching

Changes in Octopus 2021.2.7828

  • 7172 - Hashes are no longer mistaken for multi-line service messages

Changes in Octopus 2021.2.7821

  • 7205 - Fixed Migrator remapping issues: ActionTemplate.LogoAttachmentKey will be removed if the reference does not exist, Proxy import is fixed, Release.LifecycleId is now correctly mapped

Changes in Octopus 2021.2.7808

  • 7208 - Deploy started and succeeded events now show up under the task summary

Changes in Octopus 2021.2.7805

  • 6837 - Users in a Team with User Roles scoped to Environments may not be able to add values to a project variable unless the top value in the list is editable
  • 7016 - Fixed too many parameters error when using the deployments api
  • 7075 - TagSetEdit and TagSetDelete permissions can now be added to existing custom User Roles
  • 7078 - Fixes rolling deployments such that when deploying to a target fails, the deployment will not start deploying to other targets
  • 7042 - Fixed an issue where Runbooks were failing to evaluate tenant variables
  • 7115 - Mutli-line service message are now parsed correctly
  • 7085 - Disabled targets are now shown in the Target Status card on the infrastructure overview page
  • 7138 - Fixed an issue in migrator that would cause an error to the thrown when Tenant data was included in an export
  • 7118 - Space at end of a Tenant Tag causes "Unable to find matching tag from canonical tag name" Error

Changes in Octopus 2021.2.7727

  • 7129 - Fixes access to path denied error on server start after 2021.2 upgrade
  • 7127 - Update brand elements in Octopus Manager

Changes in Octopus 2021.2.7724

  • 7126 - Long package names are now correctly handled by build information
  • 7187 - Auto deploy includes the correct machines in the deployment

Changes in Octopus 2021.2.7713

  • 7125 - Fix performance problems returning all channels with many version rules

Changes in Octopus 2021.2.7706

  • 7119 - Remove long-lived transaction when using 'Deploy a Release' step

Changes in Octopus 2021.2.7705

  • 7110 - Fix channel version rules being incorrectly deleted where channels linked to steps were deleted
  • 7115 - Mutli-line service message are now parsed correctly

Changes in Octopus 2021.2.7697

  • 6965 - Improved detection of a NuGet V3 feed and handling of NuGet V3 feeds that don't fully implement the NuGet V3 specification

Changes in Octopus 2021.2.7693

  • 7004 - Automatic Release Creation shows Package Step: Not Found
  • 7005 - Release Versioning package step not displayed
  • 7088 - Fixes an issue with the Azure App Service step where package aquisition would fail when configured with a container
  • 6743 - Project variables can be overridden and deployed without warning that variables have been changed

Changes in Octopus 2021.2.7650

  • 7009 - Fixed auditing diffs for document modified entries
  • 7017 - Fixed auditing diffs for document modified entries
  • 7066 - Auditing screen filters/sidebar show missing resources for deployment settings
  • 7057 - Fixed Permissions Check to allow Audit Events to be written down during background tasks
  • 7060 - Fixed a "resource not found" issue when viewing old deployments
  • 6988 - Ensure certificate subject and issuer are stored in the RFC2253 standard

Changes in Octopus 2021.2.7580

Breaking Changes
  • 7069 - The Type and EmailPriority properties in the subscriptions payload are now strings instead of integers
Other Changes
  • 7034 - Fixed an issue where task log filenames were being created in Pascal case rather than all lower case
  • 7046 - More audit event links point to /not-found
  • 7040 - Removed some links in the audit log that pointed to /not-found
  • 7014 - Main menu UI bug with safari MacOS
  • 7013 - Remove Value under SpaceId in the subscription payload
  • 7011 - Fix error omitting optional parameters when creating runbook runs

Changes in Octopus 2021.2.7529

  • 6183 - Add full screen expander and variable insert button to YAML editor on Helm step
  • 56 - Fixed issue retrieving Jira issues that have comments
  • 7012 - Remove UI option to select execution container for Manual Intervention, Health Check and Deploy Release steps
  • 7002 - Bugfix - LifeCycle View permissions are once again no longer required for release creation and viewing
  • 6983 - Improved speed and reduced disk usage of upgrade script (Script0266)

Changes in Octopus 2021.2.7462

  • 6999 - Octopus Bundled AWS CLI tools warning message shows on existing process steps when running tools on containers

Changes in Octopus 2021.2.7428

Breaking Changes
  • 6968 - Lifecycle is now recorded directly on the release rather than resolved on demand via the channel
Other Changes
  • 6992 - Fix failing deployments for projects with manual intervention and tenant tag scoped variables
  • 6987 - Enable anonymous bind support in LDAP authentication provider
  • 6991 - Fixes the issue that causes K8s deployments using GCP account don't deploy to custom namespace
  • 6958 - Fixes custom proxy support for Azure WebApp Target Health Check
  • 6990 - Azure AppService step now downloads publishing profile for the deployment target site and uses publishUrl property to perform the deployment
  • 6989 - Default to Azure Global Cloud when Configure Isolated Azure Environment connection is selected, but no specific environment has been selected
  • 6975 - Fixes ordering of Kubernetes environment variables to allow substitution of Downstream APIs
  • 6985 - Fixed EventRelatedDocument SQL parameter limit bug
  • 6974 - Server Manager fails to start in 2021.2 and newer.
  • 6901 - Show certificate archive/unarchive events in audit logs
  • 6955 - Fixed an issue with additional "was modified" audit messages appearing for deployments
  • 6950 - Dashboard once again displays most recent releases per environment when there are multiple channels
  • 6986 - Added support for LDAP as an authentication provider
  • 6916 - Modified Swagger generation to use the ServerUri if configured
  • 6881 - Kubernetes steps that support creation of Ingress resources will now output with apiVersion v1
  • 6905 - Running Structured Configuration Variables over YAML files that contain comments will now preserve the structure of the file correctly
  • 6602 - Support for Kerberos authentication in load-balanced HA scenarios
  • 6900 - Steps run on Octopus Server using execution containers will now authenticate to Docker registries correctly
  • 6886 - Modifying a 'Copy of' template fails on save
  • 6833 - Invalid day names can be used in cron expressions resulting in the "Triggers" overview becoming inaccessible
  • 6889 - "How to Push Packages" Tooltip is not Space aware
  • 6895 - Usage tab on step templates works again
  • 6646 - Fixes issues with using bundled Azure tools on Powershell Core and changes the default to be "Use tools pre-installed on the worker"
  • 6891 - Azure App Service step errors if no connection strings supplied and app settings are supplied
  • 6876 - Tenant Preview under a step displays tenant preview incorrectly
  • 6874 - Azure passwords with leading dash or other special characters now work as expected
  • 6841 - Warning about missing script syntax has been removed for Azure script steps
  • 6820 - Helm timeout values fails when entering a time unit value for Helm V3
  • 6870 - Missing validation of first template variable
  • 6814 - Health checks now no longer run more often than they should in a HA setup
  • 6785 - Validation error messages for Tenant Variables don't update or clear when expected
  • 6959 - Automatic release creation no longer occurs synchronously on package upload
  • 6850 - Add the ability to deploy Job Resource in Deploy Kubernetes containers step
  • 5914 - Fixed server audit URI
  • 6852 - The subscription "Name" field now displays appropriate help text
  • 6765 - Fixed route to point to either runbook steps or deployment process depending on which is being manually updated
  • 6789 - Pagination is applied as if all runbooks were visible instead of only filtered runbooks
  • 6823 - Added a space between the manual intervention buttons
  • 6821 - Url used for proxy testing is now using a proper domain name
  • 6815 - Tentacle communication logs are no longer duplicated in the Octopus Server logs
  • 6809 - Deployment creation requests are now throttled to improve reliability when deploying to many tenants
  • 6802 - The Octopus Server version number is now displayed as major.minor (Build buildcounter)
  • 6788 - Third party docker images can be now be used as container images
  • 6652 - Custom script steps do not evaluate release notes or build information when using dynamic packages

Unsure which version is a compatible upgrade? Compare releases.

Looking for older versions of Octopus? Download older versions.