[>] About
How to use
1. Creating a cluster
Navigate to the cluster creation page. There, create a
cluster with a name and TLS-SAN. The cluster name is,
unsurprisingly, required. For those not too knowledgeable
about Kubernetes, the TLS-SAN field is if you want to add a
custom URL to access your cluster. A default URL will be
generated as k-clustername.kraftcloud.dev with all the DNS
entries needed for you to access your newly made cluster.
1.1 Using your own URL
This segment is only relevant if you populated the TLS-SAN
field with a custom URL. In order to finish configuring your
custom entrypoint, you need to go to the cluster details
page, and grab the randomly generated URL. Then create a
CNAME record for your domain, pointing to mine.
1.2 Using your cluster
It will take a few minutes for the cluster to be created,
initialise, and be ready for use. Tragically I do not have a
status field to tell you about what stage the cluster is in.
However, after waiting maybe 2 minutes, you can try
downloading your kubeconfig file from the cluster management
page. This kubeconfig file gives you the credentials and
configuration needed to interact with your cluster. The
server field is set to example-endpoint.kraftcloud.dev by
default, but you can replace it by your own domain if
configured.
2. Getting Kubectl
Everything you do on your cluster will involve kubectl, a
command line tool which communicates with the kubernetes API
server. Kubectl is the only item you need to install
locally, and you can refer to the guide
here.
Once you have kubectl installed (verified by `kubectl
version` in the terminal), you need to make sure it can get
your kubeconfig file. This is done by setting the KUBECONFIG
environment variable to the absolute path of the downloaded
file (eg: /home/alex/Downloads/kubeconfig-dl.yaml).
Alternatively you can move the file to ~/.kube/config which
kubectl checks by default anyways. Refer to the above guide
for non-Linux systems.
2.1 Working with Workspaces
A feature in open beta right now is workspaces. A workspace
is a container with all the tools you could want to work
with, including but not limited to: kubectl, kubecolor,
kubectl completion, fish, and k9s. You can load into a
workspace from the cluster view page. You have to extend the
cluster view and will find a button to load it.
The workspace will load you into a terminal on a new tab. It
might take a second for it to load, and if you have a cursor
visible but no terminal prompt, you can try pressing enter
or ctrl+c to get your prompt back. Note that there is a
timeout on inactivity and if it passes, you will have to
load the workspace again from the KRaft page.