f59620473e
- add 0.5 docs branched from 0.4 - add intro page and "get help" pages - moved Docker and Firecracker into a "Local Clusters" category - switch to markdown-it from markd for consistency between corp site and docs site - use markdown-it-anchor to create linkable anchors to sections within a page - improve urls to use / instead of # for docs pages (WARNING: this breaks old links) - continue to simplify handling in the Content.vue component - update JS deps Signed-off-by: Timothy Gerla <tim@gerla.net>
1.5 KiB
title
| title |
|---|
| Docker |
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.
Requirements
The follow are requirements for running Talos in Docker:
- Docker 18.03 or greater
- a recent version of
talosctl
Create the Cluster
Creating a local cluster is as simple as:
talosctl cluster create --wait
Once the above finishes successfully, your talosconfig(~/.talos/config) will be configured to point to the new cluster.
Note: Startup times can take up to a minute before the cluster is available.
Retrieve and Configure the kubeconfig
talosctl kubeconfig .
kubectl --kubeconfig kubeconfig config set-cluster talos_default --server https://127.0.0.1:6443
Using the Cluster
Once the cluster is available, you can make use of talosctl and kubectl to interact with the cluster.
For example, to view current running containers, run talosctl containers for a list of containers in the system namespace, or talosctl containers -k for the k8s.io namespace.
To view the logs of a container, use talosctl logs <container> or talosctl logs -k <container>.
Cleaning Up
To cleanup, run:
talosctl cluster destroy