Skip to content

Commit cb61037

Browse files
authored
docs: Update regarding update channels (#9394)
1 parent 6c8564f commit cb61037

File tree

2 files changed

+21
-9
lines changed

2 files changed

+21
-9
lines changed

docs/pages/product/deployment/cloud/deployments.mdx

Lines changed: 19 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -96,19 +96,29 @@ navigating to <Btn>Overview → Resources & Logs → Cube API</Btn>:
9696

9797
Cube Cloud provides two update channels:
9898

99-
* **Stable channel.** You should manually update the deployment to one of
100-
available stable versions.
101-
* **Latest channel.** On each build, the deployment is automatically updated
102-
to the most up-to-date version of Cube.
99+
* <Btn>LTS channel</Btn> for infrequent [long-term support][ref-lts] releases with
100+
critical fixes.
101+
* <Btn>Regular channel</Btn> for regular releases, which occur more frequently and
102+
contain both fixes and new features.
103103

104104
You can view or change the update channel by navigating to <Btn>Settings →
105105
General → Cube version</Btn>:
106106

107107
<Screenshot
108-
src="https://ucarecdn.com/b6ddfc8f-ee37-4b75-8108-ba12c020a9f6/"
109-
highlight="inset(53.75% 42.5% 11.25% 20% round 10px)"
108+
src="https://ucarecdn.com/3ef5fa36-4b27-437c-aa70-dbc0aa01255d/"
109+
highlight="inset(36% 41% 34% 21% round 10px)"
110110
/>
111111

112+
There's an option to <Btn>Upgrade automatically to new patch versions</Btn>, which is
113+
available for both update channels. When it's turned on, an upgrade will occur if a new
114+
[patch version][link-semver] is available in the selected channel. To trigger an upgrade,
115+
deploy a new build to the [production environment][ref-environments-prod] or change its
116+
settings, e.g., by updating environment variables of the Cube Cloud deployment.
117+
118+
Generally, it's recommended to use the _regular channel_ to get the latest updates.
119+
You can _pin the version_ to a specific one by turning the <Btn>Upgrade automatically...</Btn>
120+
toggle off.
121+
112122
## Resource consumption
113123

114124
Cube Cloud deployments only consume resources when they are needed to run workloads:
@@ -139,4 +149,6 @@ resource consumption in different scenarios.
139149
[ref-data-model]: /product/workspace/data-model
140150
[ref-playground]: /product/workspace/playground
141151
[ref-environments]: /product/workspace/environments
142-
[ref-environments-prod]: /product/workspace/environments#production-environment
152+
[ref-environments-prod]: /product/workspace/environments#production-environment
153+
[ref-lts]: /product/distribution#long-term-support
154+
[link-semver]: https://semver.org

docs/pages/product/distribution.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,8 @@ Usually, there are also deprecation notices in the documentation that look simil
6161

6262
</WarningBox>
6363

64-
Additionally, Cube Cloud provides [update channels][ref-update-channels] where
65-
versions are marked as either <Btn>Stable</Btn> or <Btn>Latest</Btn>.
64+
Additionally, Cube Cloud provides <Btn>LTS</Btn> or <Btn>Regular</Btn> [update
65+
channels][ref-update-channels].
6666

6767
### Long-term support
6868

0 commit comments

Comments
 (0)