cluster.azure-vm.collect-kubeconfig

Collect the admin kubeconfig produced by a Azure VM Kubernetes bootstrap process.

Overview

Property	Value
Workflow type	Linear
Library	App-clusters-azure
Version	1.0

Input Schema

Field	Type	Required	Default	Description
workflow_run_id	string	No	—	Engine-stamped parent DAG run id when invoked as a Step target
organization_uuid	uuid	No	—	Organization UUID; scopes the collected credential.
subscription_id	string	No	—	Azure subscription override; defaults to the connection subscription.
connection_uuid	uuid	Yes	—	Azure CloudConnection UUID.
resource_group	string	Yes	—	Explicit Azure subscription override.
vm_name	string	Yes	—	VM name that ran the Kubernetes bootstrap.
cluster_name	string	No	—	Logical cluster name for kubeconfig context normalization.
bootstrap_output_source	string	No	—	serial-port
timeout_seconds	integer	No	—	Timeout for polling bootstrap output.
poll_interval_seconds	integer	No	—	Poll interval for bootstrap output.

Output Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	No	—	Azure CloudConnection UUID echoed from input.
resource_group	string	Yes	—	Resolved Azure subscription.
zone	string	No	—	Azure region.
vm_name	string	No	—	VM name.
cluster_name	string	No	—	Logical cluster name.
kubeconfig	string	No	—	Kubeconfig YAML collected from bootstrap output.
api_server	string	No	—	Kubernetes API server URL parsed from kubeconfig.
ca_certificate	string	No	—	CA certificate data parsed from kubeconfig.
context_name	string	No	—	Normalized kubeconfig context name.
collected_at	string	No	—	ISO timestamp when kubeconfig was collected.
source	string	No	—	Bootstrap output source used.
failure_reason	string	No	—	Human-readable failure reason.
failed_step	string	No	—	Failed logical step.
failed_layer	json	No	—	Engine failed layer if applicable.
failed_at_state	string	No	—	State where failure occurred.
error	string	No	—	Error message.
error_type	string	No	—	Error class.
failed_at	string	No	—	ISO failure timestamp.

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	collect	—
collecting	No	No	—	complete	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	collect	collecting	—
collecting	complete	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "cluster.azure-vm.collect-kubeconfig",
  "initial_data": {
    "connection_uuid": "value",
    "resource_group": "value",
    "vm_name": "value"
  }
}