Skip to content

Commit 0a146e3

Browse files
committedOct 8, 2021
update redis version doc
1 parent 3466071 commit 0a146e3

File tree

6 files changed

+44
-129
lines changed

6 files changed

+44
-129
lines changed
 

‎articles/azure-cache-for-redis/cache-how-to-version.md

Lines changed: 44 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,28 +1,24 @@
11
---
2-
title: Set Redis version for Azure Cache for Redis (Preview)
2+
title: Set Redis version for Azure Cache for Redis
33
description: Learn how to configure Redis version
44
author: curib
55
ms.author: cauribeg
66
ms.service: cache
77
ms.topic: conceptual
8-
ms.date: 09/30/2020
8+
ms.date: 10/07/2021
99
---
1010

11-
# Set Redis version for Azure Cache for Redis (Preview)
11+
# Set Redis version for Azure Cache for Redis
1212
In this article, you'll learn how to configure the Redis software version to be used with your cache instance. Azure Cache for Redis offers the latest major version of Redis and at least one previous version. It will update these versions regularly as newer Redis software is released. You can choose between the two available versions. Keep in mind that your cache will be upgraded to the next version automatically if the version it's using currently is no longer supported.
1313

1414
> [!NOTE]
15-
> Redis 6 is currently in preview. At this time, Redis 6 does not support clustering, zone redundancy, ACL, PowerShell, Azure CLI, Terraform, and geo-replication between a Redis 4.0 and 6.0 cache. The Redis version also cannot be changed once a cache is created.
16-
>
17-
18-
> [!IMPORTANT]
19-
> Once Redis 6.0 is generally available (GA), Redis 6.0 will be the default Redis version for new caches. You will still have the option to create Redis 4.0 caches.
15+
> At this time, Redis 6 does not support ACL.
2016
>
2117
2218
## Prerequisites
2319
* Azure subscription - [create one for free](https://azure.microsoft.com/free/)
2420

25-
## Create a cache
21+
## Create a cache using the Azure portal
2622
To create a cache, follow these steps:
2723

2824
1. Sign in to the [Azure portal](https://portal.azure.com) and select **Create a resource**.
@@ -53,15 +49,52 @@ To create a cache, follow these steps:
5349
> At this time, the Redis version can't be changed once a cache is created.
5450
>
5551
52+
## Create a cache using Azure PowerShell
53+
54+
```azurepowershell
55+
New-AzRedisCache -ResourceGroupName "ResourceGroupName" -Name "CacheName" -Location "West US 2" -Size 250MB -Sku "Standard" -RedisVersion "6"
56+
```
57+
For more information on how to manage Azure Cache for Redis with Azure PowerShell, see [here](cache-how-to-manage-redis-cache-powershell.md)
58+
59+
## Create a cache using Azure CLI
60+
61+
```azurecli-interactive
62+
az redis create --resource-group resourceGroupName --name cacheName --location westus2 --sku Standard --vm-size c0 --redisVersion="6"
63+
```
64+
For more information on how to manage Azure Cache for Redis with Azure CLI, see [here](cli-samples.md)
65+
66+
## Upgrade an existing Redis 4 cache to Redis 6
67+
Azure Cache for Redis supports upgrading your Redis cache server major version from Redis 4 to Redis 6. Please note that upgrading is permanent and it may cause a brief connection blip. To upgrade your cache, follow these steps:
68+
69+
1. In the Azure portal, search for **Azure Cache for Redis**. Then, press enter or select it from the search suggestions.
70+
71+
:::image type="content" source="media/cache-private-link/4-search-for-cache.png" alt-text="Search for Azure Cache for Redis.":::
72+
73+
1. Select the cache instance you want to upgrade from Redis 4 to Redis 6.
74+
75+
1. On the left side of the screen, select **Advanced setting**.
76+
77+
1. If your cache instance is eligible to be upgraded, you should see the following blue banner. If you wish to proceed, select the text in the banner.
78+
79+
:::image type="content" source="media/cache-how-to-version/blue-banner-upgrade-cache.png" alt-text="Blue banner that says you can upgrade your Redis 6 cache with additional features and commands that enhance developer productivity and ease of use. Upgrading your cache instance cannot be reversed.":::
80+
81+
1. A dialog box will then popup notifying you that upgrading is permanent and may cause a brief connection blip. Select yes if you would like to upgrade your cache instance.
82+
83+
:::image type="content" source="media/cache-how-to-version/dialog-version-upgrade.png" alt-text="Dialog with more information about upgrading your cache.":::
84+
85+
1. To check on the status of the upgrade, navigate to **Overview**.
86+
87+
:::image type="content" source="media/cache-how-to-version/upgrade-status.png" alt-text="Overview shows status of cache being upgraded.":::
88+
5689
## FAQ
5790

5891
### What features aren't supported with Redis 6?
5992

60-
Currently, Redis 6 does not support clustering, zone redundancy, ACL, PowerShell, Azure CLI, Terraform, and geo-replication between a Redis 4.0 and 6.0 cache.
93+
At this time, Redis 6 does not support ACL.
6194

6295
### Can I change the version of my cache after it's created?
6396

64-
Currently, you cannot change the version of your cache once it's created.
97+
You can upgrade your existing Redis 4 caches to Redis 6, please see [here](#upgrade-an-existing-redis-4-cache-to-redis-6) for details. Please note upgrading your cache instance is permanent and you cannot downgrade your Redis 6 caches to Redis 4 caches.
6598

6699
## Next Steps
67100
Learn more about Azure Cache for Redis features.

‎articles/azure-cache-for-redis/cache-moving-resources.md

Lines changed: 0 additions & 118 deletions
This file was deleted.
Loading
Loading
Loading
Loading

0 commit comments

Comments
 (0)
Please sign in to comment.