Octopus 2022 Q1 highlighting config as code with screenshot showing the Octopus UI and a config file in a text editor.

Octopus 2022 Q1: Config as Code for deployments

Rob Pearson

The Octopus 2022 Q1 release is now available.

We're happy to share that Configuration as Code (Config as Code) for deployments is generally available. You can create version-controlled projects and see your deployment process in your Git repo next to your application code and evolve them together.

We believe our no-compromise solution is one of the best "as code" implementations. Config as Code in Octopus delivers the power of Git (branches, commits and history) with the usability of Octopus UI. Config as Code is available on Octopus Cloud and ready for download by our self-hosted customers.

This release also includes other noteworthy updates:

  • Visual Studio Code extension with Octopus Configuration Language (OCL) syntax highlighting, code snippets, and navigation tree
  • Updated Terraform Provider with support for version-controlled projects
  • New integrations:
    • Buildkite plugins (early access) allow your build agents to create and deploy releases, push build information, and run runbooks as part of a pipeline
    • Opsera integration lets you connect Octopus to other DevOps tools with no-code automation
    • Octopus now supports connecting to multiple Azure DevOps organizations
    • Updated TeamCity plugin with the latest Log4j security patches
  • Automated step updates and discovery for steps built using our next-generation step package framework
  • Octopus Deploy acquired the Dist technology

Included in the Q1 release

  • Octopus Server 2022.1 (release notes)
  • Octopus Deploy for Visual Studio Code 0.0.17
  • Azure DevOps plugin 5.0.57
  • TeamCity plugin for Octopus Deploy 6.1.12
  • Tentacle 6.1.1320
  • Terraform Provider for Octopus Deploy 0.7.69

Long term support

The following table shows the Octopus Server releases with long term support.

Release Long term support
Octopus 2022.1 Yes
Octopus 2021.3 Yes
Octopus 2021.2 Expired

Config as Code demo

Config as Code in Octopus

Octopus Config as Code branch selector

When you enable Config as Code for a project, you can continue to use the Octopus UI as you always have, or you can edit the text files in your favorite editor. Work wherever you're the most productive.

Config as Code has been one of the top requests from our customers. After launching an early access preview in December 2021, your feedback has allowed us to fine-tune it further before general availability.

We designed our solution to avoid key anti-patterns, including bad configuration file formats, Git as a simple database, and disabling the UI completely if you opt-in to Config as Code support.

Customers using Config as Code

Stack Overflow and Recruit Wizard have been using Config as Code in early access, and shared feedback about how it's improved their development workflow.

It has enabled us to make Config as Code the standard. The build pipeline is in the software repo. The deployment pipeline is in the software repo. We can do one PR, and I can change the software, how it’s built, and how it’s deployed.

-- Chris Hunt, Staff Site Reliability Engineer at StackOverflow

Read more about how Stack Overflow uses Octopus Deploy and Config as Code.

Branching in Config as Code allows us to make changes to the deployment process alongside our code changes. This is an absolute game-changer, especially as we add more and more engineers to the team.

-- Ben Macpherson, Chief Technology Officer at Recruit Wizard

Read more about how Recruit Wizard uses Octopus Deploy and Config as Code.

Why use Config as Code?

Branch your code and deployments

Octopus Config as Code create new branch from branch selector

Branches are Git's superpower, and we expose that power. Using Config as Code you can:

  • Switch branches, or create new ones, in the Octopus UI or your favorite Git client
  • Commit changes to your deployment process on a branch
  • Add (optional) commit messages when you change your deployment process, so others understand why it changed
  • Create releases from your branch, and deploy to test your changes, to support many versions of your deployment process
  • Evolve your deployments safely without worrying about breaking other teams' deployments
  • Roll back to a previous version of your deployment process if things go wrong

Review, approve, and merge

Octopus Config as Code - Pull request with application changes and deployment process changes side by side

Review, approve, and merge your branches before you deploy to production. Getting more eyes across changes is always a good thing.

