Skip to content

Commit

Permalink
docs: fix typos, add docker socket info
Browse files Browse the repository at this point in the history
Adjust docker docs.

Signed-off-by: Steve Francis <steve.francis@talos-systems.com>
Signed-off-by: Andrey Smirnov <andrey.smirnov@siderolabs.com>
  • Loading branch information
steverfrancis authored and smira committed May 15, 2024
1 parent 6663068 commit 43939f1
Show file tree
Hide file tree
Showing 2 changed files with 14 additions and 7 deletions.
4 changes: 3 additions & 1 deletion website/content/v1.8/introduction/quickstart.md
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,9 @@ talosctl cluster create
```

{{% alert title="Note" color="info" %}}
If you are using Docker Desktop on a macOS computer you will need to enable the default Docker socket in your settings.
If you are using Docker Desktop on a macOS computer, if you encounter the error: *Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?* you may need to manually create the link for the Docker socket:
```sudo ln -s "$HOME/.docker/run/docker.sock" /var/run/docker.sock```

{{% /alert %}}

You can explore using Talos API commands:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -6,17 +6,22 @@ aliases:
---

In this guide we will create a Kubernetes cluster in Docker, using a containerized version of Talos.

Running Talos in Docker is intended to be used in CI pipelines, and local testing when you need a quick and easy cluster.
Furthermore, if you are running Talos in production, it provides an excellent way for developers to develop against the same version of Talos.
It also provides an excellent way for developers to develop against the same version of Talos as is used in production.

## Requirements

The follow are requirements for running Talos in Docker:
The follow are the requirements for running Talos in Docker:

- Docker 18.03 or greater
- a recent version of [`talosctl`](https://github.com/siderolabs/talos/releases)

{{% alert title="Note" color="info" %}}
If you are using Docker Desktop on a macOS computer, and you encounter the error: *Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?* you may need to manually create the link for the Docker socket:
```sudo ln -s "$HOME/.docker/run/docker.sock" /var/run/docker.sock```

{{% /alert %}}

## Caveats

Due to the fact that Talos will be running in a container, certain APIs are not available.
Expand All @@ -31,11 +36,11 @@ Creating a local cluster is as simple as:
talosctl cluster create
```

Once the above finishes successfully, your `talosconfig` (`~/.talos/config`) and `kubeconfig` (`~/.kube/config`) will be configured to point to the new cluster.
Once the above finishes, your `talosconfig` (`~/.talos/config`) and `kubeconfig` (`~/.kube/config`) will be configured to point to the new cluster.

> Note: Startup times can take up to a minute or more before the cluster is available.
Finally, we just need to specify which nodes you want to communicate with using talosctl.
Finally, we just need to specify which nodes you want to communicate with using `talosctl`.
Talosctl can operate on one or all the nodes in the cluster – this makes cluster wide commands much easier.

`talosctl config nodes 10.5.0.2 10.5.0.3`
Expand All @@ -44,7 +49,7 @@ Talos and Kubernetes API are mapped to a random port on the host machine, the re
Talos API endpoint can be found using `talosctl config info`:

```bash
$ talosctcl config info
$ talosctl config info
...
Endpoints: 127.0.0.1:38423
```
Expand Down

0 comments on commit 43939f1

Please sign in to comment.