Released: Friday, September 9, 2022

What's new in 2022.3

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

Octopus 2022.3

As organizations continue to modernize, it's becoming increasingly important to ensure you can safely and reliably audit your CI/CD pipelines. You need to monitor and secure your deployments, and your teams need to scale reliably with tools to collaborate as releases move from deployment to testing and production.

This release adds support for version-controlled variables for version-controlled projects for a more complete implementation of the Config as Code solution we released in March. We also have several other new features to help you build safe, reliable, and auditable “As Code” CI/CD pipelines. These include ITSM change management with our ServiceNow and Jira Service Management integrations and built-in DevOps reporting.

This release’s noteworthy updates include:

  • Config as Code - version-controlled variables for version-controlled projects
  • ITSM - change management without friction for ServiceNow
  • Jira Service Management - efficient change management approvals (early access)
  • DevOps Insights - DORA insights to quantify value and improvements (early access)
  • GitHub Actions for Octopus Deploy v2
  • Simpler cloud target discovery setup

Together, these features support collaboration, scalability, and security for your deployments.

The 2022 Q3 release is available on Octopus Cloud and ready for download by our self-hosted customers.

Release notes

Changes in Octopus 2022.3.10594

  • 7773 - Git operations are slow on instances with a large number of machines

Changes in Octopus 2022.3.10591

  • 7671 - Fix timeout when connecting projects to large Git repositories
  • 7784 - Fixed an issue where Octopus couldn't authenticate with git repositories hosted by Azure DevOps Server 2020
  • 7695 - Improved error message when git credentials are invalid or expired

Changes in Octopus 2022.3.10586

  • 7798 - Fix prompted variables inputs not showing for Runbooks in projects with Git variables
  • 7785 - Fixed long-running steps failures when using an Azure SQL database
  • 7805 - Improved the efficiency of some space-specific queries
  • 7779 - Fixed an issue where releases created by scheduled triggers were not audited
  • 7780 - Releases created by scheduled triggers are not considered for Insights Lead Time and are missing from the detail tables

Changes in Octopus 2022.3.10560

  • 7790 - Fix upgrade path from v2021.3.12912 and onwards to newer major versions

Changes in Octopus 2022.3.10559

  • 7790 - Fix upgrade path from v2021.3.12912 and onwards to newer major versions

Changes in Octopus 2022.3.10530

  • 7778 - Fixed concurrent cache access
  • 7604 - In addition to SemVer, package retention now also supports other version formats

Changes in Octopus 2022.3.10528

  • 7784 - Fixed an issue where Octopus couldn't authenticate with git repositories hosted by Azure DevOps Server 2020

Changes in Octopus 2022.3.10514

  • 7777 - Scheduled triggers save correctly again
  • 7776 - Fixed an issue with duplicate work item references being sent to Jira

Changes in Octopus 2022.3.10483

  • 7772 - Fixed a problem where the Deploy Kubernetes Containers step may incorrectly report a successful deployment even though the a ConfigMap or Secret failed to be provisioned

Changes in Octopus 2022.3.10437

  • 7769 - Fix error running Runbooks in projects with prompted library variables
  • 7765 - Start Date now shows correctly again on the Project Trigger overview and when editing

Changes in Octopus 2022.3.10405

Breaking Changes
  • 7760 - Updated ServiceNow approval caching. This results in existing Change-controlled deployments being unable to exit "Queued" state; these will need to be canceled and restarted
  • 7673 - Reduced number of requests made to external feeds when creating and viewing releases. SelectedPackagePublished in deploymentprocesses/{id}/template has been moved to Published in packages/notes
  • 7645 - Update OCL to reference shared resources via slugs instead of names. Update API responses for version-controlled documents to reference shared resources via IDs instead of names
