talos/website/content/docs/v0.14/Introduction/quickstart.md
Spencer Smith 9b0b5501dd
docs: add katacoda link
This PR adds the katacoda tutorial to our quickstart

Signed-off-by: Spencer Smith <spencer.smith@talos-systems.com>
2022-02-23 20:18:40 -05:00

2.0 KiB

title weight
Quickstart 2

There are two easy ways to try out Talos Linux. Instructions for each are detailed below.

Katacoda Sandbox

First, you can explore a sandbox environment hosted on Katacoda. This approach has the benefit of having no prerequisites and being a bit more guided, so you can quickly learn how to interact with a cluster.

Please visit Katacoda here to try it out.

Local Docker Cluster

Another easy way to try Talos is by using the CLI (talosctl) to create a cluster on a machine with docker installed.

Prerequisites

talosctl

Download talosctl:

amd64
curl -Lo /usr/local/bin/talosctl https://github.com/talos-systems/talos/releases/latest/download/talosctl-$(uname -s | tr "[:upper:]" "[:lower:]")-amd64
chmod +x /usr/local/bin/talosctl
arm64

For linux and darwin operating systems talosctl is also available for the arm64 processor architecture.

curl -Lo /usr/local/bin/talosctl https://github.com/talos-systems/talos/releases/latest/download/talosctl-$(uname -s | tr "[:upper:]" "[:lower:]")-arm64
chmod +x /usr/local/bin/talosctl

kubectl

Download kubectl via one of methods outlined in the documentation.

Create the Cluster

Now run the following:

talosctl cluster create

Verify that you can reach Kubernetes:

$ kubectl get nodes -o wide
NAME                     STATUS   ROLES    AGE    VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE         KERNEL-VERSION   CONTAINER-RUNTIME
talos-default-master-1   Ready    master   115s   v1.20.2   10.5.0.2      <none>        Talos (v0.14.0)   <host kernel>    containerd://1.5.5
talos-default-worker-1   Ready    <none>   115s   v1.20.2   10.5.0.3      <none>        Talos (v0.14.0)   <host kernel>    containerd://1.5.5

Destroy the Cluster

When you are all done, remove the cluster:

talosctl cluster destroy