Skip to content

Commit 6c7eda3

Browse files
committed
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into mwahl-gov-grace
2 parents 359f9f3 + 8cd6b3e commit 6c7eda3

File tree

57 files changed

+471
-490
lines changed

Some content is hidden

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

57 files changed

+471
-490
lines changed

articles/app-service/tutorial-python-postgresql-app.md

Lines changed: 0 additions & 257 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,6 @@ ms.topic: tutorial
66
ms.date: 02/28/2023
77
ms.author: msangapu
88
ms.custom: mvc, seodec18, seo-python-october2019, cli-validate, devx-track-python, devdivchpfy22, event-tier1-build-2022, vscode-azure-extension-update-completed, AppServiceConnectivity
9-
zone_pivot_groups: deploy-python-web-app-postgresql
109
---
1110

1211
# Deploy a Python (Django or Flask) web app with PostgreSQL in Azure
@@ -20,8 +19,6 @@ In this tutorial, you'll deploy a data-driven Python web app (**[Django](https:/
2019
* An Azure account with an active subscription. If you don't have an Azure account, you [can create one for free](https://azure.microsoft.com/free/python).
2120
* Knowledge of Python with Flask development or [Python with Django development](/training/paths/django-create-data-driven-websites/)
2221

23-
:::zone pivot="deploy-portal"
24-
2522
## Sample application
2623

2724
Sample Python applications using the Flask and Django framework are provided to help you follow along with this tutorial. To deploy them without running them locally, skip this part.
@@ -519,260 +516,6 @@ If you can't connect to the SSH session, then the app itself has failed to start
519516

520517
If you encounter any errors related to connecting to the database, check if the app settings (`AZURE_POSTGRESQL_CONNECTIONSTRING`) have been changed. Without that connection string, the migrate command can't communicate with the database.
521518

