Skip to content

Commit 16e8a36

Browse files
committed
edits
1 parent a5ad560 commit 16e8a36

File tree

2 files changed

+32
-33
lines changed

2 files changed

+32
-33
lines changed

articles/spring-apps/how-to-configure-enterprise-spring-cloud-gateway.md

Lines changed: 21 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -387,36 +387,35 @@ az spring gateway restart \
387387

388388
---
389389

390-
### Set up Autoscale settings for VMware Spring Cloud Gateway in Azure CLI
390+
### Set up autoscale settings for VMware Spring Cloud Gateway in Azure CLI
391391

392-
You can set Autoscale modes using the Azure CLI. The following commands create an Autoscale setting and an Autoscale rule.
392+
You can set autoscale modes using the Azure CLI. The following commands create an autoscale setting and an autoscale rule.
393393

394-
* Create Autoscale setting:
394+
- Use the following command to create an autoscale setting:
395395

396-
```azurecli
397-
az monitor autoscale create \
398-
--resource-group <resource-group-name> \
399-
--name <autoscale-setting-name> \
400-
--resource /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.AppPlatform/Spring/<service-instance-name>/gateways/default \
401-
--min-count 1 \
402-
--max-count 5 \
403-
--count 1
404-
```
396+
```azurecli
397+
az monitor autoscale create \
398+
--resource-group <resource-group-name> \
399+
--name <autoscale-setting-name> \
400+
--resource /subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/Microsoft.AppPlatform/Spring/<service-instance-name>/gateways/default \
401+
--min-count 1 \
402+
--max-count 5 \
403+
--count 1
404+
```
405405

406-
* Create Autoscale rule:
406+
- Use the following command to create an autoscale rule:
407407

408-
```azurecli
409-
az monitor autoscale rule create \
410-
--resource-group <resource-group-name> \
411-
--autoscale-name <autoscale-setting-name> \
412-
--scale out 1 \
413-
--cooldown 1 \
414-
--condition "GatewayHttpServerRequestsSecondsCount > 100 avg 1m"
415-
```
408+
```azurecli
409+
az monitor autoscale rule create \
410+
--resource-group <resource-group-name> \
411+
--autoscale-name <autoscale-setting-name> \
412+
--scale out 1 \
413+
--cooldown 1 \
414+
--condition "GatewayHttpServerRequestsSecondsCount > 100 avg 1m"
415+
```
416416

