Compare releases
Compare releases and check for compatibility between your existing Octopus Server and new releases.
What's new
These are the most important features you'll get by upgrading from 2021.1.8018 to 2021.2.8139
Octopus 2021.2
Highlights
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.
Octopus 2021.1
Highlights
Octopus 2021.1 is part of the Octopus 2021 Q2 release and delivers a better cloud experience. With this release, you can:
- Migrate Octopus projects to Octopus Cloud with self-service export/import.
- Integrate Octopus more easily with GitHub Actions and HashiCorp's Terraform.
- Deploy your Azure web apps with our improved Azure App Service step.
- Scale Octopus Cloud as your needs grow:
- Run more concurrent automation tasks.
- Persist more build and automation artifacts with best-in-class storage.
- Configure the Tentacle agent without root or admin permissions.
Read our blog post to learn more.
Breaking changes
This release includes one breaking change.
Change to support for Windows Docker images
We have deprecated Windows Docker images for Octopus Server and Octopus CLI as customer uptake was low and Microsoft no longer supports the OS versions we were publishing (Windows 1809, 1903, and 1909).
Customers are encouraged to use the Linux Docker image instead. Existing Windows images for Octopus Server and Octopus CLI will remain available from our Docker Hub repository, but those tagged as latest
will no longer work on Windows.
Octopus CLI is available as an exe, a .NET Core global tool, or via chocolatey. Please refer to our downloads page.
We will continue to publish Windows Docker images for Tentacle. Once we've updated the images for Tentacle to Windows 2019 and Windows 20H2, we will deprecate the existing Windows 1809/1903/1909 containers.
Release notes
These are the features and fixes you'll get by upgrading from 2021.1.8018 to 2021.2.8139.
Changes in Octopus Server 2021.2.8139
- 7420 - Update project overview page to be more performant and load variables-missing endpoint asynchronously
Changes in Octopus Server 2021.2.8124
- 7304 - Fix automatic release creation (ARC) skipping channel version rule checks
Changes in Octopus Server 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 Server 2021.2.8062
- 7350 - Fixed an issue where large amounts of Build Information data could cause high CPU and network load
Changes in Octopus Server 2021.2.8043
Changes in Octopus Server 2021.2.8012
- 7310 - Increased performance on tenant variable endpoints
Changes in Octopus Server 2021.2.8011
- 7301 - Open redirect vulnerability in Octopus Server
Changes in Octopus Server 2021.2.8001
Changes in Octopus Server 2021.2.7952
Changes in Octopus Server 2021.2.7939
- 7031 - Tasks can now be filtered by date
Changes in Octopus Server 2021.2.7924
- 7130 - Fixed "Stack empty" error when deploying multiple releases in parallel
Changes in Octopus Server 2021.2.7911
- 7244 - Service Message Parsing (This time for sure)
Changes in Octopus Server 2021.2.7899
Changes in Octopus Server 2021.2.7897
Changes in Octopus Server 2021.2.7879
- 7231 - Speeding up teams API fetching
Changes in Octopus Server 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 Server 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 Server 2021.2.7857
- 7202 - Fix issue with auto-created space manager team not found when creating / retrieving space
Changes in Octopus Server 2021.2.7852
- 7203 - Fix configuration settings being cached too long
Changes in Octopus Server 2021.2.7847
- 7171 - Fix channel version rules being unexpectedly changed when renaming steps
Changes in Octopus Server 2021.2.7841
- 7185 - Let's Encrypt configuration no longer gets stuck "Waiting for other tasks to complete"
Changes in Octopus Server 2021.2.7840
- 7195 - Speeding up variables API fetching
Changes in Octopus Server 2021.2.7828
- 7172 - Hashes are no longer mistaken for multi-line service messages
Changes in Octopus Server 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 Server 2021.2.7808
- 7208 - Deploy started and succeeded events now show up under the task summary
Changes in Octopus Server 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 thedeployments
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 Server 2021.2.7727
Changes in Octopus Server 2021.2.7724
Changes in Octopus Server 2021.2.7713
- 7125 - Fix performance problems returning all channels with many version rules
Changes in Octopus Server 2021.2.7706
- 7119 - Remove long-lived transaction when using 'Deploy a Release' step
Changes in Octopus Server 2021.2.7705
Changes in Octopus Server 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 Server 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 Server 2021.2.7660
- 7077 - Indexes are dissapearing
Changes in Octopus Server 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 Server 2021.2.7580
Breaking Changes
- 7069 - The
Type
andEmailPriority
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
underSpaceId
in the subscription payload - 7011 - Fix error omitting optional parameters when creating runbook runs
Changes in Octopus Server 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 Server 2021.2.7462
- 6999 - Octopus Bundled AWS CLI tools warning message shows on existing process steps when running tools on containers
Changes in Octopus Server 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
Changes in Octopus Server 2021.1.8018
- 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