Prototype KubeClaw is a learning project exploring what a secure, scalable Kubernetes environment for AI agents looks like. It is not production ready and not beta. Expect breaking changes and unreviewed assumptions. Read the project status.

Outputs Reference

Every OpenTofu output, what consumes it, and how to query it.

All outputs exposed by the OpenTofu configuration. These are consumed by the setup scripts and can be queried manually.

Network Information

OutputDescription
network_idID of the private network
network_nameName of the private network

Cluster Metadata

OutputDescription
cluster_nameName of the cluster
admin_userAdmin user name
ssh_key_prefixPrefix used for SSH key filenames

Master Control Node

OutputDescription
master_control_node_idID of the master control node
master_control_node_nameName of the master control node
master_control_node_private_ipPrivate IP of the master control node

All Control Nodes (master + replicas)

OutputDescription
control_node_countTotal number of control nodes (master + replicas)
control_node_idsIDs of all control nodes
control_node_namesNames of all control nodes
control_node_private_ipsPrivate IPs of all control nodes

Worker Nodes

OutputDescription
worker_node_countNumber of worker nodes
worker_node_idsIDs of worker nodes
worker_node_namesNames of worker nodes
worker_node_private_ipsPrivate IPs of worker nodes

Admin Node

OutputDescription
admin_node_idID of the admin node (null if disabled)
admin_node_nameName of the admin node (null if disabled)
admin_node_ipv6Public IPv6 address of the admin node (null if disabled)
admin_node_private_ipPrivate IP of the admin node (null if disabled)
enable_admin_nodeWhether the admin node is enabled

SSH Keys

These outputs are sensitive when auto-generated keys are used.

OutputSensitiveDescription
control_node_ssh_private_keyYesPrivate SSH key for control nodes (only if auto-generated)
control_node_ssh_public_keyNoPublic SSH key for control nodes
worker_node_ssh_private_keyYesPrivate SSH key for worker nodes (only if auto-generated)
worker_node_ssh_public_keyNoPublic SSH key for worker nodes
admin_node_ssh_private_keyYesPrivate SSH key for admin node (only if auto-generated)
admin_node_ssh_public_keyNoPublic SSH key for admin node
using_custom_keysNoMap showing which node roles use custom keys

SSH Config

OutputDescription
ssh_config_snippetSSH config snippet for ~/.ssh/config. Generates Host entries for admin-node (ProxyJump), cloudflare tunnel (ProxyCommand), and all nodes. All entries include IdentitiesOnly yes.

Feature Flags

OutputDescription
cloudflare_tunnel_domainConfigured Cloudflare Tunnel domain
cloudflare_tunnel_configuredWhether cloudflare_tunnel_token was set, i.e. whether cloud-init installed the tunnel automatically
nat64_enabledWhether NAT64/DNS64 is enabled
k8s_prereqs_enabledWhether Kubernetes prerequisites are installed via cloud-init

Next Steps Banner

OutputDescription
next_stepsInstructions banner displayed after tofu apply

Querying outputs

# List all outputs
tofu output

# Get a specific output
tofu output master_control_node_private_ip

# Get a sensitive output (raw)
tofu output -raw control_node_ssh_private_key

# Export SSH key to file
tofu output -raw control_node_ssh_private_key > ~/.ssh/k8s-cluster_control-node_key
chmod 600 ~/.ssh/k8s-cluster_control-node_key