Merge pull request MicrosoftDocs#9912 from MicrosoftDocs/main63838713…

…9704012998sync_temp Repo sync for protected branch
igecloudsdev · Dec 21, 2023 · 418dcdb · 418dcdb
2 parents 11b06ba + b505c83
commit 418dcdb
Show file tree

Hide file tree

Showing 36 changed files with 112 additions and 9 deletions.
diff --git a/docs/azure/azure-app-insights-add-connected-service.md b/docs/azure/azure-app-insights-add-connected-service.md
@@ -33,6 +33,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 :::moniker range="vs-2019"
 

diff --git a/docs/azure/azure-cache-for-redis-add-connected-service.md b/docs/azure/azure-cache-for-redis-add-connected-service.md
@@ -33,6 +33,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Connect to Azure Cache for Redis using Connected Services
 

diff --git a/docs/azure/azure-cosmosdb-add-connected-service.md b/docs/azure/azure-cosmosdb-add-connected-service.md
@@ -33,6 +33,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Connect to Azure Cosmos DB using Connected Services
 :::moniker range="vs-2019"

diff --git a/docs/azure/azure-deployment-using-github-actions.md b/docs/azure/azure-deployment-using-github-actions.md
@@ -21,7 +21,7 @@ Starting in Visual Studio 2019 version 16.11, you can create new GitHub Actions
 ## Prerequisites
 
 - You must be signed in to your [GitHub account](../ide/work-with-github-accounts.md) in Visual Studio.
