Quick Start (10 min)

This quick start gets you from zero to a running cluster, a kubeconfig, and a join token.

The primary path uses the web console. The CLI path is beta and may change.

Console (primary)

  1. Create a cluster

    • Open the Noplane Console and go to Managed Clusters.

    • Select New Tenant to create a new cluster.

    • Choose the Kubernetes version and replicas, then submit.

  2. Get your kubeconfig

    • In the cluster card, select Kubeconfig.

    • Copy to clipboard or download the file.

  3. Create a join token and command

    • Open Tokens for the cluster.

    • Select Create Token and copy the token or join command.

  4. Test the join token (optional)

    • Use the Kubernetes version shown in the cluster card.

    • Example dry run with Docker:

docker run --rm -it --entrypoint kubeadm \
  kindest/node:v1.31.0 \
  join crafty-antelope-v2.k8s.noplane.io:6443 \
  --token <token> \
  --discovery-token-ca-cert-hash sha256:<ca-hash> \
  --dry-run --ignore-preflight-errors=all \
  --v=5

  1. Deploy a dummy app

    • Use kubectl to deploy a small workload (see the deploy guide).

CLI (beta)

  1. Create a cluster from the CLI.

  2. Fetch kubeconfig from the CLI.

  3. Create a join token and join command from the CLI.

The CLI is beta and its commands may change. Use the CLI reference for the latest syntax.