Skip to content

Commit aeec2e8

Browse files
authored
Phased rollouts (#4390)
1 parent ad4daa7 commit aeec2e8

File tree

1 file changed

+8
-8
lines changed

1 file changed

+8
-8
lines changed

use-timescale/upgrades.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -21,8 +21,7 @@ $CLOUD_LONG has the following upgrade policies:
2121
* **Minor software upgrades**: handled automatically, you do not need to do anything.
2222

2323
Upgrades are performed on your $SERVICE_LONG during a maintenance window that you
24-
[define to suit your workload][define-maintenence-window]. You can also
25-
[manually upgrade $TIMESCALE_DB][minor-manual-upgrade].
24+
[define to suit your workload][define-maintenance-window]. You can also [manually upgrade $TIMESCALE_DB][minor-manual-upgrade].
2625
* **Critical security upgrades**: installed outside normal maintenance windows when necessary, and sometimes require
2726
a short outage.
2827

@@ -40,15 +39,15 @@ After a maintenance upgrade, the DNS name remains the same. However, the IP addr
4039
## Minor software upgrades
4140

4241
If you do not [manually upgrade $TIMESCALE_DB][minor-manual-upgrade] for non-critical upgrades,
43-
$CLOUD_LONG performs upgrades automatically in the next available maintenance window.
42+
$CLOUD_LONG performs upgrades automatically in the next available maintenance window. The upgrade is first applied to your $SERVICE_SHORTs tagged `#dev`, and three weeks later to those tagged `#prod`. [Subscribe][subscribe] to get an email notification before your `#prod` $SERVICE_SHORTs are upgraded. You can upgrade your `#prod` $SERVICE_SHORTs manually sooner, if needed.
4443

4544
Most upgrades that occur during your maintenance windows do not require any downtime. This means that there is no
4645
$SERVICE_SHORT outage during the upgrade. However, all connections and transactions in progress during the upgrade are
4746
reset. Usually, the $SERVICE_SHORT connection is automatically restored after the reset.
4847

4948
Some minor upgrades do require some downtime. This is usually between 30 seconds and 5 minutes. If downtime is required
5049
for an upgrade, $COMPANY endeavors to notify you by email ahead of the upgrade. However, in some cases, we might not be
51-
able to do so. Best practice is to [schedule your maintenance window][define-maintenence-window] so that any downtime
50+
able to do so. Best practice is to [schedule your maintenance window][define-maintenance-window] so that any downtime
5251
disrupts your workloads as little as possible and [minimize downtime with replicas][minimize-downtime]. If there are no
5352
pending upgrades available during a regular maintenance window, no changes are performed.
5453

@@ -222,9 +221,10 @@ To change your maintenance window:
222221
[timescale-relnotes]: https://github.com/timescale/timescaledb/releases
223222
[deprecation-window]: /use-timescale/:currentVersion:/upgrades/#deprecations
224223
[minimize-downtime]: /use-timescale/:currentVersion:/upgrades/#minimize-downtime-with-replicas
225-
[minor-manual-upgrade]: /use-timescale/:currentVersion:/upgrades/#manually-upgrade-timescaledb-for-non-critical-updates
226-
[manual-upgrade]: /use-timescale/:currentVersion:/upgrades/#manually-upgrade-postgresql-for-a-service
227-
[automatic-upgrade]: /use-timescale/:currentVersion:/upgrades/#automatic-postgresql-upgrades-for-a-service
228-
[define-maintenence-window]: /use-timescale/:currentVersion:/upgrades/#define-your-maintenance-window
224+
[minor-manual-upgrade]: /use-timescale/:currentVersion:/upgrades/#manually-upgrade-timescaledb-for-non-critical-upgrades
225+
[manual-upgrade]: /use-timescale/:currentVersion:/upgrades/#manually-upgrade-postgres-for-a-service
226+
[automatic-upgrade]: /use-timescale/:currentVersion:/upgrades/#automatic-postgres-upgrades-for-a-service
227+
[define-maintenance-window]: /use-timescale/:currentVersion:/upgrades/#define-your-maintenance-window
229228
[hareplica]: /use-timescale/:currentVersion:/ha-replicas/high-availability/
230229
[readreplica]: /use-timescale/:currentVersion:/ha-replicas/read-scaling/
230+
[subscribe]: https://status.timescale.com/

0 commit comments

Comments
 (0)