Skip to content

Commit 0aec4cb

Browse files
authored
Updated Tagging Nodes Documentation page (#436)
* Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Freshness Pass * Update 8-1-0.md * Update 8-1-0.md * Update 8-1-0.md * Update 8-4-0.md * Update tag-nodes.md Added note about the restricted characters when tagging nodes and added an example. * Update tag-nodes.md * Update tag-nodes.md Removed moniker tag
1 parent 96cb1e5 commit 0aec4cb

File tree

1 file changed

+16
-9
lines changed

1 file changed

+16
-9
lines changed

articles/cyclecloud/how-to/tag-nodes.md

Lines changed: 16 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Tagging Nodes
33
description: Learn about tagging nodes in Azure CycleCloud. CycleCloud automatically adds Azure tags to resources created from nodes.
44
author: adriankjohnson
5-
ms.date: 03/20/2020
5+
ms.date: 2/7/2025
66
ms.author: adjohnso
77
---
88

@@ -16,9 +16,9 @@ Azure CycleCloud will automatically create and add three tags to each node: a na
1616
| Name | Name of the node (for head node resources only) |
1717
| CycleOwner | The user that started the node |
1818
| LaunchTime | The time that this resource was created |
19-
| ClusterId | A identifier for the cluster (deprecated as of 8.2) |
20-
| CycleCloudCluster | A globally unique name for the cluster (as of 8.2) |
21-
| CycleCloudNodeArray | A globally unique name for the nodearray, if it comes from a nodearray (as of 8.2) |
19+
| ClusterId | A identifier for the cluster (Available on CycleCloud v8.2 or earlier) |
20+
| CycleCloudCluster | A globally unique name for the cluster (Available from CycleCloud v8.2 onwards) |
21+
| CycleCloudNodeArray | A globally unique name for the nodearray, if it comes from a nodearray (Available from CycleCloud v8.2 onwards) |
2222

2323
The formats for the encoded tags are as follows:
2424
- `CycleCloudCluster`: /sites/[site_id]/clusters/[cluster_name]
@@ -47,11 +47,11 @@ Nodes in the "Compute" nodearray would get an additional tag:
4747
CycleCloudNodeArray => "/sites/92xy4vgh/clusters/Demo/nodearrays/Compute"
4848
```
4949

50-
::: moniker range=">=cyclecloud-8"
50+
#::: moniker range=">=cyclecloud-8"
5151
> [!NOTE]
5252
> The CycleCloudCluster and CycleCloudNodeArray tags were added in 8.2 to make it easier to get costs from Azure Cost Management, using a standard format also used for
5353
> the subject of [events sent to Event Grid](~/events.md#subject). The value for ClusterId is not constant over time, since the site name and owner can be changed.
54-
::: moniker-end
54+
#::: moniker-end
5555

5656

5757
Within a resource that supports [Resource Manager Operations](/azure/azure-resource-manager/resource-group-using-tags) you can create additional tags to assign to the instance by specifying them with a node definition inside your template:
@@ -74,13 +74,20 @@ CustomText => "Hello world"
7474

7575
## Restrictions
7676

77-
There are limits on the number and format of tags applied to each Virtual Machine. Please review the [Tagging Azure Resources documentation](/azure/azure-resource-manager/resource-group-using-tags) for full details.
77+
There are limits on the number and format of tags applied to each Virtual Machine. Please review the [Limitations on tagging Azure Resources documentation](/azure/azure-resource-manager/management/tag-resources#limitations) for full details.
7878

7979
Do not include quotation marks or periods in your tag names.
8080

8181
> [!NOTE]
82-
> Tag names in CycleCloud cannot contain the following characters:<br>
83-
> `.` `"` `:` `=`
82+
> Tag names in CycleCloud cannot contain the following characters: `.` `"` `:` `=`
83+
> If a tag needs to include a period ('.'), use the notation Tag == ['tag.subtag'=value]. For instance, if you want to create a tag named compute.node, you should use Tag == ['compute.node'=value].
84+
>
85+
> Also, following are some alternatives to the notation Tag == ['tag.subtag'=value] for defining tags with periods:
86+
> - **Underscores**: Use underscores instead of periods, e.g., Tag == ['compute_node'=value].
87+
> - **CamelCase**: Combine the main tag and subtag without separators, e.g., Tag == ['computeNode'=value].
88+
> - **Nested Tags**: Represent the hierarchical structure, e.g., Tag == ['compute'={'node'=value}].
89+
> - **Colon Separator**: Use a colon instead of a period, e.g., Tag == ['compute:node'=value].
90+
8491

8592
## Further Reading
8693

0 commit comments

Comments
 (0)