feat(hardware categorization): add description field to flavors

Allow flavors to have a user friendly description in them.

Author: cardoe

ansible/roles/nova_flavors/README.md

@@ -23,6 +23,7 @@ See the [UnderStack Flavors Design Guide](https://rackerlabs.github.io/understac
 ```yaml
 name: m1.small.nicX
 resource_class: m1.small
+description: Small compute flavor with NICX network hardware - 16 cores, 128GB RAM, dual 480GB drives
 traits:
   - trait: NICX
     state: required
@@ -53,6 +54,7 @@ resource_class:
 - **vCPUs**: 16 (from device-type cpu.cores)
 - **RAM**: 131072 MB (from device-type memory.size)
 - **Disk**: 480 GB (from device-type drives[0].size)
+- **Description**: "Small compute flavor with NICX network hardware - 16 cores, 128GB RAM, dual 480GB drives" (from flavor.description)
 - **Extra Specs**:
   - `resources:VCPU='0'` - bare metal doesn't consume virtual CPU
   - `resources:MEMORY_MB='0'` - bare metal doesn't consume virtual memory

ansible/roles/nova_flavors/tasks/nova_flavors.yml

@@ -87,6 +87,7 @@
     # Scheduling properties
     extra_specs: "{{ combined_extra_specs }}"
     is_public: true
+    description: "{{ flavor_item.description | d('') }}"
   async: "{{ flavor_creation_timeout }}"
   poll: 0
   register: flavor_job

docs/design-guide/flavors.md

@@ -48,6 +48,7 @@ Flavor definitions are YAML files validated against `schema/flavor.schema.json`.
 
 ### Optional Fields
 
+* **description**: Human-readable description shown in Nova flavor details
 * **traits**: Array of trait requirements for hardware matching
     * **trait**: Trait name without `CUSTOM_` prefix (e.g., `NICX`, `GPU`, `NVME`)
         * Pattern: `^[A-Z][A-Z0-9_]*$` (uppercase alphanumeric and underscores)
@@ -61,6 +62,7 @@ Flavor definitions are YAML files validated against `schema/flavor.schema.json`.
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small
 resource_class: m1.small
+description: Small compute flavor with 16 cores, 128GB RAM, and dual 480GB drives
 ```
 
 This matches all Ironic nodes with `resource_class=m1.small`, regardless of traits. Nova flavor properties (vCPUs, RAM, disk) come from the device-type's `m1.small` resource class definition.
@@ -72,6 +74,7 @@ This matches all Ironic nodes with `resource_class=m1.small`, regardless of trai
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small.nicX
 resource_class: m1.small
+description: Small compute flavor with NICX network hardware - 16 cores, 128GB RAM, dual 480GB drives
 traits:
   - trait: NICX
     state: required

docs/operator-guide/flavors.md

@@ -43,23 +43,30 @@ Start with the YAML language server directive for editor validation:
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small
 resource_class: m1.small
+description: Small compute flavor with 16 cores, 128GB RAM, and dual 480GB drives
 ```
 
 **Required Fields**:
 
 * `name`: Unique flavor name (e.g., `m1.small`, `compute.standard`)
 * `resource_class`: Must match a resource class defined in a device-type
 
+**Optional Fields**:
+
+* `description`: Human-readable description shown in Nova flavor details
+* `traits`: Hardware trait requirements for filtering nodes (see below)
+
 **Note**: Nova flavor properties (vCPUs, RAM, disk) are automatically derived from the device-type resource class specification for convenience. Nova performs scheduling by matching the resource class and traits on Ironic nodes. See the [OpenStack Ironic flavor configuration documentation](https://docs.openstack.org/ironic/latest/install/configure-nova-flavors.html) for details.
 
-### 3. Add Trait Requirements (Optional)
+### 3. Add Optional Description and Trait Requirements
 
-Define hardware trait requirements to filter which nodes match this flavor:
+Add a description and/or hardware trait requirements to filter which nodes match this flavor:
 
 ```yaml
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small.nicX
 resource_class: m1.small
+description: Small compute flavor with NICX network hardware - 16 cores, 128GB RAM, dual 480GB drives
 traits:
   - trait: NICX
     state: required

examples/deploy-repo/hardware/flavors/m1.small.nicX.yaml

@@ -1,6 +1,7 @@
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small.nicX
 resource_class: m1.small
+description: Small compute flavor with NICX network hardware - 16 cores, 128GB RAM, dual 480GB drives
 traits:
   - trait: NICX
     state: required

examples/deploy-repo/hardware/flavors/m1.small.yaml

@@ -1,3 +1,4 @@
 # yaml-language-server: $schema=https://rackerlabs.github.io/understack/schema/flavor.schema.json
 name: m1.small
 resource_class: m1.small
+description: Small compute flavor with 16 cores, 128GB RAM, and dual 480GB drives

schema/flavor.schema.json

@@ -15,6 +15,10 @@
       "type": "string",
       "minLength": 1
     },
+    "description": {
+      "description": "Human-readable description of the flavor shown in Nova",
+      "type": "string"
+    },
     "traits": {
       "description": "Hardware traits for node matching (CUSTOM_ prefix added automatically)",
       "type": "array",