mirror of
https://github.com/siderolabs/talos.git
synced 2025-08-15 02:57:17 +02:00
964e4405c3
The search bar was taking too much space in the header. This moves it to the sidebar. The search query now filters based on the current version of docs. Signed-off-by: Andrew Rynhard <andrew@rynhard.io>
47 lines
1.2 KiB
Markdown
47 lines
1.2 KiB
Markdown
---
|
|
title: Quickstart
|
|
weight: 2
|
|
---
|
|
|
|
The easiest way to try Talos is by using the CLI (`talosctl`) to create a cluster on a machine with `docker` installed.
|
|
|
|
## Prerequisites
|
|
|
|
### `talosctl`
|
|
|
|
Download `talosctl`:
|
|
|
|
```bash
|
|
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
|
|
```
|
|
|
|
### `kubectl`
|
|
|
|
Download `kubectl` via one of methods outlined in the [documentation](https://kubernetes.io/docs/tasks/tools/install-kubectl/).
|
|
|
|
## Create the Cluster
|
|
|
|
Now run the following:
|
|
|
|
```bash
|
|
talosctl cluster create
|
|
```
|
|
|
|
Verify that you can reach Kubernetes:
|
|
|
|
```bash
|
|
$ 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.19.3 10.5.0.2 <none> Talos (v0.7.0) <host kernel> containerd://1.4.1
|
|
talos-default-worker-1 Ready <none> 115s v1.19.3 10.5.0.3 <none> Talos (v0.7.0) <host kernel> containerd://1.4.1
|
|
```
|
|
|
|
## Destroy the Cluster
|
|
|
|
When you are all done, remove the cluster:
|
|
|
|
```bash
|
|
talosctl cluster destroy
|
|
```
|