https://github.com/highb/asdf-teleport-ent
Teleport Enterprise CLI Version Management
https://github.com/highb/asdf-teleport-ent
Last synced: 8 months ago
JSON representation
Teleport Enterprise CLI Version Management
- Host: GitHub
- URL: https://github.com/highb/asdf-teleport-ent
- Owner: highb
- License: apache-2.0
- Created: 2022-03-15T21:22:06.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2024-10-20T21:57:35.000Z (over 1 year ago)
- Last Synced: 2025-02-02T16:11:12.566Z (over 1 year ago)
- Language: Shell
- Size: 63.5 KB
- Stars: 6
- Watchers: 2
- Forks: 8
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: contributing.md
- License: LICENSE
Awesome Lists containing this project
README
# asdf-teleport-ent [](https://github.com/highb/asdf-teleport-ent/actions/workflows/build.yml) [](https://github.com/highb/asdf-teleport-ent/actions/workflows/lint.yml)
[teleport-ent](https://goteleport.com/docs/server-access/guides/tsh/) plugin for the [asdf version manager](https://asdf-vm.com) and [mise](https://mise.jdx.dev/).
# Contents
- [Dependencies](#dependencies)
- [Install](#install)
- [Why?](#why)
- [Contributing](#contributing)
- [License](#license)
# Dependencies
- `bash`, `curl`, `tar`: generic POSIX utilities.
- `SOME_ENV_VAR`: set this environment variable in your shell config to load the correct version of tool x.
# Install
## With asdf
Plugin:
```shell
asdf plugin add teleport-ent
# or
asdf plugin add teleport-ent https://github.com/highb/asdf-teleport-ent.git
```
teleport-ent:
```shell
# Show all installable versions
asdf list all teleport-ent
# Install latest version
asdf install teleport-ent latest
# Install specific version
asdf install teleport-ent 14.2.2
# Set a version globally (on your ~/.tool-versions file)
asdf set -u teleport-ent latest
# Set a version locally for the current directory and all sub-directories
# This will also create a .tool-versions file which can be checked in to source control.
asdf set teleport-ent 14.2.2
# Now teleport-ent commands are available
tsh version
tctl version
teleport version
```
## With mise
Plugin:
```shell
mise plugin install teleport-ent
# or
mise plugin install teleport-ent https://github.com/highb/asdf-teleport-ent.git
```
teleport-ent:
```shell
# Show all installable versions
mise ls-remote teleport-ent
# Install latest version
mise install teleport-ent@latest
# Install specific version
mise install teleport-ent@14.2.2
# Set a version globally (on your ~/.tool-versions file)
mise global teleport-ent@latest
# Set a version locally for the current directory and all sub-directories
# This will also create a .tool-versions file which can be checked in to source control.
mise local teleport-ent@14.2.2
# Set a version for the current shell
mise shell teleport-ent@14.2.2
# Now teleport-ent commands are available
tsh version
tctl version
teleport version
```
Check [asdf](https://github.com/asdf-vm/asdf) or [mise](https://mise.jdx.dev/) documentation for more instructions on how to install & manage versions.
# Why?
When testing out version upgrades on Teleport, I frequently found myself jumping between
tsh/tctl versions and decided that I didn't want to manage a bunch of symlinks manually
so I made an asdf plugin. This plugin works with both asdf and mise version managers.
*I do not work for Gravitational* so this does not come with any support guarantees, but
please feel free to open a PR if you find a version that you need is missing or you need
some functionality added.
# Contributing
Contributions of any kind welcome! See the [contributing guide](contributing.md).
[Thanks goes to these contributors](https://github.com/highb/asdf-teleport-ent/graphs/contributors)!
# License
See [LICENSE](LICENSE) © [Brandon High](https://github.com/highb/)