522-
:::zone-end
523-
524-
:::zone pivot="deploy-azd"
525-
526-
## Provision and deploy using the Azure Developer CLI
527-
528-
Sample Python application templates using the Flask and Django framework are provided for this tutorial. The [Azure Developer CLI](/azure/developer/azure-developer-cli/overview) greatly streamlines the process of provisioning application resources and deploying code on Azure. For a more step-by-step approach using the Azure portal and other tools, toggle to the **Azure portal** approach at the top of the page.
529-
530-
The Azure Developer CLI (azd) provides end-to-end support for project initialization, provisioning, deploying, monitoring and scaffolding a CI/CD pipeline to run against real Azure resources. You can use `azd` to provision and deploy the resources for the sample application in an automated and streamlined way.
531-
532-
Follow the steps below to setup the Azure Developer CLI and provision and deploy the sample application:
533-
534-
1. Install the Azure Developer CLI. For a full list of supported installation options and tools, visit the [installation guide](/azure/developer/azure-developer-cli/install-azd).
535-
536-
### [Windows](#tab/windows)
537-
538-
```azdeveloper
539-
powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"
540-
```
541-
542-
### [macOS/Linux](#tab/mac-linux)
543-
544-
```azdeveloper
545-
curl -fsSL https://aka.ms/install-azd.sh | bash
546-
```
547-
548-
---
549-
550-
1. Run the `azd init` command to initialize the `azd` app template. Include the `--template` parameter to specify the name of an existing `azd` template you wish to use. More information about working with templates is available on the [choose an `azd` template](/azure/developer/azure-developer-cli/azd-templates) page.
551-
552-
### [Flask](#tab/flask)
553-
554-
For this tutorial, Flask users should specify the [Python (Flask) web app with PostgresSQL](https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app.git) template.
555-
556-
```bash
557-
azd init --template msdocs-flask-postgresql-sample-app
558-
```
559-
560-
### [Django](#tab/django)
561-
562-
For this tutorial, Django users should specify the [Python (Django) web app with PostgresSQL](https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app.git) template.
563-
564-
```bash
565-
azd init --template msdocs-django-postgresql-sample-app
566-
```
567-
568-
1. Run the `azd auth login` command to sign-in to Azure.
569-
570-
```bash
571-
azd auth login
572-
```
573-
574-
1. Run the `azd up` command to provision the necessary Azure resources and deploy the app code. The `azd up` command will also prompt you to select the desired subscription and location to deploy to.
575-
576-
```bash
577-
azd up
578-
```
579-
580-
1. When the `azd up` command finishes running, the URL for your deployed web app in the console will be printed. Click, or copy and paste the web app URL into your browser to explore the running app and verify that it is working correctly. All of the Azure resources and application code were set up for you by the `azd up` command.
581-
582-
The name of the resource group that was created is also displayed in the console output. Locate the resource group in the Azure portal to see all of the provisioned resources.
583-
584-
:::image type="content" border="False" source="./media/tutorial-python-postgresql-app/azd-resources-small.png" lightbox="./media/tutorial-python-postgresql-app/azd-resources.png" alt-text="A screenshot showing the resources deployed by the Azure Developer CLI.":::
585-
586-
The Azure Developer CLI also enables you to configure your application to use a CI/CD pipeline for deployments, setup monitoring functionality, and even remove the provisioned resources if you want to tear everything down. For more information about these additional workflows, visit the project [README](https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app/blob/main/README.md).
587-
588-
## Explore the completed azd project template workflow
589-
590-
The sections ahead review the steps that `azd` handled for you in more depth. You can explore this workflow to better understand the requirements for deploying your own apps to Azure. When you ran `azd up`, the Azure Developer CLI completed the following steps:
591-
592-
> [!NOTE]
593-
> You can also use the steps outlined in the **Azure portal** version of this flow to gain additional insights into the tasks that `azd` completed for you.
594-
595-
### 1. Cloned and initialized the project
596-
597-
The `azd init` command cloned the sample app project template to your machine. The project template includes the following components:
598-
599-
* **Source code**: The code and assets for a Flask or Django web app that can be used for local development or deployed to Azure.
600-
* **Bicep files**: Infrastructure as code (IaC) files that are used by `azd` to create the necessary resources in Azure.
601-
* **Configuration files**: Essential configuration files such as `azure.yaml` that are used by `azd` to provision, deploy and wire resources together to produce a fully fledged application.
602-
603-
### 2. Provisioned the Azure resources
604-
605-
The `azd up` command created all of the resources for the sample application in Azure using the Bicep files in the [`infra`](https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app/tree/main/infra) folder of the project template. [Bicep](/azure/azure-resource-manager/bicep/overview?tabs=bicep) is a declarative language used to manage Infrastructure as Code in Azure. Some of the key resources and configurations created by the template include:
606-
607-
* **Resource group**: A resource group was created to hold all of the other provisioned Azure resources. The resource group keeps your resources well organized and easier to manage. The name of the resource group is based off of the environment name you specified during the `azd up` initialization process.
608-
* **Azure Virtual Network**: A virtual network was created to enable the provisioned resources to securely connect and communicate with one another. Related configurations such as setting up a private DNS zone link were also applied.
609-
* **Azure App Service plan**: An App Service plan was created to host App Service instances. App Service plans define what compute resources are available for one or more web apps.
610-
* **Azure App Service**: An App Service instance was created in the new App Service plan to host and run the deployed application. In this case a Linux instance was created and configured to run Python apps. Additional configurations were also applied to the app service, such as setting the Postgres connection string and secret keys.
611-
* **Azure Database for PostgreSQL**: A Postgres database and server were created for the app hosted on App Service to connect to. The required admin user, network and connection settings were also configured.
612-
* **Azure Application Insights**: Application insights was set up and configured for the app hosted on the App Service. This service enables detailed telemetry and monitoring for your application.
613-
614-
You can inspect the Bicep files in the [`infra`](https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app/tree/main/infra) folder of the project to understand how each of these resources were provisioned in more detail. The `resources.bicep` file defines most of the different services created in Azure. For example, the App Service plan and App Service web app instance were created and connected using the following Bicep code:
615-
616-
### [Flask](#tab/flask)
617-
618-
```yaml
619-
resource appServicePlan 'Microsoft.Web/serverfarms@2021-03-01' = {
620-
name: '${prefix}-service-plan'
621-
location: location
622-
tags: tags
623-
sku: {
624-
name: 'B1'
625-
}
626-
properties: {
627-
reserved: true
628-
}
629-
}
630-
631-
resource web 'Microsoft.Web/sites@2022-03-01' = {
632-
name: '${prefix}-app-service'
633-
location: location
634-
tags: union(tags, { 'azd-service-name': 'web' })
635-
kind: 'app,linux'
636-
properties: {
637-
serverFarmId: appServicePlan.id
638-
siteConfig: {
639-
alwaysOn: true
640-
linuxFxVersion: 'PYTHON|3.10'
641-
ftpsState: 'Disabled'
642-
appCommandLine: 'startup.sh'
643-
}
644-
httpsOnly: true
645-
}
646-
identity: {
647-
type: 'SystemAssigned'
648-
}
649-
```
650-
651-
### [Django](#tab/django)
652-
653-
```yml
654-
resource appServicePlan 'Microsoft.Web/serverfarms@2021-03-01' = {
655-
name: '${prefix}-service-plan'
656-
location: location
657-
tags: tags
658-
sku: {
659-
name: 'B1'
660-
}
661-
properties: {
662-
reserved: true
663-
}
664-
}
665-
666-
resource web 'Microsoft.Web/sites@2022-03-01' = {
667-
name: '${prefix}-app-service'
668-
location: location
669-
tags: union(tags, { 'azd-service-name': 'web' })
670-
kind: 'app,linux'
671-
properties: {
672-
serverFarmId: appServicePlan.id
673-
siteConfig: {
674-
alwaysOn: true
675-
linuxFxVersion: 'PYTHON|3.10'
676-
ftpsState: 'Disabled'
677-
appCommandLine: 'startup.sh'
678-
}
679-
httpsOnly: true
680-
}
681-
identity: {
682-
type: 'SystemAssigned'
683-
}
684-
685-
```
686-
687-
---
688-
689-
The Azure Database for PostgreSQL was also created using the following Bicep:
690-
691-
```yml
692-
resource postgresServer 'Microsoft.DBforPostgreSQL/flexibleServers@2022-01-20-preview' = {
693-
location: location
694-
tags: tags
695-
name: pgServerName
696-
sku: {
697-
name: 'Standard_B1ms'
698-
tier: 'Burstable'
699-
}
700-
properties: {
701-
version: '12'
702-
administratorLogin: 'postgresadmin'
703-
administratorLoginPassword: databasePassword
704-
storage: {
705-
storageSizeGB: 128
706-
}
707-
backup: {
708-
backupRetentionDays: 7
709-
geoRedundantBackup: 'Disabled'
710-
}
711-
network: {
712-
delegatedSubnetResourceId: virtualNetwork::databaseSubnet.id
713-
privateDnsZoneArmResourceId: privateDnsZone.id
714-
}
715-
highAvailability: {
716-
mode: 'Disabled'
717-
}
718-
maintenanceWindow: {
719-
customWindow: 'Disabled'
720-
dayOfWeek: 0
721-
startHour: 0
722-
startMinute: 0
723-
}
724-
}
725-
726-
dependsOn: [
727-
privateDnsZoneLink
728-
]
729-
}
730-
```
731-
732-
### 3. Deployed the application
733-
734-
The `azd up` command also deployed the sample application code to the provisioned Azure resources. The Developer CLI understands how to deploy different parts of your application code to different services in Azure using the `azure.yaml` file at the root of the project. The `azure.yaml` file specifies the app source code location, the type of app, and the Azure Service that should host that app.
735-
736-
Consider the following `azure.yaml` file. These configurations tell the Azure Developer CLI that the Python code that lives at the root of the project should be deployed to the created App Service.
737-
738-
### [Flask](#tab/flask)
739-
740-
```yml
741-
name: flask-postgresql-sample-app
742-
metadata:
743-
744-
services:
745-
web:
746-
project: .
747-
language: py
748-
host: appservice
749-
```
750-
751-
### [Django](#tab/django)
752-
753-
```yml
754-
name: django-postgresql-sample-app
755-
metadata:
756-
757-
services:
758-
web:
759-
project: .
760-
language: py
761-
host: appservice
762-
```
763-
764-
---
765-
766-
## Remove the resources
767-
768-
Once you are finished experimenting with your sample application, you can run the `azd down` command to remove the app from Azure. Removing resources helps to avoid unintended costs or unused services in your Azure subscription.
769-
770-
```bash
771-
azd down
772-
```
773-
774-
:::zone-end
775-
776519
## Frequently asked questions
777520

