Skip to content

Add instructions for switching off cloud target discovery #2936

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
wlthomson merged 2 commits into from
Nov 26, 2025
Merged

Add instructions for switching off cloud target discovery #2936

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8b31d1e
Add instructions for disabling cloud target discovery
wlthomson Nov 24, 2025
e404da3
Use inclusive language
wlthomson Nov 26, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 25 additions & 1 deletion src/pages/docs/infrastructure/deployment-targets/cloud-target-discovery/index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,16 @@ From **Octopus 2022.3**, Azure steps that support target discovery will allow yo

Once the variables for target discovery have been configured the **Azure** tile will say **Cloud target discovery enabled** and clicking the tile will redirect you to the Variables screen for the project where the target discovery variables can be edited if required.

#### Switching off Azure cloud target discovery

To switch off cloud target discovery for Azure:

1. Navigate to your project's **Variables** screen.
2. Find and delete the `Octopus.Azure.Account` variable.
3. Click **SAVE**.

Once the variable is removed, cloud target discovery will be switched off for Azure resources in this project. The **Azure** tile in the **Cloud Connections** section of your Azure deployment steps will show **Configure** again, indicating that cloud target discovery is no longer active.

### AWS

To discover AWS cloud resources, Octopus uses the following variables:
Expand Down Expand Up @@ -83,6 +93,20 @@ From **Octopus 2022.3**, AWS steps that support target discovery will allow you

Once the variables for target discovery have been configured the **Amazon Web Services** tile will say **Cloud target discovery enabled** and clicking the tile will redirect you to the Variables screen for the project where the target discovery variables can be edited if required.

#### Switching off AWS cloud target discovery

To switch off cloud target discovery for AWS:

1. Navigate to your project's **Variables** screen.
2. Find and delete the following variables:
- `Octopus.Aws.Regions` (required)
- `Octopus.Aws.Account` (if configured)
- `Octopus.Aws.WorkerPool` (if configured)
- Any `Octopus.Aws.AssumedRole.*` variables (if configured)
3. Click **SAVE**.

Once the variables are removed, cloud target discovery will be switched off for AWS resources in this project. The **Amazon Web Services** tile in the **Cloud Connections** section of your AWS deployment steps will show **Configure** again, indicating that cloud target discovery is no longer active.

## Tag cloud resources

Octopus looks for tags applied to cloud resources to discover and create deployment targets for you.
Expand Down Expand Up @@ -127,7 +151,7 @@ If you have an existing project or environment, enable it with the following ste
To discover targets for an environment, dynamic infrastructure needs to be enabled. To enable for an existing environment:

1. Navigate to **Infrastructure ➜ Environments**.
1. Click the overflow menu (`...`) for the environment you want to enable or disable dynamic infrastructure on and select **Edit**.
1. Click the overflow menu (`...`) for the environment you want to enable or switch off dynamic infrastructure on and select **Edit**.
1. Expand the **Dynamic infrastructure** section and tick the check-box to enable dynamic infrastructure.
1. Click **SAVE**.

Expand Down