Use descriptions and tag comments for lightweight documentation. For deploy-time notes, write a small file with cloud-init.
maas admin machine update <SYSID> description="Intel NUC under the TV; 500G SSD; noisy fan"
maas admin tag update k8s comment="K8s workers; GPU-ready"
USER_DATA=$(base64 -w0 <<'YAML'
#cloud-config
write_files:
- path: /etc/motd.d/99-operator-note
permissions: "0644"
content: |
Welcome to ace-01; owner: stormrider; zone: az1; pool: lab
YAML
)
maas admin machine deploy <SYSID> os=ubuntu release=noble user_data="$USER_DATA"