> For the complete documentation index, see [llms.txt](https://docs.acecloud.ai/knowledge-base/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acecloud.ai/knowledge-base/cli/kubernetes.md).

# Kubernetes

AceCloud provides managed Kubernetes clusters powered by RKE2. The `ace k8s` command group lets you create, manage, and interact with Kubernetes clusters, node pools, and nodes from the CLI.

## Command Structure

```
ace k8s cluster list                    # List all clusters
ace k8s cluster get <name-or-id>        # Get cluster details
ace k8s cluster create ...              # Create a new cluster
ace k8s cluster delete <name-or-id>     # Delete a cluster
ace k8s cluster versions                # List available K8s versions
ace k8s cluster kubeconfig <name-or-id> # Generate kubeconfig
ace k8s cluster nodes <name-or-id>      # List nodes in a cluster
ace k8s cluster nodepool list <cluster> # List node pools
ace k8s cluster nodepool get <pool>     # Get node pool details
ace k8s cluster nodepool create ...     # Add a node pool
ace k8s cluster nodepool scale <pool>   # Scale a node pool
ace k8s cluster nodepool delete <pool>  # Delete a node pool
```

## Aliases

| Command                    | Aliases                                           |
| -------------------------- | ------------------------------------------------- |
| `ace k8s`                  | `ace kubernetes`                                  |
| `ace k8s cluster`          | `ace k8s cl`                                      |
| `ace k8s cluster nodepool` | `ace k8s cluster np`, `ace k8s cluster node-pool` |

## Prerequisites

Before creating a Kubernetes cluster, ensure you have:

1. **Authenticated** with `ace login`
2. **Selected a project** with `--project` or via config
3. **Selected a region** with `--region` or via config
4. **A flavor** for worker nodes (use `ace flavor list` to browse)
5. **A security group** (optional, use `ace security-group list`)

## Quick Start

```bash
# Check available Kubernetes versions
ace k8s cluster versions

# Check available flavors
ace flavor list

# Create a cluster with defaults
ace k8s cluster create \
  --name my-cluster \
  --version v1.32.6 \
  --flavor ACE.CPU.4C16R \
  --worker-name pool1

# Wait for provisioning, then get kubeconfig
ace k8s cluster get my-cluster
ace k8s cluster kubeconfig my-cluster > ~/.kube/config

# List nodes
ace k8s cluster nodes my-cluster
```

## Topics

* [**Clusters**](/knowledge-base/cli/kubernetes/clusters.md) -- Full cluster lifecycle: create, list, get, delete, kubeconfig, versions, and nodes
* [**Node Pools**](/knowledge-base/cli/kubernetes/node-pools.md) -- Node pool management: list, get, create, scale, and delete