diff --git a/docs/access/teleport/client-installation.md b/docs/access/teleport/client-installation.md index 0b801aa..68bdad3 100644 --- a/docs/access/teleport/client-installation.md +++ b/docs/access/teleport/client-installation.md @@ -16,6 +16,7 @@ Teleport Connect is a desktop application that allows you to connect to a Telepo ## TSH Client + The TSH Client is a command line tool that allows you to connect to a Teleport cluster and access resources. It is available for Linux, macOS, and Windows. It includes the following commands: @@ -23,11 +24,10 @@ It includes the following commands: - `tsh login` - log in to a Teleport cluster - `tsh ssh` - connect to a node or a cluster - `tsh db` - connect to a database + - `tsh kube` - connect to a Kubernetes cluster - `tsh status` - show the status of the Teleport cluster -!!! info "Make sure to select `tsh client` from the dropdown menu" +[Install instructinos TSH Client :fontawesome-solid-download:](https://goteleport.com/docs/connect-your-client/tsh/#installing-tsh){ .md-button } + -
- ![Teleport](../../assets/images/teleport_tsh_download.png) -
diff --git a/docs/access/teleport/k8s-client.md b/docs/access/teleport/k8s-client.md index 9105e17..fb02488 100644 --- a/docs/access/teleport/k8s-client.md +++ b/docs/access/teleport/k8s-client.md @@ -1,14 +1,15 @@ # Accessing Kubernetes Clusters using the Teleport Connect Client -You can use the Teleport Connect client to access Kubernetes clusters. +You can use the Teleport Connect client or the `tsh` binary to access Kubernetes clusters. ## Prerequisites -- Teleport Connect Client installed on your local machine. See [Installing Teleport Connect Client](/access/teleport/client-installation/) for instructions. +- Teleport Connect Client or TSH Client installed on your local machine. See [Installing Teleport Client](/access/teleport/client-installation/) for instructions. - Kubectl installed on your local machine. See [Installing kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl) for instructions. +- You must be in a Teleport Role that allows access to Kubernetes clusters. +## Accessing a Kubernetes Cluster using Teleport Connect -## Accessing a Kubernetes Cluster Launch the Teleport Connect Client and sign in with your account. Choose the register `Kubes` and select `Connect` to connect to the Kubernetes cluster. @@ -19,4 +20,22 @@ A new terminal window will open with the `kubectl` context set to the Kubernetes Now you can run `kubectl` commands to access the Kubernetes cluster. -![Teleport Connect K8s](../../assets/images/teleport_connect_k8s_terminal.png) \ No newline at end of file +![Teleport Connect K8s](../../assets/images/teleport_connect_k8s_terminal.png) + +## Accessing Kubernetes Clusters using tsh + +You can use the Teleport CLI `tsh` to access Kubernetes clusters directly in your terminal. + +```bash +TELEPORT_URL=teleport.example.com +TELEPORT_USER=your-teleport-user + +# Login to the Teleport cluster +tsh login --proxy=$TELEPORT_URL --auth=local --user=$TELEPORT_USER $TELEPORT_URL + +# Print available Kubernetes clusters +tsh kube ls + +# Connect to a Kubernetes cluster +tsh kube login +``` diff --git a/docs/access/teleport/k8s-openlens.md b/docs/access/teleport/k8s-openlens.md index b2d625d..c6fd630 100644 --- a/docs/access/teleport/k8s-openlens.md +++ b/docs/access/teleport/k8s-openlens.md @@ -9,6 +9,7 @@ You can use the Teleport Connect client to access Kubernetes clusters with OpenL - OpenLens installed on your local machine. See [OpenLens Releases](https://github.com/MuhammedKalkan/OpenLens/releases) for download. ## Configuring OpenLens to use Teleport Connect + Launch the Teleport Connect Client and sign in with your account. Choose the register `Kubes` and select `Connect` to connect to the Kubernetes cluster. diff --git a/docs/assets/images/teleport_tsh_download.png b/docs/assets/images/teleport_tsh_download.png deleted file mode 100644 index 26fd8f0..0000000 Binary files a/docs/assets/images/teleport_tsh_download.png and /dev/null differ