Skip to content

Commit e33d9d0

Browse files
authored
Merge pull request #313438 from lisalozano/azure-managed-redis-articles
[AQ] edit pass: Azure Managed Redis articles
2 parents 9add381 + 7b33db1 commit e33d9d0

2 files changed

Lines changed: 75 additions & 74 deletions

File tree

articles/redis/how-to-upgrade.md

Lines changed: 29 additions & 38 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
2-
title: How to upgrade the Redis version of Azure Managed Redis
3-
description: Learn how to upgrade the version of Azure Managed Redis.
2+
title: Upgrade Your Redis Version in Azure Managed Redis
3+
description: Learn how to upgrade your Redis version in Azure Managed Redis.
44
ms.date: 05/18/2025
55
ms.topic: how-to
66
ms.custom:
@@ -10,77 +10,68 @@ appliesto:
1010
- ✅ Azure Managed Redis
1111
---
1212

13-
# How to upgrade the version of your Azure Managed Redis instance
13+
# Upgrade the Redis version of your Azure Managed Redis instance
1414

15-
New versions of Redis server software are frequently released with new features, more commands, and stability improvements. Maintaining Redis instances using the latest version of Redis is a good way to ensure that you get the best possible Redis experience.
15+
New versions of Redis server software are frequently released with new features, more commands, and stability improvements. By maintaining your Azure Managed Redis instance with the latest version of Redis, you can ensure the best possible experience.
1616

17-
This article details how to upgrade your Redis instance to the latest version of Redis available in Azure Managed Redis.
17+
This article details how to upgrade your Redis instance in Azure Managed Redis to the latest available version.
1818

