Skip to content
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

Backport ""Update docs for new APT repos"" (#12959) into branch/v10 #14591

Merged
merged 2 commits into from
Jul 19, 2022
Merged

Backport ""Update docs for new APT repos"" (#12959) into branch/v10 #14591

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
0e90cd0
Updated docs for new APT repos
fheinecke Jul 18, 2022
89ae0f8
Merge branch 'branch/v10' into fred/new-apt-repo-docs-backport-branch…
fheinecke Jul 19, 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
1 change: 1 addition & 0 deletions docs/config.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -948,6 +948,7 @@
"min_version": "3.6"
},
"teleport": {
"major_version": "10",
"version": "10.0.0",
"golang": "1.18",
"plugin": {
Expand Down
28 changes: 26 additions & 2 deletions docs/pages/includes/install-linux.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 (breaking) 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
Expand Down Expand Up @@ -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"]}>
Expand Down
14 changes: 14 additions & 0 deletions docs/pages/installation.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down