Skip to content

Commit

Permalink
[v14] docs: cloud faq update on versions (#43539)
Browse files Browse the repository at this point in the history
* docs: cloud faq update on versions

* docs: cloud faq update question

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>

* docs: update verbiage for cloud faq updates on versions

* doc: verbiage updates to cloud faq update on versions

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>

* docs: update verbiage for cloud faq version updates

* docs: update verbiage

Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>

---------

Co-authored-by: Zac Bergquist <zac.bergquist@goteleport.com>
Co-authored-by: Steven Martin <stevenmartin@Stevens-MBP.fios-router.home>
Co-authored-by: Paul Gottschling <paul.gottschling@goteleport.com>
  • Loading branch information
4 people committed Jun 26, 2024
1 parent fa9e3be commit eac7f08
Showing 1 changed file with 28 additions and 24 deletions.
52 changes: 28 additions & 24 deletions docs/pages/choose-an-edition/teleport-cloud/faq.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -142,7 +142,7 @@ The ability to download recordings for offline viewing will be available in a fu

### Will Teleport be updated automatically?

The Teleport Auth Service and Teleport Proxy Service for Teleport Enterprise Cloud
The Teleport Auth Service and Teleport Proxy Service for managed Teleport Enterprise clusters
are automatically kept up to date with patches and minor releases following the release schedule
described in [Teleport Upcoming Releases](../../upcoming-releases.mdx).

Expand All @@ -151,19 +151,33 @@ described in [Teleport Upcoming Releases](../../upcoming-releases.mdx).
- Minor updates and patches typically occur between one day and a week after a release.
- Teleport Auth Service and Teleport Proxy Service updates are pushed to Teleport cloud accounts
during your scheduled maintenance window.
- Teleport agents are only updated automatically if you enroll them in automatic updates.
- The Teleport Auth Service and Proxy Service will not be automatically upgraded to the next
major version with Teleport Agents on older major versions.
- Teleport Agents are only updated automatically if you enroll them in automatic updates.

If you have Teleport agents connected to a Teleport Enterprise Cloud cluster
If you have Teleport Agents connected to a managed Teleport Enterprise cluster
that are more than one major version behind, you might experience compatibility
issues unless your agents are enrolled in automatic updates. See the [Upgrading
issues unless your Teleport Agents are enrolled in automatic updates. See the [Upgrading
Overview](../../upgrading/overview.mdx) for more information.

To get version information for your agents, see [How can I find version information on
To get version information for your Teleport Agents, see [How can I find version information on
connected agents?](#how-can-i-find-version-information-on-connected-agents).

For more information about automatic updates and compatibility issues, contact
[Teleport support](https://goteleport.com/support/).

### Why wasn't my managed Teleport Enterprise cluster upgraded to the latest major version?

The Teleport control plane supports Teleport Agents that are on the same major version or one major version behind.
If your Teleport Agents are not up to date, we will withhold major version upgrades in order to prevent connectivity
issues to your resources. For example, if your control plane is currently running Teleport 15 and you have Teleport Agents
running Teleport 14, we will not be able to upgrade your control plane to Teleport 16 until all Teleport Agents are
running Teleport 15.

You can check the status of your Teleport Agent versions from the `tctl inventory ls` command. `Auth` and `Proxy`
services are those managed by Teleport. See [How can I find version information on
connected agents?](#how-can-i-find-version-information-on-connected-agents) for further detail.

### Are updates times configurable for Teleport Enterprise Cloud?

Yes, Teleport provides a scheduled maintenance time window for updates and you can set
Expand Down Expand Up @@ -201,26 +215,16 @@ period. For more information, read one of the following guides:

### How can I find version information on connected agents?

To find the version of Teleport agent is attached to your cluster, run the
following commands for the different protocols we support.

```code
$ tctl get nodes --format=text
$ tctl get kube_server --format=text
$ tctl get app_server --format=text
$ tctl get db_server --format=text
$ tctl get windows_desktop_service --format=text
```
You can check the status of your agents' version from the `tctl inventory ls` command. `Auth` and `Proxy`
services are those managed by Teleport.

Below you can see sample output of `tctl get nodes --format=text`. Note the
`Version` column will contain the version of the attached agent.

```code
$ tctl get nodes --format=text
Host UUID Public Address Labels Version
-------- ------------------------------------ -------------- ------ ----------
server01 46d8cad0-8967-4815-a01a-77aae62c34fe (=teleport.version=)
server02 c33b5513-a9eb-463b-8f1b-1f209afe5b4f (=teleport.version=)
```bash
tctl inventory ls
Server ID Hostname Services Agent Version Upgrader Upgrader Version
------------------------------------ --------------------- --------------- ------------- -------- ----------------
065ab336-1ac2-4314-8b16-32fc06a172a7 example-1 Node,App v(=cloud.version=) unit v(=cloud.version=)
065ab336-1ac2-4314-8b16-f00uj04004db example-2 Node,Db v(=cloud.version=) unit v(=cloud.version=)
3de21e67-845a-4be1-a024-908829718d27 teleport-kube-0 Kube v(=cloud.version=) kube v(=cloud.version=)
```

## Architecture and networking
Expand Down

0 comments on commit eac7f08

Please sign in to comment.