Pull requests, protected branches, and code-owners enable a new set of workflows to improve the quality and safety of your releases. Reduce downtime from bad deployments and improve the quality of your releases.

Audit and traceability

Octopus Config as code - GitHub deployment process file history

The commit history improves the traceability of changes to a deployment process. Know what changed, when, by who, and most importantly why.

No more searching through audit logs to find out why your configuration changed. Git history and diffs provide clear traceability and tell the complete story. Octopus even records the committer details in the Git history.

Shared Git credentials

Octopus Config as Code - Shared Git credentials

Reuse and manage your Git credentials for version-controlled projects from a single view, making it easier to update tokens and see their usage.

Scale your deployments across teams

Create releases from branches, and deploy your changes independently of other branches. This allows you to support multiple versions of your deployment process. You can evolve your deployments safely without worrying about breaking other teams' deployments. If things go wrong, you can also roll back to a previous version of your deployment process.

While this first release of Config as Code only includes the deployment process, we're working to add support for version-controlled variables and runbooks next. We'd also like to update the OCL schema to make it friendlier for editing by hand.

Read our docs to learn how to create your first version-controlled project.

Visual Studio Code plugin with OCL highlighting, code snippets, and navigation tree

The VS Code extension for Octopus includes OCL syntax highlighting and an OCL tree outline

Octopus Deploy for Visual Studio Code is a free extension that makes working with Octopus Configuration Language (OCL) files easier. Features include:

  • Syntax highlighting
  • Code snippets for steps and actions
  • An integrated tree view to navigate nodes in the file

Our VS Code extension is now ready for production after updates and bug fixes.

Install Octopus Deploy for Visual Studio Code.

Terraform Provider support for Config as Code

We introduced our Terraform Provider in early 2021 and it's been growing in popularity. Our provider has over 400,000 installs and contributions from the Octopus community are growing, with users reporting bugs through GitHub issues and submitting changes via pull requests.

In this release, we added support to configure version-controlled projects in HCL. With the support for Config as Code, we added Git persistence settings that specify the default branch, URL, credentials, and more. This allows you to use Config as Code features like branching while configuring your Octopus instance.

The following example highlights the latest updates:

