Merge pull request #296101 from maud-lv/ml-acadeprecation2

Add Azure Spring Apps deprecation note

Author: denrea

articles/service-connector/includes/passwordless-tutorial-snippet.md

@@ -1,13 +1,13 @@
 ---
-author: xfz11
+author: maud-lv
+ms.author: malev
 ms.service: service-connector
 ms.custom: devx-track-azurecli
 ms.topic: include
 ms.date: 05/21/2023
-ms.author: xiaofanzhou
 ---
 
-### Install the Service Connector passwordless extension
+## Install the Service Connector passwordless extension
 
 [!INCLUDE [CLI-samples-clean-up](./install-passwordless-extension.md)]
 

articles/service-connector/quickstart-cli-spring-cloud-connection.md

@@ -1,20 +1,22 @@
 ---
-title: Quickstart - Create a service connection in Azure Spring Apps with the Azure CLI
+title: Create a service connection in Spring Apps - Azure CLI
 description: In this step-by-step guide, learn how to create a service connection in Azure Spring Apps using the Azure CLI.
 author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 12/18/2024
+ms.date: 3/11/2025
 ms.devlang: azurecli
 ms.custom: devx-track-azurecli, build-2024
 ---
 
 # Quickstart: Create a service connection in Azure Spring Apps with the Azure CLI
 
-This quickstart shows you how to connect Azure Spring Apps to other Cloud resources using the Azure CLI and Service Connector.
+This quickstart shows you how to connect Azure Spring Apps to other Cloud resources using the Azure CLI and Service Connector. Service Connector streamlines the process of linking compute services to cloud services, while managing authentication and networking settings.
 
-Service Connector lets you quickly connect compute services to cloud services, while managing your connection's authentication and networking settings.
+[!INCLUDE [deprecation-note](../spring-apps/includes/deprecation-note.md)]
+
+To connect resources using the Azure portal, see [Create a service connection in Azure Spring Apps with the Azure portal](./quickstart-portal-spring-cloud-connection.md).
 
 ## Prerequisites
 
@@ -54,8 +56,8 @@ Create a connection from Azure Spring Apps using a managed identity or an access
 
 ### [Managed identity](#tab/Using-Managed-Identity)
 
-> [!IMPORTANT]
-> To use a managed identity, you must have the permission to modify [role assignments in Microsoft Entra ID](/entra/identity/role-based-access-control/manage-roles-portal). Ask your subscription owner to grant you a role assignment permission or use an access key to create the connection.
+> [!NOTE]
+> To use a managed identity, you must have permission to modify [role assignments in Microsoft Entra ID](/entra/identity/role-based-access-control/manage-roles-portal). If necessary, ask your subscription owner to grant you this permission.
 
 1. Run the `az spring connection create` command to connect application deployed to Azure Spring Apps to a Blob Storage resource, using a system-assigned managed identity.
 

articles/service-connector/quickstart-portal-spring-cloud-connection.md

@@ -5,7 +5,7 @@ author: maud-lv
 ms.author: malev
 ms.service: service-connector
 ms.topic: quickstart
-ms.date: 10/04/2023
+ms.date: 3/11/2025
 ms.custom:
   - kr2b-contr-experiment
   - build-2024
@@ -14,10 +14,11 @@ ms.custom:
 
 # Quickstart: Create a service connection in Azure Spring Apps from the Azure portal
 
-This quickstart shows you how to connect Azure Spring Apps to other Cloud resources using the Azure portal and Service Connector. Service Connector lets you quickly connect compute services to cloud services, while managing your connection's authentication and networking settings.
+This quickstart shows you how to connect Azure Spring Apps to other Cloud resources using the Azure portal and Service Connector. Service Connector streamlines the process of linking compute services to cloud services, while managing authentication and networking settings.
 
-> [!NOTE]
-> For information on connecting resources using Azure CLI, see [Create a service connection in Azure Spring Apps with the Azure CLI](./quickstart-cli-spring-cloud-connection.md).
+[!INCLUDE [deprecation-note](../spring-apps/includes/deprecation-note.md)]
+
+To connect resources using the Azure CLI, see [Create a service connection in Azure Spring Apps with the Azure CLI](./quickstart-cli-spring-cloud-connection.md).
 
 ## Prerequisites
 

articles/service-connector/tutorial-java-spring-confluent-kafka.md

@@ -20,6 +20,8 @@ Learn how to access Apache Kafka on Confluent Cloud for a Spring Boot applicatio
 > * Build and deploy the Spring Boot app
 > * Connect Apache Kafka on Confluent Cloud to Azure Spring Apps using Service Connector
 
+[!INCLUDE [deprecation-note](../spring-apps/includes/deprecation-note.md)]
+
 > [!WARNING]
 > Microsoft recommends that you use the most secure authentication flow available. The authentication flow described in this procedure requires a very high degree of trust in the application, and carries risks that are not present in other flows. You should only use this flow when other more secure flows, such as managed identities, aren't viable.
 

articles/service-connector/tutorial-java-spring-mysql.md

