|
1 | 1 | --- |
2 | 2 | title: 'Quickstart: Create a Redis Enterprise cache' |
3 | | -description: In this quickstart, learn how to create an instance of Azure Cache for Redis in use the Enterprise tier. |
| 3 | +description: Learn how to create an instance of Azure Cache for Redis Enterprise. |
4 | 4 | ms.custom: mvc, mode-other, ignite-2024 |
5 | 5 | ms.topic: quickstart |
6 | | -ms.date: 04/12/2023 |
| 6 | +ms.date: 04/23/2025 |
7 | 7 | appliesto: |
8 | 8 | - ✅ Azure Cache for Redis |
9 | 9 | #Customer intent: As a Redis Enterprise developer who is new to Azure Cache for Redis, I want to create a new cache in the Enterprise tier of Azure Cache for Redis. |
10 | 10 | --- |
11 | 11 |
|
12 | 12 | # Quickstart: Create a Redis Enterprise cache |
13 | 13 |
|
14 | | -The Azure Cache for Redis Enterprise tiers provide fully integrated and managed [Redis Enterprise](https://redislabs.com/redis-enterprise/) on Azure. These tiers are: |
| 14 | +The Azure Cache for Redis Enterprise tiers provide fully integrated and managed [Redis Enterprise](https://redislabs.com/redis-enterprise/) on Azure. The Enterprise tiers are: |
15 | 15 |
|
16 | | -- Enterprise, which uses volatile memory (DRAM) on a virtual machine to store data |
| 16 | +- Enterprise, which uses volatile memory (DRAM) on a virtual machine to store data. |
17 | 17 | - Enterprise Flash, which uses both volatile and nonvolatile memory (NVMe or SSD) to store data. |
18 | 18 |
|
19 | | -Both Enterprise and Enterprise Flash support open-source Redis 6 and some new features that aren't yet available in the Basic, Standard, or Premium tiers. The supported features include some Redis modules that enable other features like search, bloom filters, and time series. |
| 19 | +Both Enterprise and Enterprise Flash tiers support open-source Redis 6 and some new features that aren't available in Basic, Standard, or Premium tiers. The supported features include Redis modules that enable search, bloom filters, and time series. |
20 | 20 |
|
21 | 21 | ## Prerequisites |
22 | 22 |
|
23 | | -- You need an Azure subscription before you begin. If you don't have one, create an [account](https://azure.microsoft.com/). For more information, see [special considerations for Enterprise tiers](cache-overview.md#special-considerations-for-enterprise-tiers). |
| 23 | +- You need an Azure subscription before you begin. If you don't have one, create an [account](https://azure.microsoft.com/). For more information, see [Special considerations for Enterprise tiers](cache-overview.md#special-considerations-for-enterprise-tiers). |
24 | 24 |
|
25 | 25 | ### Availability by region |
26 | 26 |
|
27 | 27 | Azure Cache for Redis is continually expanding into new regions. To check the availability by region for all tiers, see [Products available by region](https://azure.microsoft.com/global-infrastructure/services/?products=redis-cache®ions=all). |
28 | 28 |
|
29 | | -## Create a cache |
| 29 | +## Create an Enterprise cache |
30 | 30 |
|
31 | | -1. To create a cache, sign in to the Azure portal and select **Create a resource**. |
| 31 | +1. In the [Azure portal](https://portal.azure.com), search for and select **Azure Cache for Redis**. |
| 32 | +1. On the **Azure Cache for Redis** page, select **Create** > **Redis Enterprise**. |
32 | 33 |
|
33 | | -1. On the **New** page, select **Databases** and then select **Azure Cache for Redis**. |
| 34 | + :::image type="content" source="media/cache-create/cache-create-enterprise.png" alt-text="Screenshot showing how to select Redis Enterprise in Azure Redis Cache Create."::: |
34 | 35 |
|
35 | | - :::image type="content" source="media/cache-create/new-cache-menu.png" alt-text="Screenshot showing how to select Azure Cache for Redis."::: |
| 36 | +1. On the **Basics** tab of the **New Redis Cache** page, configure the following settings: |
36 | 37 |
|
37 | | -1. On the **New Redis Cache** page, configure the settings for your new cache. |
| 38 | + - **Subscription**: Select the subscription to use. |
| 39 | + - **Resource group**: Select a resource group, or select **Create new** and enter a new resource group name. Putting all your app resources in the same resource group lets you easily manage or delete them together. |
| 40 | + - **Name**: Enter a cache name that's unique in the region. The name must: |
| 41 | + - Be a string of 1 to 63 characters when combined with the cache's region name. |
| 42 | + - Contain only numbers, letters, and hyphens. |
| 43 | + - Start and end with a number or letter. |
| 44 | + - Not contain consecutive hyphens. |
| 45 | + - **Region**: Select an [Azure region](https://azure.microsoft.com/regions/) near other services that use your cache. Enterprise tiers are available in selected Azure regions. |
| 46 | + - **Cache SKU**: Select **Enterprise** or **Enterprise Flash** SKU to determine the available sizes, performance, and features for your cache. |
| 47 | + - **Cache size**: Select a cache size. |
38 | 48 |
|
39 | | - | Setting | Choose a value | Description | |
40 | | - | ------------ | ------- | -------------------------------------------------- | |
41 | | - | **Subscription** | Drop down and select your subscription. | The subscription under which to create this new Azure Cache for Redis instance. | |
42 | | - | **Resource group** | Drop down and select a resource group, or select **Create new** and enter a new resource group name. | Name for the resource group in which to create your cache and other resources. By putting all your app resources in one resource group, you can easily manage or delete them together. | |
43 | | - | **DNS name** | Enter a name that is unique in the region. | The cache name must be a string between 1 and 63 characters when _combined with the cache's region name_ that contain only numbers, letters, or hyphens. (If the cache name is fewer than 45 characters long it should work in all currently available regions.) The name must start and end with a number or letter, and can't contain consecutive hyphens. Your cache instance's _host name_ is `\<DNS name\>.\<Azure region\>.redisenterprise.cache.azure.net`. | |
44 | | - | **Location** | Drop down and select a location. | Enterprise tiers are available in selected Azure regions. | |
45 | | - | **Cache type** | Drop down and select an _Enterprise_ or _Enterprise Flash_ tier and a size. | The tier determines the size, performance, and features that are available for the cache. | |
| 49 | +1. Select the **Terms** checkbox. |
46 | 50 |
|
47 | 51 | :::image type="content" source="media/cache-create/enterprise-tier-basics.png" alt-text="Screenshot showing the Enterprise tier Basics tab."::: |
48 | 52 |
|
49 | | - > [!IMPORTANT] |
50 | | - > Be sure to select **Terms** before you proceed. |
51 | | - > |
52 | | -
|
53 | | -1. Select **Next: Networking** and skip. |
54 | | - |
55 | | -1. Select **Next: Advanced**. |
56 | | - |
57 | | - Enable **Non-TLS access only** if you plan to connect to the new cache without using TLS. Disabling TLS is **not** recommended, however. |
58 | | - |
59 | | - Set **Clustering policy** to **Enterprise** for a nonclustered cache, or to **OSS** for a clustered cache. For more information on choosing **Clustering policy**, see [Clustering](../redis/architecture.md#clustering). |
60 | | - |
61 | | - :::image type="content" source="media/cache-create/cache-clustering-policy.png" alt-text="Screenshot that shows the Enterprise tier Advanced tab."::: |
62 | | - |
63 | | - > [!NOTE] |
64 | | - > Enterprise and Enterprise Flash tiers are inherently clustered, in contrast to the Basic, Standard, and Premium tiers. Redis Enterprise supports two clustering policies. |
65 | | - >- Use the **Enterprise** policy to access your cache using the Redis API. |
66 | | - >- Use **OSS** to use the OSS Cluster API.. |
67 | | - > |
| 53 | +1. Select the **Networking** tab, or select **Next: Networking**. |
| 54 | +1. On the **Networking** tab, select a connectivity method to use for the cache. **Private Endpoint** is recommended for security. If you select **Private Endpoint**, select **Add private endpoint** and create the private endpoint. |
| 55 | +1. Select the **Advanced** tab, or select **Next: Advanced**. |
| 56 | +1. On the **Advanced** tab, configure the following options: |
| 57 | + - **Modules**: Select the Redis modules you want to use. |
| 58 | + - **Zone redundancy**: Select whether to enable zone redundancy (recommended). |
| 59 | + - **Non-TLS access only**: Choose whether to **Enable** the non-TLS port and connect to the new cache without using TLS. However, disabling TLS isn't recommended. |
| 60 | + - **Eviction policy**: Select an eviction policy. |
| 61 | + - **Capacity**: Set the total number of virtual machines running for the cache. |
| 62 | + - **Clustering Policy**: Set to **Enterprise** to use the Redis API, or to **OSS** to use the OSS Cluster API. |
| 63 | +1. Under **(PREVIEW) Data Persistence**, choose whether to enable **Redis Database (RDB)**, **Append-only file (AOF)**, or no data persistence for your cache. |
| 64 | +1. Under **Active geo-replication**, if your SKU supports it, select **Configure** to configure active-active geo-replication for your cache. |
| 65 | +1. Under **Customer-managed key encryption at rest**, choose whether to use your own key to encrypt the disk's data. Otherwise, Microsoft-managed keys are used. |
| 66 | + |
| 67 | + :::image type="content" source="media/cache-create/cache-clustering-policy.png" alt-text="Screenshot that shows the Enterprise tier Advanced tab."::: |
68 | 68 |
|
69 | 69 | > [!IMPORTANT] |
70 | | - > You can't change the clustering policy of an Enterprise cache instance after you create it. If you're using [RediSearch](../redis/redis-modules.md#redisearch), the Enterprise cluster policy is required, and `NoEviction` is the only eviction policy supported. |
| 70 | + > You must enable modules at the time you create the Azure Redis instance. You can't change modules or enable module configuration after you create a cache. |
71 | 71 | > |
72 | 72 |
|
73 | 73 | > [!IMPORTANT] |
74 | | - > If you're using this cache instance in a geo-replication group, eviction policies cannot be changed after the instance is created. Be sure to know the eviction policies of your primary nodes before you create the cache. For more information on active geo-replication, see [Active geo-replication prerequisites](cache-how-to-active-geo-replication.md#active-geo-replication-prerequisites). |
75 | | - > |
76 | | - |
77 | | - > [!IMPORTANT] |
78 | | - > You can't change modules after you create a cache instance. Modules must be enabled at the time you create an Azure Cache for Redis instance. There is no option to enable the configuration of a module after you create a cache. |
79 | | - > |
| 74 | + > If you're using the [RediSearch](../redis/redis-modules.md#redisearch) module, the **Enterprise** cluster policy is required, and **No Eviction** is the only eviction policy supported. |
80 | 75 |
|
81 | | -1. Select **Next: Tags** and skip. |
| 76 | + > [!IMPORTANT] |
| 77 | + > Azure Redis Enterprise and Enterprise Flash tiers are inherently clustered, in contrast to Basic, Standard, and Premium tiers. Redis Enterprise supports two clustering policies, **Enterprise** and **OSS**. Use **Enterprise** to access your cache using the Redis API, or **OSS** to use the OSS Cluster API. You can't change the clustering policy of an Enterprise cache after you create it. For more information, see [Clustering](../redis/architecture.md#clustering). |
82 | 78 |
|
83 | | -1. Select **Next: Review + create**. |
| 79 | + > [!IMPORTANT] |
| 80 | + > If you're using this cache in a geo-replication group, you can't change eviction policies after the cache is created. Be sure to know the eviction policies of your primary nodes before you create the cache. For more information on active geo-replication, see [Active geo-replication prerequisites](cache-how-to-active-geo-replication.md#active-geo-replication-prerequisites). |
84 | 81 |
|
85 | | - :::image type="content" source="media/cache-create/enterprise-tier-summary.png" alt-text="Screenshot showing the Enterprise tier Review + Create tab."::: |
| 82 | +1. Optionally, select the **Tags** tab or select **Next: Tags**, and enter tag names and values if you want to categorize your cache resources. |
86 | 83 |
|
87 | | -1. Review the settings and select **Create**. |
| 84 | +1. Select **Review + create**, and once validation passes, select **Create**. |
88 | 85 |
|
89 | | - It takes some time for the cache to create. You can monitor progress on the Azure Cache for Redis **Overview** page. When **Status** shows as **Running**, the cache is ready to use. |
| 86 | +It takes some time for the cache to create. You can monitor deployment progress in the Azure **Notifications** pane. When the deployment completes, select **Go to resource**. On the cache **Overview** page, when **Status** displays **Running**, the cache is ready to use. |
90 | 87 |
|
91 | 88 | ## Related content |
92 | 89 |
|
93 | | -In this quickstart, you learned how to create an Enterprise tier instance of Azure Cache for Redis. |
| 90 | +- [Create an Azure Managed Redis instance (preview)](../redis/quickstart-create-managed-redis.md) |
| 91 | +- [Create an ASP.NET web app that uses Azure Cache for Redis.](../redis/web-app-cache-howto.md) |
94 | 92 |
|
95 | | -- [Create an ASP.NET web app that uses an Azure Cache for Redis](../redis/web-app-aspnet-core-howto.md) |
0 commit comments