Adding tags

Tags are arbitrary, user-defined key:value pairs that you can add to workloads to enable you to filter resources and events in a variety of ways, without imposing a specific structure or set of semantics. As long as they have the format key:value (no spaces), you can make them anything you want.

Tags are useful because you can use them for filtering views throughout the UI. For example, you can make Buoyant Cloud show only the resources owned by your team, and hide everything else.

Some ideas for using tags:

• Use tags to track environment - e.g. env:prod, env:staging, env:dev
• Use tags to track regions or zones - e.g. region:us-east, or region:us-west
• Use tags to track which team owns the workload(s) - e.g. team:front-end, team:billing
• Use tags to track which workloads are your product vs infrastructure - e.g. role:infra, role:product

Adding tags to workloads

There are two ways to add tags to workloads:

Via the Clusters page in the Buoyant Cloud UI:

Click the “kebab” menu all the way on the right of a cluster and select “Configure”. From there, you may specify tags; each tag can be applied to all workloads in the cluster (Cluster tags), or all workloads in a namespace (Namespace tags). After clicking update, those tags will be applied to the appropriate workloads.

Via a Kubernetes annotation on a workload:

buoyant.cloud/tags : comma-delimited list of key:value pairs that are descriptors of a workload, e.g. env:prod,tier:1,team:payments