Octopus Deploy Documentation

Environments

Last updated

Environments organize your deployment targets (whether on-premises servers or cloud services) into groups that represent the different stages of your deployment pipeline, for instance, Development, Test, and Production. You can manage your environments by navigating to Infrastructure ➜ Environments in the Octopus Web Portal.

Organizing your deployment targets into environments lets you define your deployment processes (no matter how many deployment targets or steps are involved) and have Octopus deploy the right versions of your software to the right environments at the right time. The order your projects progress through your environments is controlled by the lifecycle.

Add New Environments

  1. Navigate to Infrastructure ➜ Environments and click ADD ENVIRONMENT.
  2. Give your new environment a meaningful name and click SAVE.
  3. Add a description for the environment.
  4. Select the checkbox in the Default Guided Failure Mode section if you want Octopus Deploy to prompt users for intervention if a deployment to this environment fails. Learn more about guided failure mode.
  5. Select the checkbox in the Dynamic Infrastructure section if deployments to this environment are allowed to create infrastructure such as targets and accounts. Learn more about Dynamic Infrastructure.
  6. Click SAVE.

You can add as many environments as you need.

Editing Your Environments

To edit individual environments, click the ... overflow menu for that environment. From here, it is possible to edit the environment, description, change the guided failure mode, enable or disable dynamic infrastructure, or delete the environment.

Environment Permissions

You can control who has access to view, edit, and deploy to environments by assigning users to Teams and assigning roles to those teams. For more information, see the section onΒ managing users and teams.

Managing Your Environments

If you're working with a large number of environments and deployment targets, the Environments page makes it easy to sort, filter, and view your environments and the deployment targets that belong to each environment.

Sorting Your Environments

Click the ... overflow menu on the environments sections to reveal the reorder menu and access a drag and drop pane to sort your environments.

The order that environments are shown in the environments tab also affects:

  • The order that they are shown in the Dashboard.
  • The order that they are listed when choosing which environment to deploy a release to.

It's a good idea to put your least production-like environments first, and the most production-like environments last.

Using Advanced Filters

You can use advanced filters to search your environments by clicking on SHOW ADVANCED FILTERS from the environment page.

This will let you search by:

  • Name
  • Deployment Target
  • Environment
  • Target Roles
  • Health Status
  • Communication Style

Next

Learn how to add and manage your Deployment Targets.

Welcome! We use cookies and data about how you use our website allow us to improve the website and your experience, and resolve technical errors. Our website uses cookies and shares some of your data with third party analytics companies for these purposes.

If you decline, we will respect your privacy. A single cookie will be used in your browser to remember your preference.