{"$comment":"UPSTREAM OWNER: gdc-companion (docs/machine-schema.json). DO NOT EDIT DIRECTLY. This file is vendored from the gdc-companion repository to support hermetic, air-gapped CI and offline validation. Run bin/sync-schemas.sh to sync with upstream.","$schema":"http://json-schema.org/draft-07/schema#","description":"JSON schema for machine configuration objects served and ingested via /v1/machine-info/{mac-address}.","properties":{"bmctl_version":{"description":"Version of bmctl / Anthos bare metal orchestration tool.","type":"string"},"cluster":{"description":"Target cluster configuration metadata.","properties":{"cluster_admin_emails":{"description":"Optional list of admin user email addresses granted RBAC cluster-admin permissions.","items":{"type":"string"},"type":"array"},"cluster_name":{"type":"string"},"config_sync_enabled":{"default":true,"description":"Optional toggle to install ConfigSync operator. Defaults to true.","type":"boolean"},"fleet_cluster_labels":{"items":{"type":"string"},"type":"array"},"networking":{"properties":{"cluster_ingress":{"type":"string"},"cluster_lb_range":{"type":"string"},"cluster_vip":{"type":"string"}},"required":["cluster_vip","cluster_ingress","cluster_lb_range"],"type":"object"},"primary_root_repo":{"description":"Primary RootSync repository configuration (git or oci).","oneOf":[{"description":"Legacy OCI or Git URI string for backward compatibility.","type":"string"},{"description":"Null if ConfigSync is enabled without a root repo.","type":"null"},{"description":"Structured Git or OCI repository configuration.","properties":{"cluster-config-name":{"description":"Optional override for cluster subfolder directory under config/clusters/ (kebab-case).","type":"string"},"cluster_config_name":{"description":"Optional override for cluster subfolder directory under config/clusters/.","type":"string"},"git":{"anyOf":[{"required":["repo_url"]},{"required":["repo-url"]}],"description":"Git repository configuration for ConfigSync RootSync.","properties":{"branch":{"default":"main","description":"Git branch to sync.","type":"string"},"cluster-config-name":{"description":"Optional override for cluster subfolder directory under config/clusters/ (kebab-case).","type":"string"},"cluster_config_name":{"description":"Optional override for cluster subfolder directory under config/clusters/.","type":"string"},"gsm-auth-secret":{"anyOf":[{"required":["gsm-name"]},{"required":["gsm_name"]}],"description":"Structured secret mapping Google Secret Manager to Kubernetes.","properties":{"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm-name":{"description":"Secret Manager secret name containing credentials in GCP.","type":"string"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (snake_case alias).","type":"string"},"gsm_name":{"description":"Secret Manager secret name containing credentials in GCP (snake_case alias).","type":"string"},"k8s-name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync.","type":"string"},"k8s-namespace":{"default":"config-management-system","description":"Target Kubernetes namespace.","type":"string"},"k8s_name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync (snake_case alias).","type":"string"},"k8s_namespace":{"default":"config-management-system","description":"Target Kubernetes namespace (snake_case alias).","type":"string"}},"type":"object"},"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (kebab-case alias).","type":"string"},"gsm_auth_secret":{"anyOf":[{"required":["gsm-name"]},{"required":["gsm_name"]}],"description":"Structured secret mapping Google Secret Manager to Kubernetes (snake_case alias).","properties":{"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm-name":{"description":"Secret Manager secret name containing credentials in GCP.","type":"string"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (snake_case alias).","type":"string"},"gsm_name":{"description":"Secret Manager secret name containing credentials in GCP (snake_case alias).","type":"string"},"k8s-name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync.","type":"string"},"k8s-namespace":{"default":"config-management-system","description":"Target Kubernetes namespace.","type":"string"},"k8s_name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync (snake_case alias).","type":"string"},"k8s_namespace":{"default":"config-management-system","description":"Target Kubernetes namespace (snake_case alias).","type":"string"}},"type":"object"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm_secret_name":{"description":"Secret Manager secret name containing read-only Git PAT / credentials.","type":"string"},"repo-url":{"description":"Git repository URL (kebab-case).","type":"string"},"repo_url":{"description":"Git repository URL.","type":"string"}},"type":"object"},"oci":{"description":"OCI registry configuration for ConfigSync RootSync.","properties":{"dir-path":{"description":"Optional directory path to sync from inside the container filesystem.","type":"string"},"gsa":{"description":"GCP Service Account name for Workload Identity Artifact Registry access.","type":"string"},"gsm-auth-secret":{"anyOf":[{"required":["gsm-name"]},{"required":["gsm_name"]}],"description":"Structured secret mapping Google Secret Manager to Kubernetes.","properties":{"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm-name":{"description":"Secret Manager secret name containing credentials in GCP.","type":"string"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (snake_case alias).","type":"string"},"gsm_name":{"description":"Secret Manager secret name containing credentials in GCP (snake_case alias).","type":"string"},"k8s-name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync.","type":"string"},"k8s-namespace":{"default":"config-management-system","description":"Target Kubernetes namespace.","type":"string"},"k8s_name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync (snake_case alias).","type":"string"},"k8s_namespace":{"default":"config-management-system","description":"Target Kubernetes namespace (snake_case alias).","type":"string"}},"type":"object"},"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (kebab-case alias).","type":"string"},"gsm_auth_secret":{"anyOf":[{"required":["gsm-name"]},{"required":["gsm_name"]}],"description":"Structured secret mapping Google Secret Manager to Kubernetes (snake_case alias).","properties":{"gsm-location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm-name":{"description":"Secret Manager secret name containing credentials in GCP.","type":"string"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (snake_case alias).","type":"string"},"gsm_name":{"description":"Secret Manager secret name containing credentials in GCP (snake_case alias).","type":"string"},"k8s-name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync.","type":"string"},"k8s-namespace":{"default":"config-management-system","description":"Target Kubernetes namespace.","type":"string"},"k8s_name":{"description":"Kubernetes Secret name created in k8s-namespace and referenced by RootSync (snake_case alias).","type":"string"},"k8s_namespace":{"default":"config-management-system","description":"Target Kubernetes namespace (snake_case alias).","type":"string"}},"type":"object"},"gsm_location":{"default":"global","description":"Secret Manager secret location/replication (e.g. global, us-west1).","type":"string"},"gsm_secret_name":{"description":"Secret Manager secret name containing read-only registry pull credentials.","type":"string"},"image":{"description":"OCI image reference.","type":"string"}},"required":["image"],"type":"object"}},"type":"object"}]},"primary_root_repo_auth_secret":{"description":"Optional legacy authentication secret name for primary_root_repo string.","type":["string","null"]},"sub_ca_secret":{"description":"Enterprise Intermediate Sub-CA credentials stored in Google Cloud Secret Manager","properties":{"gsm-location":{"default":"global","description":"Secret Manager replication location (e.g., global, us-central1)","type":"string"},"gsm-name":{"description":"Identifier of the Secret Manager secret holding the Sub-CA JSON payload","type":"string"},"gsm_location":{"default":"global","description":"Secret Manager replication location (snake_case alias)","type":"string"},"gsm_name":{"description":"Identifier of the Secret Manager secret holding the Sub-CA JSON payload (snake_case alias)","type":"string"}},"required":["gsm-name"],"type":"object"}},"required":["cluster_name","networking","fleet_cluster_labels"],"type":"object"},"custom_extensions":{"description":"Optional custom Ansible playbook lifecycle extension configuration.","properties":{"bundle_url":{"description":"HTTPS URL from which the edge node downloads the playbook tarball.","format":"uri","type":"string"},"sha256":{"description":"Hex-encoded SHA-256 checksum of the bundle tarball.","pattern":"^[a-fA-F0-9]{64}$","type":"string"}},"required":["bundle_url","sha256"],"type":["object","null"]},"gcp_info":{"description":"Google Cloud Platform metadata and service account configuration.","properties":{"primary_gsa":{"description":"Primary Google Service Account email address.","type":"string"},"project_id":{"description":"GCP Project ID.","type":"string"},"region":{"description":"GCP Region name.","type":"string"}},"required":["project_id","region","primary_gsa"],"type":"object"},"hostname":{"description":"Target machine hostname.","type":"string"},"machine_state_stop_stage":{"description":"Optional lifecycle stage at which to gracefully halt provisioning (e.g. FIRST_BOOT, SECOND_BOOT, LINUX_READY, CLUSTER_READY, CLUSTER_TURNUP, POST_CLUSTER, UPKEEP).","type":["string","null"]},"network":{"description":"Network configurations for management and cluster interfaces.","properties":{"cluster_network":{"description":"Cluster VLAN interface network settings.","properties":{"dhcp_v4":{"description":"Whether IPv4 DHCP is enabled on cluster interface.","type":"boolean"},"dns_servers":{"description":"Optional array of DNS server IPv4 addresses on cluster network.","items":{"type":"string"},"type":"array"},"gateway":{"description":"Optional gateway IPv4 address on cluster network (falls back to management gateway if omitted).","type":"string"},"ip_cidr":{"description":"Static IPv4 address and CIDR prefix on cluster interface (e.g. 192.168.109.12/24).","type":"string"},"vlan_id":{"description":"802.1Q VLAN ID for cluster network.","type":"integer"}},"required":["vlan_id","dhcp_v4"],"type":"object"},"management_network":{"description":"Management interface network settings.","properties":{"dhcp_v4":{"description":"Whether IPv4 DHCP is enabled. If true, ip_cidr is optional.","type":"boolean"},"dns_servers":{"description":"Array of DNS server IPv4 addresses.","items":{"type":"string"},"type":"array"},"gateway":{"description":"Default gateway IPv4 address.","type":"string"},"ip_cidr":{"description":"Static IPv4 address and CIDR prefix (e.g. 192.168.9.150/24).","type":"string"}},"required":["dhcp_v4","dns_servers"],"type":"object"}},"required":["management_network","cluster_network"],"type":"object"},"peers":{"description":"Array of peer node definitions.","items":{"properties":{"hostname":{"type":"string"},"ipv4":{"type":"string"},"node_type":{"type":"string"},"primary":{"type":"boolean"},"required":{"type":"boolean"}},"required":["hostname","ipv4"],"type":"object"},"type":"array"}},"required":["hostname","bmctl_version","network","gcp_info","cluster","peers"],"title":"GDC Bare-Metal Machine Config Schema","type":"object"}