Other Changes
  • 7763 - Fixed an issue whereby deployments which reference Jira Work Item(s) (using the Jira Integration) and contain a Manual Intervention step would fail, reporting an AutoFac circular dependency
  • 7746 - API deployments/create/untenanted/v1 fails to deploy release in a version controlled project
  • 7742 - Fix an issue where branches created via the branch selector would end up prefixed with refs/heads/
  • 7445 - Fix navigation bar overflow menu not appearing on smaller screen widths
  • 7696 - Added "machine task processing limit" to the Upgrades settings to allow processing more machines in upgrade and health check tasks at any given time
  • 7734 - Fixed upgrade error when there is a release with a large number in the version
  • 7733 - Fixed deserialization of dates
  • 7718 - Private spaces are decommissioned and will no longer be available. Existing private spaces will be deleted in the background over time
  • 7569 - Allow tasks with the same package to spread out to multiple workers
  • 7346 - Improved the accessibility of multiselect inputs
  • 7722 - Fixed an issue where reading package references from OCL could result in a “Resource not found” error
  • 7082 - Reduce Tentacle upgrade transfer size and processing time by uploading only the relevant Tentacle upgrade package based on OS/architecture
  • 6629 - Octopus Linux container now respects both API key and password
  • 7708 - DatePicker can show incorrect date when selected date differs from current DST
  • 7716 - Scheduled triggers fail to execute for Config as Code projects with outdated OCL
  • 7662 - Repairing malformed Build Information events. Azure SQL users: consider temporarily scaling your DTU count up if you have lots of rows in the Event table. You can scale back down once the upgrade is finished
  • 7704 - Fixed an issue where Deploy a Release would block OCL migrations
  • 7051 - Typing 'Releases' in Search and selecting 'Octopus Server Releases (builtin)' errors out
  • 7697 - Improved error messages when git migrations fail due to broken references
  • 7700 - Fixed an issue where a FeedId has unknown slug error would appear when reading package steps from OCL
  • 7698 - Removed stack traces from the system report to fix an issue where the instance could crash when downloading such report
  • 7656 - Cloud target discovery steps will now use the run condition of the step that triggers discovery
  • 7537 - Fixed an issue where changing the default branch in a config-as-code project could result in a cannot delete branch refs/heads/master error message
  • 7672 - Fixed an issue where the releases/create/v1 endpoint would fail to create releases for version controlled projects with package references
  • 7675 - Fix error viewing a release when a lifecycle phase has trailing whitespace
  • 7670 - Fixed warning message: Resolving ... from this named scope OctopusTaskScope is not permitted
  • 7661 - Fixes an issue where Octopus Cloud and Octopus Server on Linux could not talk to NuGet feeds hosted behind NTLM auth (including self-hosted TFS package feeds)
  • 7640 - Fix triggers not processing when a space's task queue is stopped
  • 7657 - Fixed an issue where step templates with broken references could prevent deployment processed from being read from OCL
  • 7653 - Updated Create Release/Execution commands JSON payload definitions to match its associated class properties
  • 7648 - Fixed an issue where step packages stored in OCL were incorrectly deserialised
  • 7632 - Added the ability to specify a docker network name in the docker create a network step
  • 7635 - Improve performance of deploymentprocesses/template
  • 7642 - Fix slow memory leak in Octopus Server
  • 7634 - Scheduled trigger times are correctly shown and new triggers execute as expected
  • 7602 - Runbook multi-tenancy and deployment target status resets to default when cloning a project with runbooks
  • 7615 - Fixed the Build Information event categories on audit events
  • 7603 - Fixed an issue where Run a Kubernetes Script step would fail if the cluster was not available
  • 7628 - Fix issue where not found error was returned when creating releases for Git projects with deploy release actions
  • 7626 - Creating a release in the UI is blocked if using a Docker feed that fails to search (eg. GitHub Container Registry)
  • 7545 - Fixed issue with Unicode in project names
  • 7546 - Performance telemetry is now logged at a verbose level when send telemetry server task runs
  • 7575 - Fixed an issue where deployments made via automatic lifecycle promotions would fail and remain persisted in a bad state
  • 7428 - Fix issue of YAML editor in Kubernetes step stripping characters from variable whose name contains colons
  • 7592 - Add warnings when the SQL connection max pool size is less than triple the task limit/cap
  • 7533 - Limit the amount of releases returned when checking for total number of releases in the Project Overview page
  • 7589 - Improved the handling of missing steps when using the channel version rule designer
  • 7585 - Fix NullReferenceException being thrown when creating or viewing releases with a version mask
  • 5110 - New-OctopusKubernetesTarget command will now validate that one of the following parameters -octopusAccountIdOrName and -octopusClientCertificateIdOrName has been provided
  • 7580 - New-OctopusKubernetesTarget command will now validate that only one of the following parameters have been provided -octopusAccountIdOrName and -octopusClientCertificateIdOrName
  • 7581 - New-OctopusKubernetesTarget command can now set health check container on Kubernetes target that is using certificate authentication
  • 7506 - Fixed the issue where users were unable to deploy to Tomcat via manager over HTTPS
  • 6954 - Package publish datetime in UI inconsistent between Release and Library pages
  • 7269 - Improve performance of runbook run preview page when selecting tenants
  • 7534 - File and git cache cleanup no longer runs under the task cap
  • 7491 - Improved error message when converting a project to version controlled while a missing reference exists in the deployment process

Unsure which version is a compatible upgrade? Compare releases.

Looking for older versions of Octopus? Download older versions.