Skip to content

Getting Started

Help

grn                              # Show available commands
grn help                         # Same
grn vks                          # Show available VKS commands
grn vks create-cluster help      # Show command help with required/optional args

Command structure

grn [global-options] <service> <command> [command-options]

Example:

grn --profile staging --output table vks list-clusters --page-size 20

Basic commands

# List clusters
grn vks list-clusters

# Get cluster details
grn vks get-cluster --cluster-id k8s-xxxxx

# Create a cluster
grn vks create-cluster \
  --name my-cluster \
  --k8s-version v1.30.10-vks.1746550800 \
  --network-type CILIUM_OVERLAY \
  --vpc-id net-xxxxx \
  --subnet-id sub-xxxxx \
  --cidr 192.168.0.0/16 \
  --node-group-name default \
  --flavor-id flav-xxxxx \
  --image-id img-xxxxx \
  --disk-type vtype-xxxxx \
  --ssh-key-id ssh-xxxxx

# Delete a cluster (prompts for confirmation)
grn vks delete-cluster --cluster-id k8s-xxxxx

# Wait for cluster to be ready
grn vks wait-cluster-active --cluster-id k8s-xxxxx