autonomy node enroll

Register a node with the orchestrator fleet

Synopsis

Registers a node with the orchestrator enrollment registry.

Enrollment is an explicit operator action that associates a node identity
with the orchestrator fleet.  It is independent of event ingestion: a node
may be enrolled before it starts emitting events, or after.

This command is idempotent.  Re-enrolling an already-enrolled node returns
the existing record with no changes — including --enrollment-ref. Rotating
the enrollment ref on an already-enrolled node is deliberately not
supported here; it would need a separate PUT endpoint with operator-action
semantics (audit log, role gating, revocation cascade).

Usage

autonomy node enroll [flags]

Options

      --domain-id string          Logical domain or group for this node
      --enrolled-by string        Operator name for audit trail
      --enrollment-ref string     Canonical attestation join key; exact-match against bundle.Manifest.Provenance.EnrollmentRef at attestation time. Set only on initial enrollment (idempotent contract preserves the original value on re-enroll)
      --label stringArray         Label in key=value form (repeatable, e.g. --label env=prod)
      --node-id string            Node identifier (required)
      --orchestrator-url string   orchestrator base URL (env: AUTONOMY_ORCHESTRATOR_URL)
      --output string             output format: "text" (human-readable) or "json" (machine-readable) (default "text")

See also

• autonomy node — Manage node enrollment in the orchestrator fleet