diff --git a/src/pages/docs/infrastructure/deployment-targets/index.mdx b/src/pages/docs/infrastructure/deployment-targets/index.mdx index d0072e343e..cba75ab13a 100644 --- a/src/pages/docs/infrastructure/deployment-targets/index.mdx +++ b/src/pages/docs/infrastructure/deployment-targets/index.mdx @@ -1,7 +1,7 @@ --- layout: src/layouts/Default.astro pubDate: 2023-01-01 -modDate: 2023-01-01 +modDate: 2024-04-17 title: Deployment targets description: How to configure deployment targets in Octopus navOrder: 10 @@ -32,23 +32,23 @@ Deployment targets are added in different ways, depending on the type of target - [Offline package drop](/docs/infrastructure/deployment-targets/offline-package-drop) - [Cloud regions](/docs/infrastructure/deployment-targets/cloud-regions) -## Target roles \{#target-roles} +## Target tags (formerly target roles) \{#target-roles} -### Add target roles \{#create-target-roles} +### Add target tags \{#create-target-roles} -Roles are created and saved in the database as soon as you assign them to a deployment target. +Target tags are created and saved in the database as soon as you assign them to a deployment target. -Decide on the naming convention you will use before creating your first target role as it's not possible to change the case after the role has been created, for instance, all lowercase to camel case. +Decide on the naming convention you will use before creating your first target tag as it's not possible to change the case after the target tag has been created, for instance, all lowercase to camel case. 1. Register a deployment target or click on an already registered deployment target and go to **Settings**. -2. In the **Target Roles** field, enter the target role you'd like to use (no spaces). +2. In the **Target Tags** field, enter the target tag you'd like to use (no spaces). 3. Save the target settings. -The role has been created and assigned to the deployment target and can be added to other deployment targets. +The target tag has been created and assigned to the deployment target and can be added to other deployment targets. -You can check all the roles assigned to your deployment targets from the **Infrastructure** tab. +You can check all the target tags assigned to your deployment targets from the **Infrastructure** tab. ## Dynamic infrastructure diff --git a/src/shared-content/infrastructure/target-roles.include.md b/src/shared-content/infrastructure/target-roles.include.md index 730c8f8488..fb71238763 100644 --- a/src/shared-content/infrastructure/target-roles.include.md +++ b/src/shared-content/infrastructure/target-roles.include.md @@ -1,12 +1,17 @@ [Getting Started - Machine Roles](https://www.youtube.com/watch?v=AU8TBEOI-0M) -Before you can deploy software to your deployment targets, you need to tag them with target roles. This ensures you deploy the right software to the right deployment targets. Typical target roles include: +:::div{.info} +**Target roles** are **target tags** from Octopus Deploy **2024.2** onwards. The functionality remains the same. This is only a name change to make our terminology clearer. +::: +Before you can deploy software to your deployment targets, you need to associate them with target tags. This ensures you deploy the right software to the right deployment targets. Typical target tags include: + +- product-cluster - web-server - app-server - db-server -Using target roles means the infrastructure in each of your environments doesn't need to be identical and the deployment process will know which deployment targets to deploy your software to. +Using target tags means the infrastructure in each of your environments doesn't need to be identical and the deployment process will know which deployment targets to deploy your software to. -Deployment targets can have more than one role, and more than one deployment target can have the same role, but every deployment target must have at least one role. +Deployment targets can have more than one target tag, and more than one deployment target can have the same tag, but every deployment target must have at least one tag.