Virtual Cluster Quickstart

Create a Kubernetes virtual cluster and deploy an example application. Stands up quickly and tears down even faster. Good for quick cluster requirement for your development or ephemeral environment needs.

Prerequisites

Install (opens in a new tab) kubectl.
Install the Uffizzi CLI.
Create a Uffizzi account (opens in a new tab).

Get started

In this quickstart, we'll use the CLI to create a virtual cluster on Uffizzi Cloud, then use kubectl to apply Kubernetes manifests for an example application (opens in a new tab).

Create a cluster

uffizzi cluster create quickstart
# [⠏] Creating cluster quickstart...

This command will also update the current context of your kubeconfig file. This means that you can use kubectl to interact with your virtual cluster.

Clone the example application repo:

git clone https://github.com/UffizziCloud/quickstart.git && \
cd quickstart

This repo includes a web.yaml (opens in a new tab) manifest that includes service, ingress and deployment resources.

Apply the manifest to your cluster:

kubectl apply -f ./k8s
# deployment.apps/web created
# ingress.networking.k8s.io/web created
# service/web created

Get the `ingress` of this deployment:

kubectl get ingress
# NAME   CLASS     HOSTS                                                    ADDRESS   PORTS     AGE
# web    uffizzi   web-default-quickstart-c831.uclusters.app.uffizzi.com              80, 443   13m

You should see a host address that looks something like this:

web-default-quickstart-c831.uclusters.app.uffizzi.com

Or to output just the hostname, run:

kubectl get ingress web --output=jsonpath='{.spec.rules[0].host}{"\n"}'

You can curl this address, or copy and paste it into your browser to see the example application running.

Clean up

To clean up your cluster, simply run:

uffizzi cluster delete quickstart
# Cluster quickstart deleted

Quickstart Dev Clusters