Skip to content

Commit e2afdf1

Browse files
authored
Merge pull request #290460 from MicrosoftDocs/release-asa-file-moves
Merge release-asa-file-moves into main
2 parents 5c920ae + 6a3ef32 commit e2afdf1

File tree

549 files changed

+2836
-2374
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

549 files changed

+2836
-2374
lines changed

articles/spring-apps/.openpublishing.redirection.spring-apps.json

Lines changed: 520 additions & 58 deletions
Large diffs are not rendered by default.
File renamed without changes.

articles/spring-apps/basic-standard/application-observability.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ To find out if your applications meet expectations and to discover and predict i
3030

3131
This article uses the well-known [PetClinic](https://github.com/azure-samples/spring-petclinic-microservices) sample app as the production application. For more information on how to deploy PetClinic to Azure Spring Apps and use MySQL as the persistent store, see the following articles:
3232

33-
- [Deploy microservice applications to Azure Spring Apps](../enterprise/quickstart-deploy-microservice-apps.md?pivots=sc-standard&toc=/azure/spring-apps/basic-standard/toc.json&bc=/azure/spring-apps/basic-standard/breadcrumb/toc.json)
33+
- [Deploy microservice applications to Azure Spring Apps](quickstart-deploy-microservice-apps.md?pivots=sc-standard)
3434
- [Integrate Azure Spring Apps with Azure Database for MySQL](quickstart-integrate-azure-database-mysql.md)
3535

3636
Log Analytics and Application Insights are deeply integrated with Azure Spring Apps. You can use Log Analytics to diagnose your application with various log queries and use Application Insights to investigate production issues. For more information, see the following articles:
@@ -148,10 +148,10 @@ To use Application Insights to investigate the performance issues, use the follo
148148
## Next steps
149149

150150
> [!div class="nextstepaction"]
151-
> [Set up a staging environment](../enterprise/how-to-staging-environment.md)
151+
> [Set up a staging environment](how-to-staging-environment.md)
152152
153153
> [!div class="nextstepaction"]
154-
> [Map an existing custom domain to Azure Spring Apps](../enterprise/how-to-custom-domain.md?toc=/azure/spring-apps/basic-standard/toc.json&bc=/azure/spring-apps/basic-standard/breadcrumb/toc.json)
154+
> [Map an existing custom domain to Azure Spring Apps](how-to-custom-domain.md)
155155
156156
> [!div class="nextstepaction"]
157-
> [Use TLS/SSL certificates](../enterprise/how-to-use-tls-certificate.md?toc=/azure/spring-apps/basic-standard/toc.json&bc=/azure/spring-apps/basic-standard/breadcrumb/toc.json)
157+
> [Use TLS/SSL certificates](how-to-use-tls-certificate.md)
Lines changed: 72 additions & 72 deletions
Original file line numberDiff line numberDiff line change
@@ -1,72 +1,72 @@
1-
---
2-
title: Azure Spring Apps API breaking changes
3-
description: Describes the breaking changes introduced by the latest Azure Spring Apps stable API version.
4-
author: KarlErickson
5-
ms.author: yuwzho
6-
ms.service: azure-spring-apps
7-
ms.topic: how-to
8-
ms.date: 06/27/2024
9-
ms.custom: devx-track-java, devx-track-azurecli
10-
---
11-
12-
# Azure Spring Apps API breaking changes
13-
14-
[!INCLUDE [deprecation-note](../includes/deprecation-note.md)]
15-
16-
**This article applies to:** ✔️ Basic/Standard ✔️ Enterprise
17-
18-
This article describes breaking changes introduced into the Azure Spring Apps API.
19-
20-
The Azure Spring Apps service releases the new stable API version 2022-04-01. The new API version introduces breaking changes based on the previous stable API version 2020-07-01. We suggest that you update your API calls to the new API version.
21-
22-
## Previous API deprecation date
23-
24-
The previous API version 2020-07-01 will not be supported starting April, 2025.
25-
26-
## API breaking changes from 2020-07-01 to 2022-04-01
27-
28-
### Deprecate number value CPU and MemoryInGB in Deployments
29-
30-
Deprecate field `properties.deploymentSettings.cpu` and `properties.deploymentSettings.memoryInGB` in the `Spring/Apps/Deployments` resource. Use `properties.deploymentSettings.resourceRequests.cpu` and `properties.deploymentSettings.resourceRequests.memory` instead.
31-
32-
### RBAC role change for blue-green deployment
33-
34-
Deprecate field `properties.activeDeploymentName` in the `Spring/Apps` resource. Use `POST/SUBSCRIPTIONS/RESOURCEGROUPS/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/APPS/SETACTIVEDEPLOYMENTS` for blue-green deployment. This action needs a separate RBAC role `spring/apps/setActiveDeployments/action` to perform.
35-
36-
### Move options from different property bags for the Spring/Apps/Deployments resource
37-
38-
- Deprecate `properties.createdTime`. Use `systemData.createdAt`.
39-
- Deprecate `properties.deploymentSettings.jvmOptions`. Use `properties.source.jvmOptions`.
40-
- Deprecate `properties.deploymentSettings.jvmOptions`. Use `properties.source.runtimeVersion`.
41-
- Deprecate `properties.deploymentSettings.netCoreMainEntryPath`. Use `properties.source.netCoreMainEntryPath`.
42-
- Deprecate `properties.appName`, which you can extract from `id`.
43-
44-
## Updates in the Azure CLI extension
45-
46-
### Add new RBAC role for blue-green deployment
47-
48-
You need to add RBAC role `spring/apps/setActiveDeployments/action` to perform the following Azure CLI commands:
49-
50-
```azurecli
51-
az spring app set-deployment \
52-
--resource-group <resource-group-name> \
53-
--service <service-instance-name> \
54-
--name <app-name> \
55-
--deployment <deployment-name>
56-
az spring app unset-deployment \
57-
--resource-group <resource-group-name> \
58-
--service <service-instance-name> \
59-
--name <app-name>
60-
```
61-
62-
### Output updates
63-
64-
If you're using the Azure CLI `spring-cloud` extension with a version lower than 3.0.0, and you want to upgrade the extension version or migrate to the `spring` extension, then you should take care of the following output updates.
65-
66-
- `az spring app` command output: Remove `properties.activeDeploymentName`. Use `properties.activeDeployment.name` instead.
67-
- `az spring app` command output: Remove `properties.createdTime`. Use `systemData.createdAt` instead.
68-
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.cpu`. Use `properties.activeDeployment.properties.deploymentSettings.resourceRequests.cpu` instead.
69-
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.memoryInGB`. Use `properties.activeDeployment.properties.deploymentSettings.resourceRequests.memory` instead.
70-
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.jvmOptions`. Use `properties.activeDeployment.properties.source.jvmOptions` instead.
71-
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.runtimeVersion`. Use `properties.activeDeployment.properties.source.runtimeVersion` instead.
72-
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.netCoreMainEntryPath`. Use `properties.activeDeployment.properties.source.netCoreMainEntryPath` instead.
1+
---
2+
title: Azure Spring Apps API breaking changes
3+
description: Describes the breaking changes introduced by the latest Azure Spring Apps stable API version.
4+
author: KarlErickson
5+
ms.author: yuwzho
6+
ms.service: azure-spring-apps
7+
ms.topic: how-to
8+
ms.date: 06/27/2024
9+
ms.custom: devx-track-java, devx-track-azurecli
10+
---
11+
12+
# Azure Spring Apps API breaking changes
13+
14+
[!INCLUDE [deprecation-note](../includes/deprecation-note.md)]
15+
16+
**This article applies to:** ✔️ Basic/Standard ✔️ Enterprise
17+
18+
This article describes breaking changes introduced into the Azure Spring Apps API.
19+
20+
The Azure Spring Apps service releases the new stable API version 2022-04-01. The new API version introduces breaking changes based on the previous stable API version 2020-07-01. We suggest that you update your API calls to the new API version.
21+
22+
## Previous API deprecation date
23+
24+
The previous API version 2020-07-01 will not be supported starting April, 2025.
25+
26+
## API breaking changes from 2020-07-01 to 2022-04-01
27+
28+
### Deprecate number value CPU and MemoryInGB in Deployments
29+
30+
Deprecate field `properties.deploymentSettings.cpu` and `properties.deploymentSettings.memoryInGB` in the `Spring/Apps/Deployments` resource. Use `properties.deploymentSettings.resourceRequests.cpu` and `properties.deploymentSettings.resourceRequests.memory` instead.
31+
32+
### RBAC role change for blue-green deployment
33+
34+
Deprecate field `properties.activeDeploymentName` in the `Spring/Apps` resource. Use `POST/SUBSCRIPTIONS/RESOURCEGROUPS/PROVIDERS/MICROSOFT.APPPLATFORM/SPRING/APPS/SETACTIVEDEPLOYMENTS` for blue-green deployment. This action needs a separate RBAC role `spring/apps/setActiveDeployments/action` to perform.
35+
36+
### Move options from different property bags for the Spring/Apps/Deployments resource
37+
38+
- Deprecate `properties.createdTime`. Use `systemData.createdAt`.
39+
- Deprecate `properties.deploymentSettings.jvmOptions`. Use `properties.source.jvmOptions`.
40+
- Deprecate `properties.deploymentSettings.jvmOptions`. Use `properties.source.runtimeVersion`.
41+
- Deprecate `properties.deploymentSettings.netCoreMainEntryPath`. Use `properties.source.netCoreMainEntryPath`.
42+
- Deprecate `properties.appName`, which you can extract from `id`.
43+
44+
## Updates in the Azure CLI extension
45+
46+
### Add new RBAC role for blue-green deployment
47+
48+
You need to add RBAC role `spring/apps/setActiveDeployments/action` to perform the following Azure CLI commands:
49+
50+
```azurecli
51+
az spring app set-deployment \
52+
--resource-group <resource-group-name> \
53+
--service <service-instance-name> \
54+
--name <app-name> \
55+
--deployment <deployment-name>
56+
az spring app unset-deployment \
57+
--resource-group <resource-group-name> \
58+
--service <service-instance-name> \
59+
--name <app-name>
60+
```
61+
62+
### Output updates
63+
64+
If you're using the Azure CLI `spring-cloud` extension with a version lower than 3.0.0, and you want to upgrade the extension version or migrate to the `spring` extension, then you should take care of the following output updates.
65+
66+
- `az spring app` command output: Remove `properties.activeDeploymentName`. Use `properties.activeDeployment.name` instead.
67+
- `az spring app` command output: Remove `properties.createdTime`. Use `systemData.createdAt` instead.
68+
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.cpu`. Use `properties.activeDeployment.properties.deploymentSettings.resourceRequests.cpu` instead.
69+
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.memoryInGB`. Use `properties.activeDeployment.properties.deploymentSettings.resourceRequests.memory` instead.
70+
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.jvmOptions`. Use `properties.activeDeployment.properties.source.jvmOptions` instead.
71+
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.runtimeVersion`. Use `properties.activeDeployment.properties.source.runtimeVersion` instead.
72+
- `az spring app` command output: Remove `properties.activeDeployment.properties.deploymentSettings.netCoreMainEntryPath`. Use `properties.activeDeployment.properties.source.netCoreMainEntryPath` instead.

articles/spring-apps/enterprise/concept-app-customer-responsibilities.md renamed to articles/spring-apps/basic-standard/concept-app-customer-responsibilities.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ You can choose any version of Spring Boot or Spring Cloud that's compatible with
3636

3737
For new versions, Azure Spring Apps supports the latest Spring Boot or Spring Cloud major version starting 30 days after its release. The latest minor version is supported as soon as it's released.
3838

39-
For old versions, Azure Spring Apps doesn't require you to upgrade Spring Boot or Spring Cloud to receive support. However, with the officially supported new versions, you can get the best experience with some of the managed components - for example, Config Server and Eureka Server for the Standard consumption and dedicated plan and the Standard plan, [Tanzu components](vmware-tanzu-components.md) for the Enterprise plan, and metric collection for all plans.
39+
For old versions, Azure Spring Apps doesn't require you to upgrade Spring Boot or Spring Cloud to receive support. However, with the officially supported new versions, you can get the best experience with some of the managed components - for example, Config Server and Eureka Server for the Standard consumption and dedicated plan and the Standard plan, [Tanzu components](../enterprise/vmware-tanzu-components.md) for the Enterprise plan, and metric collection for all plans.
4040

4141
For more information, see the official support timeline of [Spring Boot](https://spring.io/projects/spring-boot#support) and [Spring Cloud](https://spring.io/projects/spring-cloud#overview). The Enterprise plan provides commercial support for Spring Boot, while the other plans provide OSS support.
4242

@@ -48,7 +48,7 @@ The following sections describe the version support that applies to the Enterpri
4848

4949
You can deploy polyglot applications to the Enterprise plan with source code. To enjoy the best stability, use SDKs with LTS versions that are officially supported.
5050

51-
When you deploy your polyglot applications to the Enterprise plan, assign specific LTS versions for the SDKs. Otherwise, the default SDK version might change during the regular upgrades for builder components. For more information about deploying polyglot apps, see [How to deploy polyglot apps in the Azure Spring Apps Enterprise plan](how-to-enterprise-deploy-polyglot-apps.md).
51+
When you deploy your polyglot applications to the Enterprise plan, assign specific LTS versions for the SDKs. Otherwise, the default SDK version might change during the regular upgrades for builder components. For more information about deploying polyglot apps, see [How to deploy polyglot apps in the Azure Spring Apps Enterprise plan](../enterprise/how-to-enterprise-deploy-polyglot-apps.md).
5252

5353
| Type | Support policy |
5454
|--------|-------------------------------------------------------------------------------------------------------|

articles/spring-apps/enterprise/concept-app-status.md renamed to articles/spring-apps/basic-standard/concept-app-status.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ The provisioning state is accessible only from the CLI. The status is reported a
5656

5757
### Registration status
5858

59-
The app registration status shows the state in service discovery. The Basic/Standard plan uses Eureka for service discovery. For more information on how the Eureka client calculates the state, see [Eureka's health checks](https://cloud.spring.io/spring-cloud-netflix/multi/multi__service_discovery_eureka_clients.html#_eurekas_health_checks). The Enterprise pricing plan uses [Tanzu Service Registry](how-to-enterprise-service-registry.md) for service discovery.
59+
The app registration status shows the state in service discovery. The Basic/Standard plan uses Eureka for service discovery. For more information on how the Eureka client calculates the state, see [Eureka's health checks](https://cloud.spring.io/spring-cloud-netflix/multi/multi__service_discovery_eureka_clients.html#_eurekas_health_checks). The Enterprise pricing plan uses [Tanzu Service Registry](../enterprise/how-to-enterprise-service-registry.md) for service discovery.
6060

6161
## App instances status
6262

articles/spring-apps/enterprise/concept-manage-monitor-app-spring-boot-actuator.md renamed to articles/spring-apps/basic-standard/concept-manage-monitor-app-spring-boot-actuator.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,9 @@ When you open the app to the public, these actuator endpoints are exposed to the
6767

6868
In the Enterprise plan, there are two ways to secure the access:
6969

70-
- You can disable the public endpoint of apps and configure a routing rule in VMware Spring Cloud Gateway to disable actuator access from the public. For more information, see [Configure VMware Spring Cloud Gateway](./how-to-configure-enterprise-spring-cloud-gateway.md).
70+
- You can disable the public endpoint of apps and configure a routing rule in VMware Spring Cloud Gateway to disable actuator access from the public. For more information, see [Configure VMware Spring Cloud Gateway](../enterprise/how-to-configure-enterprise-spring-cloud-gateway.md).
7171

72-
- You can configure the actuator to listen on a different HTTP port from the main application. In a standalone application, the actuator HTTP port defaults to the same as the main HTTP port. For the application to listen on a different port, set the `management.server.port` property. The Application Live View is unable to automatically detect this port change, so you also need to configure the property on an Azure Spring Apps deployment. Then, the actuator isn't publically accessible, but the Application Live View can read from the actuator endpoint via another port. For more information, see [Use Application Live View with the Azure Spring Apps Enterprise plan](./how-to-use-application-live-view.md).
72+
- You can configure the actuator to listen on a different HTTP port from the main application. In a standalone application, the actuator HTTP port defaults to the same as the main HTTP port. For the application to listen on a different port, set the `management.server.port` property. The Application Live View is unable to automatically detect this port change, so you also need to configure the property on an Azure Spring Apps deployment. Then, the actuator isn't publically accessible, but the Application Live View can read from the actuator endpoint via another port. For more information, see [Use Application Live View with the Azure Spring Apps Enterprise plan](../enterprise/how-to-use-application-live-view.md).
7373

7474
## Next steps
7575

articles/spring-apps/enterprise/concept-metrics.md renamed to articles/spring-apps/basic-standard/concept-metrics.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -212,7 +212,7 @@ The following table applies to the Tanzu Spring Cloud Gateway in Enterprise plan
212212
213213
## Next steps
214214

215-
* [Quickstart: Monitoring Azure Spring Apps apps with logs, metrics, and tracing](../basic-standard/quickstart-logs-metrics-tracing.md)
215+
* [Quickstart: Monitoring Azure Spring Apps apps with logs, metrics, and tracing](quickstart-logs-metrics-tracing.md)
216216
* [Analyze metrics with Azure Monitor metrics explorer](/azure/azure-monitor/essentials/analyze-metrics)
217217
* [Analyze logs and metrics with diagnostics settings](./diagnostic-services.md)
218218
* [Tutorial: Monitor Spring app resources using alerts and action groups](./tutorial-alerts-action-groups.md)
File renamed without changes.
File renamed without changes.

0 commit comments

Comments
 (0)