You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This article shows you how to configure service update settings in your API Management instance. Azure periodically applies service updates automatically to API Management instances, using a phased rollout approach. These updates include new features, security enhancements, and reliability improvements.
15
+
16
+
This article shows you how to configure *service update* settings in your API Management instance. Azure periodically applies service updates automatically to API Management instances, using a phased rollout approach. These updates include new features, security enhancements, and reliability improvements.
16
17
17
18
You can't control exactly when Azure updates each instance, but API Management lets you select an *update group* for your instance, and also a *maintenance window* during the day when you want your instance to receive updates.
18
19
19
-
***Update group** - A set of instances that receive updates during a production rollout, which can take from several days to several weeks. Choose from:
20
-
***Early** - Receive updates early. Updates might include preview builds.
21
-
***Default** - Receive updates according to the usual phased rollout.
22
-
***Late** - Receive updates later. Updates include the most stable builds.
20
+
***Update group** - A set of instances that receive API Management service updates during a production rollout, which can take from several days to several weeks to complete.
21
+
22
+
Choose from:
23
+
***Early** - Receive updates early in the rollout, for testing and early access to new features. This option is not recommended for production deployments.
24
+
***Default** - Receive updates as part of the regular release rollout. This option is recommended for most services, including production deployments.
25
+
***Late** - Receive updates later than the previous groups, typically weeks after the initial rollout. This option is recommended for mission-critical deployments only.
23
26
24
27
> [!NOTE]
25
28
> Azure deploys all updates using a [safe deployment practices (SDP) framework](https://azure.microsoft.com/blog/advancing-safe-deployment-practices/). Updates released early in a rollout might be less stable and replaced later by stable releases. All instances are eventually updated to the most stable release builds.
26
29
27
-
For example, you might want to add a test instance to the **Early** update group. This instance receives updates before your production instances, which you might put in the **Late** update group. You can monitor the test instance for any issues caused by the updates before they reach your production instances. [Learn more about canary deployments](#canary-deployment-strategies) with API Management
30
+
For example, you might want to add a test instance to the **Early** update group. This instance receives updates before your production instances, which you put in the**Default** or**Late** update group. You can monitor the test instance for any issues caused by the updates before they reach your production instances. [Learn more about canary deployments](#canary-deployment-strategies) with API Management
28
31
29
32
***Maintenance window** - An 8-hour daily period when you want your instance to receive updates. By default, the maintenance window is 10 PM to 6 AM in the instance's timezone.
30
33
31
-
Service disruptions are rare during an update, but you might want to reduce risk by selecting times of low service use. For example, set a maintenance window during weekday evenings and weekend mornings for your production instances.
32
-
34
+
Service disruptions are rare during an update, but you might want to reduce risk by selecting times of low service use. For example, for production instances, set a maintenance window during weekday evenings and weekend mornings.
33
35
34
36
## Configure service update settings
35
37
@@ -53,7 +55,7 @@ Here's how to know about service updates that are expected or are in progress.
53
55
54
56
To receive notifications automatically, [set up an alert](/azure/azure-monitor/alerts/alerts-activity-log) on the Activity log.
55
57
56
-
*Updates roll out to regions in the following phases: Azure EUAP regions, followed by West Central US, followed by remaining regions in several later phases. The sequence of regions updated in the later deployment phases differs from service to service. You can expect at least 24 hours between each phase of the production rollout.
58
+
*By default, updates roll out to regions in the following phases: Azure EUAP regions, followed by West Central US, followed by remaining regions in several later phases. The sequence of regions updated in the later deployment phases differs from service to service. You can expect at least 24 hours between each phase of the production rollout.
57
59
58
60
* Within a region, API Management instances in the Premium tier receive updates several hours later than those in other service tiers.
59
61
@@ -62,9 +64,9 @@ Here's how to know about service updates that are expected or are in progress.
62
64
63
65
## Canary deployment strategies
64
66
65
-
Here are example strategies to use an API Management instance as a canary deployment that receives updates earlier than your production instances.
67
+
You can use an API Management instances assigned to a specific update group or deployed in a specific Azure region as a canary deployment that receives updates earlier than your production instances.
66
68
67
-
***Add instance to Early update group** - Use an API Management instance in the Early update group to validate updates early in the production pipeline. This instance is effectively your canary deployment.
69
+
***Add instance to Early update group** - Use an API Management instance in the Early update group to validate updates early in a production rollout. This instance is effectively your canary deployment.
68
70
69
71
***Deploy in canary region** - If you have access to an Azure EUAP region, use an instance there to validate updates as soon as they're released to the production pipeline. Learn about the [Azure region access request process](/troubleshoot/azure/general/region-access-request-process).
0 commit comments