@@ -19,6 +19,7 @@ In this tutorial, you'll complete the following tasks using the Azure portal or
 > * Build and deploy apps to Azure Spring Apps
 > * Integrate Azure Spring Apps with Azure Database for MySQL with Service Connector
 
+[!INCLUDE [deprecation-note](../spring-apps/includes/deprecation-note.md)]
 
 > [!WARNING]
 > Microsoft recommends that you use the most secure authentication flow available. The authentication flow described in this procedure requires a very high degree of trust in the application, and carries risks that are not present in other flows. You should only use this flow when other more secure flows, such as managed identities, aren't viable.

articles/service-connector/tutorial-passwordless.md

@@ -28,43 +28,30 @@ In this tutorial, you use the Azure CLI to complete the following tasks:
 
 ## Prerequisites
 
-* [Azure CLI](/cli/azure/install-azure-cli) version 2.61.0 or higher.
-* An Azure account with an active subscription. [Create an Azure account for free](https://azure.microsoft.com/free).
-* An app deployed to [Azure App Service](../app-service/overview.md) in a [region supported by Service Connector](./concept-region-support.md).
+- An Azure account with an active subscription. [Create an Azure account for free](https://azure.microsoft.com/free).
+- An app deployed to [Azure App Service](../app-service/overview.md) in a [region supported by Service Connector](./concept-region-support.md).
+- [Azure CLI](/cli/azure/install-azure-cli) version 2.61.0 or higher.
 
-### Set up your environment
-
-#### Account
-
-Sign in with the Azure CLI via `az login`. If you're using Azure Cloud Shell or are already logged in, confirm your authenticated account with `az account show`.
+To begin using the Azure CLI:
 
+[!INCLUDE [azure-cli-prepare-your-environment-no-header.md](~/reusable-content/azure-cli/azure-cli-prepare-your-environment-no-header.md)]
 
 [!INCLUDE [passwordless snippet](./includes/passwordless-tutorial-snippet.md)]
 
 ## Deploy the application to an Azure hosting service
 
-Finally, deploy your application to an Azure hosting service. That source service can use a managed identity to connect to the target database on Azure.
-
-### [App Service](#tab/appservice)
-
-For Azure App Service, you can check the document to choose a way to deploy, see [Quickstart: Deploy an ASP.NET web app](../app-service/quickstart-dotnetcore.md).
-
-### [Spring Apps](#tab/springapp)
-
-For Azure Spring Apps, you can check the document for more details about building app and deployment, see [Build and deploy the app](/azure/developer/java/spring-framework/deploy-passwordless-spring-database-app?#build-and-deploy-the-app).
+1. Deploy your application to an Azure hosting service. Optionally refer to the guides below for more information about deploying these resources.
 
+   - Azure App Service: [Quickstart: Deploy an ASP.NET web app](../app-service/quickstart-dotnetcore.md).
+   - Azure Container Apps: [Quickstart: Deploy your first container app](../container-apps/get-started.md).
+   - Azure Spring Apps: [Build and deploy the app](/azure/developer/java/spring-framework/deploy-passwordless-spring-database-app?#build-and-deploy-the-app).
+       [!INCLUDE [deprecation-note](../spring-apps/includes/deprecation-note.md)]
 
-### [Container Apps](#tab/containerapp)
+1. Check the log or call the application to see if it can connect to the Azure database successfully.
 
-For Azure Container Apps, you can check the document about how to deploy your app, see [Quickstart: Deploy your first container app](../container-apps/get-started.md).
+## Troubleshooting
 
----
-
-Then you can check the log or call the application to see if it can connect to the Azure database successfully.
-
-### Troubleshooting
-
-#### Permission
+### Permissions
 
 If you encounter any permission-related errors, confirm the Azure CLI signed-in user with the command `az account show`. Make sure you sign in with the correct account. Next, confirm that you have the following permissions that might be required to create a passwordless connection with Service Connector.
 
@@ -111,7 +98,7 @@ In some cases, the permissions aren't required. For example, if the Azure CLI-au
 
 <a name='azure-active-directory'></a>
 
-#### Microsoft Entra ID
+### Microsoft Entra ID
 
 If you get an error `ERROR: AADSTS530003: Your device is required to be managed to access this resource.`, ask your IT department for help with joining this device to Microsoft Entra ID. For more information, see [Microsoft Entra joined devices](../active-directory/devices/concept-azure-ad-join.md).
 
@@ -125,7 +112,7 @@ If you don't log in interactively, you might also get the error and `Interactive
 
 <a name='connect-to-database-with-azure-active-directory-authentication'></a>
 
-#### Network connectivity
+### Network connectivity
 
 ::: zone pivot="postgresql"
 
@@ -145,11 +132,9 @@ If your database server disallows public access, ensure your environment that ru
 
 ::: zone-end
 
-
-
 ## Next steps
 
-For more information about Service Connector and passwordless connections, see the following resources:
+For more information about Service Connector and passwordless connections, refer to the following resources:
 
 > [!div class="nextstepaction"]
 > [Service Connector documentation](/azure/service-connector/)