-- An Azure subscription. Sign up for a free trail [here](https://azure.microsoft.com/free/).
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Deploy a single project to Azure using GitHub Actions
 

diff --git a/docs/azure/azure-signalr-add-connected-service.md b/docs/azure/azure-signalr-add-connected-service.md
@@ -33,6 +33,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 :::moniker range="vs-2019"
 

diff --git a/docs/azure/azure-sql-database-add-connected-service.md b/docs/azure/azure-sql-database-add-connected-service.md
@@ -34,6 +34,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Connect to Azure SQL Database using Connected Services
 

diff --git a/docs/azure/includes/prerequisites-azure-subscription.md b/docs/azure/includes/prerequisites-azure-subscription.md
@@ -0,0 +1,10 @@
+---
+title: "include"
+description: "include"
+author: ghogen
+ms.technology: vs-azure
+ms.author: ghogen
+ms.topic: "include"
+ms.date: 12/20/2023
+---
+An Azure account. If you don't have an Azure account, activate your [Azure benefits for Visual Studio subscribers](/visualstudio/subscriptions/vs-azure-eligibility) or [sign up for a free trial](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
diff --git a/docs/azure/includes/subscription-azure-benefits.md b/docs/azure/includes/subscription-azure-benefits.md
@@ -0,0 +1,10 @@
+---
+title: "include"
+description: "include"
+author: ghogen
+ms.technology: vs-azure
+ms.author: ghogen
+ms.topic: "include"
+ms.date: 12/20/2023
+---
+Many Visual Studio subscriptions include [Azure individual Dev/Test credits](/visualstudio/subscriptions/vs-azure-eligibility). If you're a Visual Studio subscriber, you can use these credits to try various Azure services at no cost. If you're not a subscriber and don't have an Azure subscription, you can [create a free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
diff --git a/docs/azure/overview-azure-integration.md b/docs/azure/overview-azure-integration.md
@@ -15,6 +15,10 @@ monikerRange: ">=vs-2019"
 
 You can work with Azure in Visual Studio using many capabilities designed to make development and deployment to Azure easier.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Provision Azure resources
 
 This is a typical Visual Studio dialog where you can browse and search existing Azure resources. Above the list of existing resources, there is a button that lets you provision new ones:

diff --git a/docs/azure/overview-connected-services.md b/docs/azure/overview-connected-services.md
@@ -34,6 +34,8 @@ Get started by right-clicking on the project node, and choosing **Add > Connecte
 
 Supported project types vary by the type of service. You'll see the options that apply to your project type in the listed selections.
 
+[!INCLUDE [subscription-azure-benefits](includes/subscription-azure-benefits.md)]
+
 <a name="azure"/>
 
 ## Connect your app to Azure services

diff --git a/docs/azure/overview.md b/docs/azure/overview.md
@@ -14,7 +14,9 @@ monikerRange: ">=vs-2019"
 
 Application development can be easier if you use cloud services to handle many issues that you would otherwise have to implement. When you use cloud services hosted in the Azure cloud, you use a reliable and highly available cloud environment that is managed by Microsoft to handle much of the infrastructure that many apps and services need, so that you can focus development efforts on what is unique to your application.
 
-In this article, you learn about how Visual Studio can help with Azure development, whether you're getting a web site up and running, connecting to services like storage, databases, secrets management, or using services that add value like caching. If you don't have an Azure account, you can sign up for a [free trial](https://azure.microsoft.com/free/).
+In this article, you learn about how Visual Studio can help with Azure development, whether you're getting a web site up and running, connecting to services like storage, databases, secrets management, or using services that add value like caching. 
+
+[!INCLUDE [subscription-azure-benefits](includes/subscription-azure-benefits.md)]
 
 ## Supported technologies and languages
 

diff --git a/docs/azure/toc.yml b/docs/azure/toc.yml
@@ -35,8 +35,8 @@
   items:
   - name: ASP.NET web app
     items:
-    - name: Azure App Service
-      href: /aspnet/core/tutorials/publish-to-azure-webapp-using-vs?toc=%2Fvisualstudio%2Fazure%2Ftoc.json&bc=/visualstudio/_breadcrumb/toc.json
+    - name: Azure App Service >>
+      href: /aspnet/core/tutorials/publish-to-azure-webapp-using-vs
     - name: Azure Container Apps >>
       href: /azure/container-apps/deploy-visual-studio
     - name: Azure Container Registry

diff --git a/docs/azure/vs-active-directory-add-connected-service.md b/docs/azure/vs-active-directory-add-connected-service.md
@@ -22,7 +22,7 @@ At present, the Active Directory connected service does not support ASP.NET Core
 
 ## Prerequisites
 
-- Azure account: if you don't have an Azure account, you can [sign up for a free trial](https://azure.microsoft.com/pricing/free-trial/?WT.mc_id=A261C142F) or [activate your Visual Studio subscriber benefits](https://azure.microsoft.com/pricing/member-offers/msdn-benefits-details/?WT.mc_id=A261C142F).
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 - **Visual Studio 2015** or later. [Download Visual Studio now](https://aka.ms/vsdownload?utm_source=mscom&utm_campaign=msdocs).
 
 <a name='connect-to-azure-active-directory-using-the-connected-services-dialog'></a>

diff --git a/docs/azure/vs-azure-tools-azure-project-create.md b/docs/azure/vs-azure-tools-azure-project-create.md
@@ -16,6 +16,10 @@ ms.author: ghogen
 
 Visual Studio provides a project template that lets you create an [Azure cloud service](/azure/cloud-services/cloud-services-choose-me), which is a simple general-purpose Azure service. Once the project has been created, Visual Studio enables you to configure, debug, and deploy the cloud service to Azure.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Steps to create an Azure cloud service project in Visual Studio
 This section walks you through creating an Azure cloud service project in Visual Studio with one or more web roles.
 

diff --git a/docs/azure/vs-azure-tools-cloud-service-project-managing-roles.md b/docs/azure/vs-azure-tools-cloud-service-project-managing-roles.md
@@ -16,6 +16,10 @@ ms.author: ghogen
 
 After you have created your Azure cloud service, you can add new roles to it or remove existing roles from it. You can also import an existing project and convert it to a role. For example, you can import an ASP.NET web application and designate it as a web role.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Adding a role to an Azure cloud service
 The following steps guide you through adding a web or worker role to an Azure cloud service project in Visual Studio.
 

diff --git a/...-azure-tools-cloud-service-publish-set-up-required-services-in-visual-studio.md b/...-azure-tools-cloud-service-publish-set-up-required-services-in-visual-studio.md
@@ -19,6 +19,10 @@ To publish a cloud service project, you must set up the following services as de
 * A **cloud service** to run your roles in the Azure environment, and
 * A **storage account** that provides access to the Blob, Queue, and Table services.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Create a cloud service
 
 A cloud service runs your roles in the Azure environment. You can create a cloud service either in Visual Studio or through the [Azure portal](https://portal.azure.com/) as described in the sections that follow.

diff --git a/docs/azure/vs-azure-tools-cloud-service-retain-a-constant-virtual-ip-address.md b/docs/azure/vs-azure-tools-cloud-service-retain-a-constant-virtual-ip-address.md
@@ -16,6 +16,10 @@ ms.author: ghogen
 
 When you update a cloud service that's hosted in Azure, you might need to ensure that the virtual IP address (VIP) of the service doesn't change. Many domain management services use the Domain Name System (DNS) for registering domain names. DNS works only if the VIP remains the same. You can use the **Publish Wizard** in Azure Tools to ensure that the VIP of your cloud service doesn’t change when you update it. For more information about how to use DNS domain management for cloud services, see [Configuring a custom domain name for an Azure cloud service](/azure/cloud-services/cloud-services-custom-domain-name-portal).
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Publish a cloud service without changing its VIP
 The VIP of a cloud service is allocated when you first deploy it to Azure in a particular environment, such as the production environment. The VIP changes only if you delete the deployment explicitly or the deployment is implicitly deleted by the deployment update process. To retain the VIP, you must not delete your deployment, and you must make sure that Visual Studio doesn’t delete your deployment automatically.
 

diff --git a/docs/azure/vs-azure-tools-configure-roles-for-cloud-service.md b/docs/azure/vs-azure-tools-configure-roles-for-cloud-service.md
@@ -28,6 +28,10 @@ When you create an Azure cloud service in Visual Studio, two service configurati
 - `ServiceConfiguration.Cloud.cscfg`
 - `ServiceConfiguration.Local.cscfg`
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Configure an Azure cloud service
 You can configure an Azure cloud service from Solution Explorer in Visual Studio, as shown in the following steps:
 

diff --git a/docs/azure/vs-azure-tools-configuring-an-azure-project.md b/docs/azure/vs-azure-tools-configuring-an-azure-project.md
@@ -20,6 +20,10 @@ You can configure an Azure cloud service project, depending on your requirements
 - **Run or debug a cloud service on the local computer** - You can select a service configuration to use and indicate whether you want to start the Azure Storage Emulator.
 - **Validate a cloud service package when it is created** - You can decide to treat any warnings as errors so that you can ensure that the cloud service package deploys without any issues.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Steps to configure an Azure cloud service project
 1. Open or create a cloud service project in Visual Studio
 

diff --git a/docs/azure/vs-azure-tools-connected-services-app-configuration.md b/docs/azure/vs-azure-tools-connected-services-app-configuration.md
@@ -27,6 +27,7 @@ You can use the App Configuration Connected Services feature in the following pr
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Connect to Azure App Configuration using Connected Services
 

diff --git a/docs/azure/vs-azure-tools-connected-services-storage.md b/docs/azure/vs-azure-tools-connected-services-storage.md
@@ -32,6 +32,7 @@ The connected service functionality adds all the needed references and connectio
 
 - Visual Studio with the Azure workload installed.
 - A project of one of the supported types
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Connect to Azure Storage using Connected Services
 

diff --git a/docs/azure/vs-azure-tools-debug-cloud-services-virtual-machines.md b/docs/azure/vs-azure-tools-debug-cloud-services-virtual-machines.md
@@ -14,6 +14,10 @@ ms.technology: vs-ide-debug
 
 Visual Studio gives you different options for debugging Azure cloud services and virtual machines.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Debug your cloud service on your local computer
 
 You can save time and money by using the Azure Compute Emulator to debug your cloud service on a local machine. By debugging a service locally before you deploy it, you can improve reliability and performance without paying for compute time. However, some errors might occur only when you run a cloud service in Azure itself. You can debug these errors if you enable remote debugging when you publish your service and then attach the debugger to a role instance.

diff --git a/docs/azure/vs-azure-tools-diagnostics-for-cloud-services-and-virtual-machines.md b/docs/azure/vs-azure-tools-diagnostics-for-cloud-services-and-virtual-machines.md
@@ -1,5 +1,5 @@
 ---
-title: "Diagnostics - Azure Cloud Services & VMs"
+title: "Diagnostics - Azure Cloud Services and VMs"
 description: Learn how to set up diagnostics for debugging Azure cloud services and virtual machines (VMs) in Visual Studio.
 author: ghogen
 manager: jmartens
@@ -23,6 +23,10 @@ You can use one of the following options to set up Azure Diagnostics:
 * Change diagnostics settings in the **Diagnostics Configuration** dialog box in Visual Studio. The settings are saved in a file called diagnostics.wadcfgx (in Azure SDK 2.4 and earlier, the file is called diagnostics.wadcfg). You also you can directly modify the configuration file. If you manually update the file, the configuration changes take effect the next time you deploy the cloud service to Azure or run the service in the emulator.
 * Use Cloud Explorer or Server Explorer in Visual Studio to change the diagnostics settings for a cloud service or virtual machine that is running.
 
+> [!WARNING]
+> In Visual Studio 2022, the deprecated Azure Storage Emulator was replaced with the [Azurite emulator](/azure/storage/common/storage-use-azurite) when debugging your Cloud Service projects. This Azurite emulator does not work with the Azure Diagnostics plugin, which provides support for Azure Diagnostics when running and testing locally. If you need the plugin for local running and testing scenarios, you can either update the connection string in the local service configuration (`.cscfg`) to an Azure storage account (see [Manage connection strings for storage accounts](vs-azure-tools-configure-roles-for-cloud-service.md#manage-connection-strings-for-storage-accounts)), or download the previous [Azure storage emulator](/azure/storage/common/storage-use-emulator).
+ > In the Visual Studio 17.10 release, the local Azure Diagnostics plugin is being deprecated and will be disabled by default with the option to enable in that release. Due to the deprecation, the plugin might be removed in a future release of Visual Studio. This plugin is only used with the local Azure Compute emulator and disabling doesn't impact deployed Cloud Services that use the Azure Diagnostics extension in Azure.
+
 ## Azure SDK 2.6 diagnostics changes
 The following changes apply to Azure SDK 2.6 and later projects in Visual Studio:
 

diff --git a/docs/azure/vs-azure-tools-intellitrace-debug-published-cloud-services.md b/docs/azure/vs-azure-tools-intellitrace-debug-published-cloud-services.md
@@ -24,6 +24,10 @@ As an alternative, you can use [remote debugging](vs-azure-tools-debugging-cloud
 > IntelliTrace is intended for debug scenarios only, and should not be used for a production deployment.
 >
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Configure an Azure application for IntelliTrace
 To enable IntelliTrace for an Azure application, you must create and publish the application from a Visual Studio Azure project. You must configure IntelliTrace for your Azure application before you publish it to Azure. If you publish your application without configuring IntelliTrace, you need to republish the project. For more information, see [Publishing an Azure cloud services projects using Visual Studio](vs-azure-tools-publishing-a-cloud-service.md).
 

diff --git a/docs/azure/vs-azure-tools-migrate-publish-web-app-to-cloud-service.md b/docs/azure/vs-azure-tools-migrate-publish-web-app-to-cloud-service.md
@@ -19,6 +19,10 @@ To take advantage of the hosting services and scaling ability of Azure, you migh
 > [!Important]
 > This migration is supported only for the specific ASP.NET, WCF, and WCF Workflow projects. It is not supported for ASP.NET Core projects. See [Supported Project Templates](#supported-project-templates).
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Migrate a project to cloud services
 
 1. Right-click the solution node and select **Add > New Project...** and add a new **Azure Cloud Service (classic)** project to the existing solution.

diff --git a/docs/azure/vs-azure-tools-performance-profiling-cloud-services.md b/docs/azure/vs-azure-tools-performance-profiling-cloud-services.md
@@ -20,6 +20,10 @@ You can test the performance of a cloud service in the following ways:
 * Use Azure Diagnostics to collect information about requests and connections, and to review site statistics that show how the service performs from a customer perspective. To get started with , see [Configuring diagnostics for Azure Cloud Services and Virtual Machines](vs-azure-tools-diagnostics-for-cloud-services-and-virtual-machines.md).
 * Use the Visual Studio profiler to get an in-depth analysis of the computational aspects of how the service runs. As this topic describes, you can use the profiler to measure performance as a service runs in Azure. For information about how to use the profiler to measure performance as a service runs locally in a compute emulator, see [Testing the Performance of an Azure Cloud Service Locally in the Compute Emulator Using the Visual Studio Profiler](/azure/cloud-services/cloud-services-performance-testing-visual-studio-profiler).
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Choosing a performance testing method
 ### Use Azure Diagnostics to collect:
 * Statistics on web pages or services, such as requests and connections.

diff --git a/docs/azure/vs-azure-tools-publish-azure-application-wizard.md b/docs/azure/vs-azure-tools-publish-azure-application-wizard.md
@@ -16,6 +16,10 @@ ms.author: ghogen
 
 After you develop a web application in Visual Studio, you can publish that application to an Azure cloud service by using the **Publish Azure Application** wizard.
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Accessing the Publish Azure Application wizard
 
 You can access the Publish Azure Application wizard in two ways depending on the type of Visual Studio project you have.

diff --git a/docs/azure/vs-azure-tools-publishing-a-cloud-service.md b/docs/azure/vs-azure-tools-publishing-a-cloud-service.md
@@ -23,6 +23,10 @@ Use the following procedures to publish your Azure application and to update a w
 - Publish or Package an Azure application from Visual Studio
 - Update a web role as part of the development and testing cycle
 
+## Prerequisites
+
+- [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 ## Publish or package an Azure application from Visual Studio
 
 When you publish your Azure application, you can do one of the following tasks:

diff --git a/docs/azure/vs-azure-tools-publishing-using-powershell-scripts.md b/docs/azure/vs-azure-tools-publishing-using-powershell-scripts.md
@@ -21,6 +21,7 @@ Using these scripts, you can provision customized versions (also known as dev an
 * Visual Studio 2015 or later with the **Azure workload** installed, or Visual Studio 2013 and Azure SDK 2.3 or later. See [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta). (You don't need the Azure SDK to generate the scripts for web projects. This feature is for web projects, not web roles in cloud services.)
 * Azure PowerShell 0.7.4 or later. See [How to install and configure Azure PowerShell](/powershell/azure/overview).
 * [Windows PowerShell 3.0](/previous-versions/windows/it-pro/windows-server-2008-R2-and-2008/cc770458(v=ws.10)) or later.
+* [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
 
 ## Additional tools
 

diff --git a/docs/azure/vs-azure-tools-resources-managing-with-cloud-explorer.md b/docs/azure/vs-azure-tools-resources-managing-with-cloud-explorer.md
@@ -34,7 +34,8 @@ Like the [Azure portal](https://portal.azure.com), Cloud Explorer is built on th
 ## Prerequisites
 
 * Visual Studio 2017 or later (see [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) with the **Azure workload** selected. You can also use an earlier version of Visual Studio with the Microsoft Azure SDK for .NET 2.9.
-* Microsoft Azure account - If you don't have an account, you can [sign up for a free trial](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/) or [activate your Visual Studio subscriber benefits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/).
+* [!INCLUDE [prerequisites-azure-subscription](includes/prerequisites-azure-subscription.md)]
+
 
 > [!NOTE]
 > To view Cloud Explorer, press **Ctrl**+**Q** to activate the search box, and then enter **Cloud Explorer**.