1919
> [!IMPORTANT]
20-
> Following the [standard Redis versioning](https://redis.io/about/releases/), this article only covers upgrades to the _major_ version of Redis, not the _minor_ or _patch_ versions. Updates to the minor and patch versions are made automatically during the normal patching cycle each month.
20+
> Following [standard Redis versioning](https://redis.io/about/releases/), this article only covers upgrades to the _major_ version of Redis, not the _minor_ or _patch_ versions. Updates to the minor and patch versions are made automatically during the normal patching cycle each month.
2121
>
2222
2323
### Current versions
2424

25-
This table contains the information for which Redis version are available in each tier.
25+
These Redis versions are available for each tier.
2626

2727
| Tier | Available Redis version |
2828
|:------------------------------------------------- |:------------------------------------:|
29-
| Memory Optimized, Balanced, Compute Optimized | Redis 7.4 (Preview) |
29+
| Memory Optimized, Balanced, Compute Optimized | Redis 7.4 |
3030
| Flash Optimized | Redis 7.4 (preview) |
3131

32-
## How to upgrade
32+
## Upgrade options
3333

34-
You have two options for upgrades: automatic and manual. Automatic upgrades are part of the standard patching process. With the manual process, you can start upgrades that are available outside the normal automatic process.
34+
You can choose from automatic or manual upgrades. Automatic upgrades are part of the standard patching process. With the manual process, you can start upgrades that are available outside the normal automatic process.
3535

36-
### Automatic upgrade
36+
### Automatic upgrades
3737

38-
Redis server version upgrades are made automatically as a part of the standard monthly patching process. Upgrades to the latest version of Redis occur once that Redis version reaches general availability (GA) on Azure.
38+
Redis server version upgrades are made automatically as a part of the standard monthly patching process. Upgrades to the latest version of Redis occur when that Redis version reaches general availability (GA) on Azure.
3939

40-
At GA of a new version, your Redis instance is automatically upgraded to the new GA version unless you defer it before general availability. For more information on deferring an upgrade, see [Defer Upgrades](#defer-upgrades).
40+
When a new version becomes generally available, your Redis instance is automatically upgraded to the new version unless you defer it ahead of time. For more information on deferring an upgrade, see [Defer upgrades](#defer-upgrades) in this article.
4141

42-
### Start an upgrade manually
42+
### Manual upgrades
4343

44-
As an alternative to automatic upgrade, you can also manually upgrade to the latest Redis version. Manual upgrades provide two other benefits instead waiting for the automatic upgrade to occur: a) You control when the upgrade occurs, and b) you can upgrade to preview releases of Redis server.
44+
You can also choose to manually upgrade to the latest Redis version. Manual upgrades provide two benefits:
4545

46-
1. In the portal, navigate to the **Overview** of the cache using the Resource menu. Then, choose **Upgrade** in the working pane to start an upgrade.
46+
- You control when the upgrade occurs.
47+
- You can upgrade to preview releases of Redis.
4748

48-
:::image type="content" source="media/how-to-upgrade/managed-redis-upgrade-overview.png" alt-text="Screenshot showing the upgrade pane, the current version, and the available version." :::
49+
> [!WARNING]
50+
> After you upgrade your Redis instance, you can't downgrade it to the previous version.
4951
50-
1. You then see an **Upgrade Redis** pane that shows you the current Redis version, and any version that you can upgrade to. As noted in the pane, upgrading is irreversible. You can't downgrade. To confirm and begin the upgrade process, select **Start Upgrade**.
52+
1. In the portal, use the **Resource** menu to go to **Overview**. Select **Upgrade**.
5153

52-
> [!WARNING]
53-
> Once your Redis instance has been upgraded, it cannot be downgraded to the previous version.
54-
>
55-
56-
:::image type="content" source="media/how-to-upgrade/managed-redis-upgrade-pane.png" alt-text="Screenshot showing overview selected in the resource menu and pane titled Upgrade Redis.":::
57-
58-
If you're already running the latest version of Redis software available, the **Upgrade** button is disabled.
54+
1. An **Upgrading Redis** pane displays the current Redis version and the versions that you can upgrade to. To confirm and begin the upgrade process, select **Start upgrade**. (If you're already running the latest available version of Redis software, the **Start upgrade** button is unavailable.)
5955

6056
### Defer upgrades
6157

62-
You can defer an automatic upgrade of a new version of Redis software by as many as 90 days. This option gives you time to test new versions and ensure that everything works as expected. The cache is then upgraded either 90 days after the new Redis version reaches GA, or whenever you trigger the upgrade manually.
63-
64-
The deferral option must be selected before a new Redis version reaches GA for it to take effect before the automatic upgrade occurs.
58+
You can defer an automatic upgrade of a new version of Redis software for up to 90 days. This option gives you time to test new versions and ensure that everything works as expected. The cache is upgraded either 90 days after the new Redis version reaches GA, or whenever you manually trigger the upgrade.
6559

66-
To defer upgrades to your cache, navigate to the **Advanced Settings** on the Resource menu, and select the **Defer Redis DB version updates** box.
60+
To prevent an automatic upgrade, select the deferral option before a new Redis version reaches GA.
6761

68-
:::image type="content" source="media/how-to-upgrade/managed-redis-defer-upgrade.png" alt-text="Screenshot showing Advanced settings selected in the Resource menu and a red box around Defer Redis DB version updates.":::
62+
Go to **Advanced settings** on the **Resource** menu, and select the box for **Defer Redis DB version updates**.
6963

7064
> [!IMPORTANT]
71-
> Selecting the option to defer upgrades only applies to the next automatic upgrade event. Caches that have already been upgraded cannot be downgraded using the defer option.
72-
>
65+
> When you select the option to defer upgrades, your selection only applies to the next automatic upgrade event. You can't use the defer button to downgrade caches that were already upgraded.
7366
74-
## Considerations before upgrading Redis versions
67+
## Pre-upgrade considerations
7568

76-
Each new Redis version is intended to be a seamless upgrade from previous versions with backwards-compatibility as a design principle. However, small changes and bug fixes do occur which can cause application changes. Being conscious of these changes is always a good idea.
69+
Each new Redis version is intended to be a seamless upgrade from previous versions with backward compatibility as a design principle. However, small changes and bug fixes do occur, which can cause application changes. You should keep these changes in mind.
7770

7871
### Client version
7972

80-
If you're using an outdated Redis client, new commands or Redis features can't be supported properly. We always recommend updating to the latest stable version of your Redis client, as newer versions often have stability and performance improvements as well. For more information on configuring your client library, see [best practices using client libraries](best-practices-client-libraries.md).
73+
When you use an outdated Redis client, new commands or Redis features aren't properly supported. We always recommend that you update to the latest stable version of your Redis client, because newer versions often have stability and performance improvements. For more information on configuring your client library, see [Best practices using client libraries](best-practices-client-libraries.md).
8174

8275
### Breaking changes
8376

84-
Each version of Redis often has a few minor bug fixes that can present breaking changes. If you have concerns, we recommend reviewing the Redis 7.4 release notes before upgrading your Redis version:
85-
86-
- [Redis 7.4 release notes](https://raw.githubusercontent.com/redis/redis/7.4/00-RELEASENOTES)
77+
Each version of Redis often has a few minor bug fixes that can present breaking changes. If you have concerns, we recommend reviewing the [Redis 7.4 release notes](https://raw.githubusercontent.com/redis/redis/7.4/00-RELEASENOTES) before you upgrade your Redis version.

0 commit comments

Comments
 (0)