778521
- [How much does this setup cost?](#how-much-does-this-setup-cost)

articles/azure-arc/servers/includes/network-requirements.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ The table below lists the URLs that must be available in order to install and us
5555
|`*.waconazure.com`|For Windows Admin Center connectivity|If using Windows Admin Center|Public|
5656
|`*.blob.core.windows.net`|Download source for Azure Arc-enabled servers extensions|Always, except when using private endpoints| Not used when private link is configured |
5757
|`dc.services.visualstudio.com`|Agent telemetry|Optional, not used in agent versions 1.24+| Public |
58-
| `san-af-<region>-prod.azurewebsites.net` | Azure Arc data processing service | For Azure Arc-enabled SQL Server. The Azure Extension for SQL Server uploads inventory and billing information to the data processing service. | Outbound |
58+
| `san-af-<region>-prod.azurewebsites.net` | Azure Arc data processing service | For Azure Arc-enabled SQL Server. The Azure Extension for SQL Server uploads inventory and billing information to the data processing service. | Public |
5959

6060
> [!NOTE]
6161
> To translate the `*.servicebus.windows.net` wildcard into specific endpoints, use the command `\GET https://guestnotificationservice.azure.com/urls/allowlist?api-version=2020-01-01&location=<region>`. Within this command, the region must be specified for the `<region>` placeholder.

articles/azure-maps/web-sdk-migration-guide.md

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ If you're using CDN ([content delivery network]), update the references to the s
3939

4040
### npm
4141

42-
Install the latest [npm] package using the following command:
42+
If you're using [npm], update the to the latest Azure Maps control by running the following command:
4343

4444
```shell
4545
npm install azure-maps-control@latest
@@ -59,10 +59,18 @@ Consider a gradual rollout strategy for the updated version. Release the migrate
5959

6060
By following these steps and considering best practices, you can successfully migrate your application from Azure Maps WebSDK v1 to v3. Embrace the new capabilities and improvements offered by the latest version while ensuring a smooth and seamless transition for your users. For more information, see [Azure Maps Web SDK best practices].
6161

62+
## Next steps
63+
64+
Learn more about the Azure Maps Power BI visual:
65+
66+
> [!div class="nextstepaction"]
67+
> [Use the Azure Maps map control]
68+
6269
[Azure Active Directory Authentication]: how-to-secure-spa-users.md
6370
[Azure Maps Web SDK best practices]: web-sdk-best-practices.md
6471
[content delivery network]: /azure/cdn/cdn-overview
6572
[Manage Authentication in Azure Maps]: how-to-manage-authentication.md
6673
[npm]: https://www.npmjs.com/package/azure-maps-control
6774
[release notes]: release-notes-map-control.md
6875
[Shared Key Authentication]: how-to-secure-sas-app.md
76+
[Use the Azure Maps map control]: how-to-use-map-control.md

articles/azure-monitor/app/availability-azure-functions.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,12 @@
22
title: Review TrackAvailability() test results
33
description: This article explains how to review data logged by TrackAvailability() tests
44
ms.topic: conceptual
5-
ms.date: 06/23/2023
5+
ms.date: 08/20/2023
66
---
77

88
# Review TrackAvailability() test results
99

10-
This article explains how to review [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) test results in the Azure portal and query the data using [Log Analytics](../logs/log-analytics-overview.md#overview-of-log-analytics-in-azure-monitor).
10+
This article explains how to review [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) test results in the Azure portal and query the data using [Log Analytics](../logs/log-analytics-overview.md#overview-of-log-analytics-in-azure-monitor). [Standard tests](availability-standard-tests.md) **should always be used if possible** as they require little investment, no maintenance, and have few prerequisites.
1111

1212
## Prerequisites
1313

@@ -16,9 +16,8 @@ This article explains how to review [TrackAvailability()](/dotnet/api/microsoft.
1616
> - Access to the source code of a [function app](../../azure-functions/functions-how-to-use-azure-function-app-settings.md) in Azure Functions
1717
> - Developer expertise capable of authoring [custom code](#basic-code-sample) for [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability), tailored to your specific business needs
1818
19-
> [!NOTE]
20-
> - [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) requires that you make a developer investment in custom code.
21-
> - [Standard tests](availability-standard-tests.md) **should always be used if possible** as they require little investment, no maintenance, and have few prerequisites.
19+
> [!IMPORTANT]
20+
> [TrackAvailability()](/dotnet/api/microsoft.applicationinsights.telemetryclient.trackavailability) requires making a developer investment in writing and maintanining potentially complex custom code.
2221
2322
## Check availability
2423

articles/azure-monitor/app/codeless-overview.md

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,17 @@ ms.reviewer: abinetabate
99

1010
# What is autoinstrumentation for Azure Monitor Application Insights?
1111

12-
Autoinstrumentation quickly and easily enables [Application Insights](app-insights-overview.md) to make [telemetry](data-model-complete.md) like metrics, requests, and dependencies available in your [Application Insights resource](create-workspace-resource.md).
12+
Autoinstrumentation enables [Application Insights](app-insights-overview.md) to make [telemetry](data-model-complete.md) like metrics, requests, and dependencies available in your [Application Insights resource](create-workspace-resource.md). It provides easy access to experiences such as the [application dashboard](overview-dashboard.md) and [application map](app-map.md).
13+
14+
If your language and platform are supported, select the corresponding link in the [Supported environments, languages, and resource providers table](#supported-environments-languages-and-resource-providers) for more detailed information. In many cases, autoinstrumentation is enabled by default.
15+
16+
## What are the autoinstrumentation advantages?
1317

1418
> [!div class="checklist"]
15-
> - No code changes are required.
16-
> - [SDK update](sdk-support-guidance.md) overhead is eliminated.
17-
> - Recommended when available.
19+
> - Code changes aren't required.
20+
> - Access to source code isn't required.
21+
> - Configuration changes aren't required.
22+
> - Ongoing [SDK update maintenance](sdk-support-guidance.md) is eliminated.
1823
1924
## Supported environments, languages, and resource providers
2025

articles/azure-monitor/containers/monitor-kubernetes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ The sections below identify the steps for complete monitoring of your Kubernetes
9393
#### Enable scraping of Prometheus metrics
9494

9595
> [!IMPORTANT]
96-
> Azure Monitor managed service for Prometheus requires an [Azure Monitor workspace](../essentials/azure-monitor-workspace-overview.md) to support Azure Monitor managed service for Prometheus. For information on design considerations for a workspace configuration, see [Azure Monitor workspace architecture](../essentials/azure-monitor-workspace-overview.md#azure-monitor-workspace-architecture).
96+
> To use Azure Monitor managed service for Prometheus, you need to have an [Azure Monitor workspace](../essentials/azure-monitor-workspace-overview.md). For information on design considerations for a workspace configuration, see [Azure Monitor workspace architecture](../essentials/azure-monitor-workspace-overview.md#azure-monitor-workspace-architecture).
9797
9898
Enable scraping of Prometheus metrics by Azure Monitor managed service for Prometheus from your cluster using one of the following methods:
9999

0 commit comments

Comments
 (0)