Skip to content

Operator Tags

Tags in DRP are metadata labels applied to machine objects and documentation pages. In the Operator context, tags serve two distinct purposes: documentation navigation tags (used to organize this guide) and machine classification tags (used in workflow selection and machine filtering).

Documentation Tags

Each page in the Operator Guide is tagged with a role (operator) and a content type (explanation, howto, tutorial, reference). These tags drive the tag-based index pages and allow operators to filter documentation by type. The tag index below shows all pages in the Operator section organized by their tags.

Machine Tags and Metadata

In DRP, machines can be tagged using the Meta field on the machine object. Machine metadata tags are free-form key-value pairs that appear in the portal UI and can be used to filter machine lists. Common uses include:

  • Identifying the rack, row, or datacenter location of a machine
  • Marking machines by their intended role or workload type
  • Tracking asset ownership or cost center
  • Flagging machines that are in a specific state (e.g., quarantine, burn-in)
Bash
# Add metadata tags to a machine
drpcli machines update <machine-uuid> '{"Meta": {"rack": "A14", "role": "compute", "owner": "team-ml"}}'

# Filter machines by metadata tag
drpcli machines list | jq '[.[] | select(.Meta.rack == "A14")]'

# List all unique rack values across machines
drpcli machines list | jq '[.[] | .Meta.rack // "unset"] | unique | sort'

Tags in Workflow Selection

While DRP does not have a native "tag-based workflow selection" feature, machine metadata and parameters are both available to the classify content pack for workflow routing decisions. The classify/custom-functions mechanism allows operators to write test functions that inspect machine metadata tags and use them to select workflows or profiles.

The standard approach is to use the classify content pack's has_inventory_value test against flattened inventory parameters, or to write custom test functions that check Machine.Meta fields. This allows a single classify ruleset to route machines to different workflows based on their tagged role or location.

Tag Index

Following is a list of relevant tags for the Operator Section: