tags

Description

The tags parameter allows you to apply custom Azure resource tags to the rack's resource group and load balancer resources. Tags are key-value pairs useful for cost tracking, organization, and compliance.

Default Value

The default value is an empty string (""), which means no additional tags are applied beyond the system defaults (System=convox, Rack=<name>).

Use Cases

  • Cost Allocation: Tag resources with cost center or project identifiers for billing reports.
  • Environment Classification: Identify resources by environment (e.g., env=production).
  • Compliance: Apply mandatory organizational tags required by governance policies.

Setting Parameters

The value is a comma-separated list of key=value pairs. Each pair must contain an =, keys and values cannot contain a comma or a space, and a key cannot contain an =. A value that contains an = passes validation, and everything from that = onward is dropped when the tag is applied:

$ convox rack params set tags=env=production,team=platform -r rackName
Updating parameters... OK

Additional Information

Custom tags are merged with the default Convox tags (System=convox, Rack=<rack-name>). Tags are applied to the Azure resource group and propagated to load balancer annotations. Tag keys and values must comply with Azure tagging requirements.