Skip to content

Commit

Permalink
Add further fixes to the Installation page
Browse files Browse the repository at this point in the history
- For Cloud users, specify a `teleport-ent` version.
- Turn the release channel into an environment variable so Cloud users
  can use `stable/cloud`.
- Correct an errant `yum` command in the `zypper` instructions. Also
  trust the repo key.
  • Loading branch information
ptgott committed Mar 26, 2024
1 parent d5e54db commit 03dd48a
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions docs/pages/installation.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -149,6 +149,7 @@ repositories.
```code
$ export TELEPORT_PKG=teleport
$ export TELEPORT_VERSION=v(=teleport.major_version=)
$ export TELEPORT_CHANNEL=stable/${TELEPORT_VERSION?}
```

</TabItem>
Expand All @@ -160,9 +161,10 @@ repositories.
has the same major version as the service that conducts automatic updates:

```code
$ export TELEPORT_PKG="teleport-ent teleport-ent-updater"
$ export TELEPORT_DOMAIN=<Var name="example.teleport.com" />
$ export TELEPORT_VERSION="$(curl https://$TELEPORT_DOMAIN/v1/webapi/automaticupgrades/channel/stable/cloud/version | sed 's/v//')"
$ export TELEPORT_PKG="teleport-ent-${TELEPORT_VERSION?} teleport-ent-updater"
$ export TELEPORT_CHANNEL=stable/cloud
```

</TabItem>
Expand All @@ -171,6 +173,7 @@ repositories.
```code
$ export TELEPORT_PKG=teleport-ent
$ export TELEPORT_VERSION=v(=teleport.major_version=)
$ export TELEPORT_CHANNEL=stable/${TELEPORT_VERSION?}
```

For FedRAMP/FIPS-compliant installations, install the `teleport-ent-fips` package instead:
Expand Down Expand Up @@ -235,7 +238,7 @@ repositories.
# major release of Teleport.
$ echo "deb [signed-by=/usr/share/keyrings/teleport-archive-keyring.asc] \
https://apt.releases.teleport.dev/${ID?} ${VERSION_CODENAME?} \
stable/${TELEPORT_VERSION?}" \
${TELEPORT_CHANNEL?}" \
| sudo tee /etc/apt/sources.list.d/teleport.list > /dev/null
$ sudo apt-get update
Expand All @@ -253,7 +256,7 @@ repositories.
# package version.
$ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+")
$ sudo yum install -y yum-utils
$ sudo yum-config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/${TELEPORT_VERSION?}/teleport.repo")"
$ sudo yum-config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/${TELEPORT_CHANNEL?}/teleport.repo")"
$ sudo yum install ${TELEPORT_PKG?}
#
# Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs)
Expand All @@ -271,8 +274,9 @@ repositories.
# package version.
$ VERSION_ID=$(echo $VERSION_ID | grep -Eo "^[0-9]+")
# Use zypper to add the teleport RPM repo
$ sudo zypper addrepo --refresh --repo $(rpm --eval "https://zypper.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/${TELEPORT_VERSION?}/teleport-zypper.repo")
$ sudo yum install ${TELEPORT_PKG?}
$ sudo zypper addrepo --refresh --repo $(rpm --eval "https://zypper.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/${TELEPORT_CHANNEL?}/teleport-zypper.repo")
$ sudo zypper --gpg-auto-import-keys refresh teleport
$ sudo zypper install ${TELEPORT_PKG?}
#
# Tip: Add /usr/local/bin to path used by sudo (so 'sudo tctl users add' will work as per the docs)
# echo "Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin" > /etc/sudoers.d/secure_path
Expand All @@ -291,7 +295,7 @@ repositories.
# Install dnf config-manager
$ sudo yum install -y yum-utils
# Use the dnf config manager plugin to add the teleport RPM repo
$ sudo dnf config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/stable/${TELEPORT_VERSION?}/teleport.repo")"
$ sudo dnf config-manager --add-repo "$(rpm --eval "https://yum.releases.teleport.dev/$ID/$VERSION_ID/Teleport/%{_arch}/${TELEPORT_CHANNEL?}/teleport.repo")"
# Install teleport
$ sudo dnf install ${TELEPORT_PKG}
Expand Down

0 comments on commit 03dd48a

Please sign in to comment.