Update docs for new APT repos (#12959)

* Updated docs for new APT repos

* Added upgrade notes

* Reworded upgrade details

* Update docs/pages/includes/install-linux.mdx

Co-authored-by: Roman Tkachenko <roman@goteleport.com>

* Added APT "legacy" docs

* Bumped major version

Co-authored-by: Roman Tkachenko <roman@goteleport.com>
This commit is contained in:
fheinecke 2022-07-13 13:28:31 -05:00 committed by GitHub
parent 6c02a4efd9
commit a82e241b16
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
3 changed files with 41 additions and 2 deletions

View file

@ -988,6 +988,7 @@
"min_version": "3.6"
},
"teleport": {
"major_version": "11",
"version": "9.0.4",
"golang": "1.17",
"plugin": {

View file

@ -5,8 +5,15 @@
# Download Teleport's PGP public key
$ sudo curl https://deb.releases.teleport.dev/teleport-pubkey.asc \
-o /usr/share/keyrings/teleport-archive-keyring.asc
# Add the Teleport APT repository
$ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] https://deb.releases.teleport.dev/ stable main" \
# Source variables about OS version
$ source /etc/os-release
# Add the Teleport APT repository for v(=teleport.major_version=). You'll need to update this
# file for each major release of Teleport.
# Note: if using a fork of Debian or Ubuntu you may need to use '$ID_LIKE'
# and the codename your distro was forked from instead of '$ID' and '$VERSION_CODENAME'.
# Supported versions are listed here: https://github.com/gravitational/teleport/blob/master/build.assets/tooling/cmd/build-apt-repos/main.go#L26
$ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] \
https://apt.releases.teleport.dev/${ID?} ${VERSION_CODENAME?} stable/v(=teleport.major_version=)" \
| sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null
$ sudo apt-get update
@ -63,6 +70,23 @@
```
</TabItem>
<TabItem label="Debian/Ubuntu Legacy (DEB)">
```code
# Using this APT repo may result in breaking upgrades upon "apt upgrade" as all major versions will be
# published under the same component. We recommend following the instructions in the
# "Debian/Ubuntu (DEB)" tab instead.
# Download Teleport's PGP public key
$ sudo curl https://deb.releases.teleport.dev/teleport-pubkey.asc \
-o /usr/share/keyrings/teleport-archive-keyring.asc
# Add the Teleport APT repository
$ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] https://deb.releases.teleport.dev/ stable main" \
| sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null
$ sudo apt-get update
$ sudo apt-get install teleport
```
</TabItem>
</Tabs>
</ScopedBlock>
<ScopedBlock scope={["enterprise"]}>

View file

@ -40,6 +40,20 @@ All installations include `teleport`, `tsh`, `tctl`, and `tbot`.
(!docs/pages/includes/install-linux.mdx!)
<Details
title="Using APT for versions prior to Teleport 10?"
scopeOnly={false}
>
If you've previously installed Teleport via the APT
repo at `https://deb.releases.teleport.dev/`, you can upgrade by
re-running the "Debian/Ubuntu (DEB)" install instructions above.
We will also continue to maintain the legacy APT repo at
`https://deb.releases.teleport.dev/` for the foreseeable future.
</Details>
<ScopedBlock scope="oss">
Check the [Downloads](https://goteleport.com/download/) page for the most