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

# 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 -- Full cluster lifecycle: create, list, get, delete, kubeconfig, versions, and nodes

• Node Pools -- Node pool management: list, get, create, scale, and delete