terraform {
  required_providers {
    octopusdeploy = { ... }

resource "octopusdeploy_project_vcs" "test-project-123" {
  name                              = "test-project-name"
  lifecycle_id                      = octopusdeploy_lifecycle.test-lifecycle.id
  project_group_id                  = octopusdeploy_project_group.test-project-group.id
  space_id                          = var.space_id

  git_persistence_settings {
    # base_path
    # default_branch
    url = var.github_url

    credentials {
      password = var.github_pat
      username = var.github_username

resource "octopusdeploy_project" "test-project-321" {
  name                              = "test-project-name"
  lifecycle_id                      = octopusdeploy_lifecycle.test-lifecycle.id
  project_group_id                  = octopusdeploy_project_group.test-project-group.id
  space_id                          = var.space_id

resource "octopusdeploy_deployment_process" "test-deployment-process-main" {
  branch     = "main"
  project_id = octopusdeploy_project.test-project.id

  step {
    name         = "Hello Main Branch"
    target_roles = ["role 1"]

    run_script_action {
      script_body = "Hello from the main branch!"
      name        = "This is from the action."

resource "octopusdeploy_deployment_process" "test-deployment-process-main" {
  branch     = "secondary"
  project_id = octopusdeploy_project.test-project.id

  step {
    name         = "Hello Secondary Branch"
    target_roles = ["role 1"]

    run_script_action {
      script_body = "Hello from a different branch!"
      name        = "This is from the action."

Learn more about the Octopus Deploy Terraform provider.

New integrations

Buildkite plugins (early access)

 Buildkite plugin for Octopus Deploy

Octopus Deploy now integrates with Buildkite. Our new Buildkite plugins allow your build agents to create and deploy releases, push build information, and run runbooks as part of a pipeline.

The integration through our Buildkite plugins represents our initial design and release. We plan to build additional plugins and eliminate the dependency on the Octopus CLI by providing integration through Bash scripts.

Learn more about our Buildkite plugins.

No-code DevOps integrations with Opsera

Opsera and Octopus Configuration

We partnered with Opsera to provide integration with Octopus Deploy. You can integrate Octopus with the 95+ platforms that Opsera supports as part of its no-code DevOps orchestration platform.

It can be challenging to automate your CI/CD pipeline, especially when using different solutions. Opsera provides a self-service platform to help you automate your CI/CD pipeline. You do this through a visual interface to create declarative pipelines with unified insights.

After it's enabled, Opsera's integration provides access through its pipeline UI to resources defined in Octopus Deploy, such as channels, environments, lifecycles, projects, spaces, and tenants.

Read our announcement blog post to learn more about the Opsera integration with Octopus.

You can also learn more by attending the free webinar on Tuesday, April 12, 2022.

Connect Octopus to all of your Azure DevOps organizations

screenshot that shows the new UI

If your company has multiple Azure DevOps organizations, you can now connect Octopus to them all. When we built the functionality to associate build information with packages, we didn't plan for customers to access more than one Azure DevOps organization. We only added support to associate a single Azure DevOps organization.

In this release, we addressed this limitation and you have the option to configure multiple Azure DevOps organization URLs. This update means Octopus can show work items from more than one Azure DevOps organization as part of release creation or when looking at package metadata.

To configure multiple URLs in Octopus, head to Configuration ➜ Settings ➜ Azure DevOps Issue Tracker.

Learn more about using Octopus extensions.

TeamCity Octopus Deploy integration update

We updated our TeamCity plugin to use the latest version of Log4j to resolve the latest security vulnerabilities.

Automated step updates and discovery

Octopus Step Package framework updates and discovery

We've been quietly working on a next-generation framework for building new automation steps that we're calling the step package framework. We built our Amazon ECS deployment support with the new framework, and we're continuing to enhance it.

In this release, we introduced an update service for built-in steps using our new framework. This makes it easier to get updates and bug fixes without upgrading your Octopus Server or Octopus Cloud instance. Octopus can also discover and download new steps with this new service. Again, this lets you add new Octopus steps without an Octopus Server upgrade.

The screenshot above shows the upgrade process for an example "Hello world" step.

Octopus Deploy acquired Dist

Octopus acquired Dist, a fast and reliable artifact repository for containers and Java artifacts. Octopus has a built-in package repository for various package formats, but it doesn’t support container images. We're exploring how the Dist team's technology and expertise can help us add this capability for a low latency, secure, and integrated container registry.

Learn more in Paul Stovell's blog post.

Breaking changes

This release contains one breaking change:

Config as Code API URLs renamed

We made minor changes to some Config as Code API URLs and keys in the related links collection. These changes only impact version-controlled projects and should only cause issues if you're using URLs directly.

Learn more about this change in the GitHub issue.

Upgrade or get started

Octopus Cloud users are already running this release. Self-hosted Octopus customers can download the latest version from our website.

Download Octopus 2022.1

We encourage you to review the steps for upgrading Octopus Server. Please see the release notes for further information.

If you've never used Octopus before, sign up for a free trial or email our Sales team to see a demo and learn more.

What's coming in future releases?

Check out our public roadmap to stay informed and register for updates.


Octopus 2022 Q1 delivers the first milestone for Config as Code in Octopus, and a production-ready version of our Visual Studio Code plugin with OCL highlighting, code snippets, and navigation tree. This release also includes a plethora of new and updated integrations.

We look forward to seeing our customers work with version-controlled projects. We're continuing to add more functionality to our Config as Code solution.

We'd love to hear from you with any questions or comments. You can leave feedback below or join the conversation in our Octopus Community Slack.

We also invite you to watch our free webinar, Introducing Config as Code in Octopus.

Happy (version-controlled) deployments!