Skip to content

Commit

Permalink
[resource/host] Define host.mac semantic convention
Browse files Browse the repository at this point in the history
  • Loading branch information
mx-psi committed Sep 22, 2023
1 parent a89f573 commit e25b0aa
Show file tree
Hide file tree
Showing 2 changed files with 12 additions and 0 deletions.
3 changes: 3 additions & 0 deletions docs/resource/host.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,9 @@
| `host.image.name` | string | Name of the VM image or OS install the host was instantiated from. | `infra-ami-eks-worker-node-7d4ec78312`; `CentOS-8-x86_64-1905` | Recommended |
| `host.image.id` | string | VM image ID or host OS image ID. For Cloud, this value is from the provider. | `ami-07b06b442921831e5` | Recommended |
| `host.image.version` | string | The version string of the VM image or host OS as defined in [Version Attributes](README.md#version-attributes). | `0.1` | Recommended |
| `host.mac` | string[] | Available MAC addresses of the host, excluding loopback interfaces. [1] | `[ac-de-48-23-45-67, AC-DE-48-23-45-67-01-9F]` | Opt-In |

**[1]:** MAC Addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf): as hyphen-separated octets in hexadecimal form from most to least significant.

`host.arch` has the following list of well-known values. If one of them applies, then the respective value MUST be used, otherwise a custom value MAY be used.

Expand Down
9 changes: 9 additions & 0 deletions model/resource/host.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,15 @@ groups:
The version string of the VM image or host OS as defined in
[Version Attributes](README.md#version-attributes).
examples: ['0.1']
- id: mac
type: string[]
requirement_level: opt_in
brief: >
Available MAC addresses of the host, excluding loopback interfaces.
note: >
MAC Addresses MUST be represented in [IEEE RA hexadecimal form](https://standards.ieee.org/wp-content/uploads/import/documents/tutorials/eui.pdf):
as hyphen-separated octets in hexadecimal form from most to least significant.
examples: ['ac-de-48-23-45-67', 'AC-DE-48-23-45-67-01-9F']
- id: host.cpu
prefix: host.cpu
type: resource
Expand Down

0 comments on commit e25b0aa

Please sign in to comment.