Skip to content

Mark RFD 63 as implemented, update details #11721

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ravicious merged 3 commits into from
Apr 7, 2022
Merged

Mark RFD 63 as implemented, update details #11721

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
418fa1a
Mark RFD 63 as implemented, update details
ravicious Apr 5, 2022
e289906
Merge branch 'master' into ravicious/mark-rfd-63-as-implemented
ravicious Apr 5, 2022
8de96df
Merge branch 'master' into ravicious/mark-rfd-63-as-implemented
ravicious Apr 7, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 6 additions & 5 deletions rfd/0063-teleport-terminal.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
authors: Alexey Kontsevoy (alexey@goteleport.com)
state: draft
state: implemented
---

# RFD 0063 - Teleport Terminal
Expand All @@ -24,12 +24,13 @@ Electron has been chosen because of cross-platform support and an ability to reu
1. Built-in fully featured terminal based on [xterm](https://xtermjs.org/) and [node-pty](https://github.com/microsoft/node-pty) to fork processes.
2. Tabbed layout where a tab can be an ssh session, rdp connection, or any other document.
3. Ability to add and access multiple Teleport clusters at the same time.
4. Command Palette for quick access and navigation.
4. Connection Tracker for quick access and navigation.
4. Command Bar for quick command execution.

### tsh daemon
`tsh daemon` is a `tsh` tool that runs as a service. A hidden flag launches `tsh` in a background process that exposes gRPC API over unix-socket (similarly to docker daemon).
`tsh daemon` is a `tsh` tool that runs as a service. A hidden command launches `tsh` in a background process that exposes gRPC API over unix-socket (similarly to docker daemon).
This API is used by `teleterm` to call `tsh` internal methods to access Teleport clusters.
This makes `tsh` as `teleterm` backend service that stores information about clusters and retrieved certificates.
This makes `tsh` a backend service for `teleterm` that stores information about clusters and retrieved certificates.

#### gRPC API
`tsh` gRPC API allows programmatic access to `tsh` functionality. This includes logging into a cluster, k8s, and creating a local proxy (alpn).
Expand All @@ -54,7 +55,7 @@ UI will ensure that general [security recommendations](https://www.electronjs.or

## Packaging and installation
`teleterm` uses [Electron-Builder](https://github.com/electron-userland/electron-builder) that handles creation of packages for multiple platforms. `tsh` is packaged together with the
rest of the application and installed into the "app data" folder. After an installation, `teleterm` prompts a dialog asking a user to optionally register `tsh` and `teleterm` globally via symlinks.
rest of the application and installed into the "app data" folder.

Electron supports automatic updates. The updates happens via a publicly exposed service that Electron trusts. This service can be hosted by the
cloud team. This functionality currently is not implemented.
Expand Down