417417
For information on the available metrics, see the [User metrics options](./concept-metrics.md#user-metrics-options) section of [Metrics for Azure Spring Apps](./concept-metrics.md).
418418

419-
420419
---
421420

422421
## Configure environment variables

articles/spring-apps/how-to-enterprise-deploy-app-at-scale.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,18 +1,18 @@
11
---
2-
title: A Guide to Deploying Over 500 and Up To 1000 Application Instances Using Azure Spring Apps Enterprise
2+
title: Scale out to deploy over 500 and up to 1000 application instances using Azure Spring Apps Enterprise
33
description: Learn how to deploy applications at scale in the Enterprise plan for Azure Spring Apps and learn about the restrictions.
44
author: karlerickson
55
ms.author: xiading
66
ms.service: spring-apps
77
ms.topic: how-to
8-
ms.date: 06/26/2023
8+
ms.date: 07/05/2023
99
---
1010

11-
# Scaling Out: A Guide to Deploying Over 500 and Up To 1000 Application Instances Using Azure Spring Apps Enterprise
11+
# Scale out to deploy over 500 and up to 1000 application instances using Azure Spring Apps Enterprise
1212

1313
This article applies to ❌ Basic/Standard ✔️ Enterprise
1414

15-
This article guides you on deploying up to 1000 application instances in Azure Spring Apps Enterprise. The feature supporting deployment of more than 500 instances is currently in Preview. It outlines the limitations during the Preview stage. The Enterprise plan, crafted for handling substantial production workloads, supports a maximum of 1000 application instances per service. However, it is advisable to stick to a maximum of 500 instances in your production environment.
15+
This article guides you on deploying up to 1000 application instances in Azure Spring Apps Enterprise. The feature supporting deployment of more than 500 instances is currently in Preview. This article outlines the limitations during the Preview stage. The Enterprise plan, crafted for handling substantial production workloads, supports a maximum of 1000 application instances per service. However, we recommend using a maximum of 500 instances in your production environment.
1616

1717
## Definition
1818

@@ -22,29 +22,29 @@ The Azure Spring Apps Enterprise plan supports up to 1000 application instances
2222

2323
When you deploy Azure Spring Apps in an Azure virtual network, you need to configure the proper subnet ranges for your apps and services. The subnet ranges determine how many IP addresses are available for your apps and services to use. If the subnet ranges are too small, you might run out of IP addresses and encounter errors or failures.
2424

25-
To avoid this problem, you should preserve subnet ranges that be large enough to support the number of application instances. For subnets, Azure reserves five IP addresses, and Azure Spring Apps requires at least three IP addresses. We recommend that you preserve at least the `/24` subnet ranges for the apps subnet.
25+
To avoid this problem, you should reserve subnet ranges that are large enough to support the number of application instances. For subnets, Azure reserves five IP addresses, and Azure Spring Apps requires at least three IP addresses. We recommend that you reserve at least the `/24` subnet ranges for the apps subnet.
2626

27-
For more detail about how deploy an Azure Spring Apps instance in your virtual network, follow the instructions in [Deploy Azure Spring Apps in a virtual network](how-to-deploy-in-azure-virtual-network.md).
27+
For more information about how deploy an Azure Spring Apps instance in your virtual network, see [Deploy Azure Spring Apps in a virtual network](how-to-deploy-in-azure-virtual-network.md).
2828

2929
## Restrictions
3030

3131
Support for 1000 app instances is currently in the preview stage. The following sections describe the restrictions that you should understand when you try this feature.
3232

3333
### VMware Tanzu® Build Service™
3434

35-
VMware Tanzu Build Service automates container creation, management, and governance at enterprise scale. Tanzu Build Service uses the buildpacks project to turn application source code into container images.
35+
VMware Tanzu Build Service automates container creation, management, and governance at enterprise scale. Tanzu Build Service uses the buildpacks project to turn application source code into container images.
3636

3737
The builder is a Tanzu Build Service resource, which contains a set of buildpacks and a stack used in the process of building source code. The build number using the same builder should be less than 200. Otherwise, it's hard to reconcile all builds when the builder updates.
3838

3939
The builds are generated when you deploy apps. We recommend that you create multiple customized builders to deploy apps when you have more than 200 apps or deployments.
4040

4141
### Application Configuration Service for Tanzu
4242

43-
Application Configuration Service for Tanzu is a central place to manage external properties for applications across all environments. This service is offered in two versions: Gen1 and Gen2. The Gen1 version mainly serves existing customers for backward compatibility purpose. Gen2 uses flux as the back end to communicate with Git repositories. Gen2 provides better performance compared with Gen1.
43+
Application Configuration Service for Tanzu is a central place to manage external properties for applications across all environments. This service is offered in two versions: Gen1 and Gen2. The Gen1 version mainly serves existing customers for backward compatibility purpose. Gen2 uses flux as the back end to communicate with Git repositories. Gen2 provides better performance compared to Gen1.
4444

4545
The following table shows the benchmark for refresh times under different numbers of patterns. Be sure to carefully control the configuration pattern number based on these values to avoid unacceptable refresh performance.
4646

47-
| Application Configuration Service Generation | Duration to refresh under 100 patterns | Duration to refresh under 250 patterns | Duration to refresh under 500 patterns |
47+
| Application Configuration Service generation | Duration to refresh under 100 patterns | Duration to refresh under 250 patterns | Duration to refresh under 500 patterns |
4848
|----------------------------------------------|----------------------------------------|----------------------------------------|----------------------------------------|
4949
| Gen1 | 330s | 840s | 1500s |
5050
| Gen2 | 13s | 100s | 378s |
@@ -53,9 +53,9 @@ The following table shows the benchmark for refresh times under different number
5353

5454
Spring Cloud Gateway for VMware Tanzu handles the cross-cutting concerns for API development teams, such as single sign-on (SSO), access control, rate-limiting, resiliency, security, and more. You can accelerate API delivery using modern cloud native patterns using your choice of programming language for API development. Spring Cloud Gateway is a critical component for a microservices architecture.
5555

56-
The performance of the gateway is closely related to the number of routes. In general, we recommend that you don't exceed 500 routes. When the gateway can't handle some requests with reasonably low latency or without errors, it can stress a gateway instance's performance.
56+
The performance of the gateway is closely related to the number of routes. In general, we recommend that you don't exceed 500 routes. When the gateway can't handle some requests with reasonably low latency or without errors, it can stress a gateway instance's performance.
5757

58-
Spring Cloud Gateway is able to handle a high volume of traffic. To support the traffic, you should consider increasing the memory requested for API gateway instances so that each pod can handle more requests per second. You can also refer to [Set up Autoscale settings for VMware Spring Cloud Gateway](how-to-configure-enterprise-spring-cloud-gateway.md#set-up-autoscale-settings-for-vmware-spring-cloud-gateway-in-azure-cli) to configure auto scale rules for the gateway to perform its best when demand changes.
58+
Spring Cloud Gateway is able to handle a high volume of traffic. To support the traffic, you should consider increasing the memory requested for API gateway instances so that each pod can handle more requests per second. To configure autoscale rules for the gateway to perform best when demand changes, see the [Set up autoscale settings for VMware Spring Cloud Gateway](how-to-configure-enterprise-spring-cloud-gateway.md#set-up-autoscale-settings-for-vmware-spring-cloud-gateway-in-azure-cli) section in [Configure VMware Spring Cloud Gateway](how-to-configure-enterprise-spring-cloud-gateway.md).
5959

6060
Spring Cloud Gateway supports rolling restarts to ensure zero downtime and disruption. However, the current version of the gateway has a limitation that when it's rolling restarted, it may take longer to synchronize a large number of routes. This situation can cause incomplete route updates during the process. We're actively working on fixing this limitation and will provide an update through our documentation.
6161

0 commit comments

Comments
 (0)