Skip to content

Commit 035f382

Browse files
cmcclisterKarlErickson
cmcclister
and
KarlErickson
authored
LinkFix: azure-dev-docs-pr (2022-07) (#3314)
* LinkFix: azure-dev-docs-pr (2022-07) * Update reference.md * Apply suggestions from code review Co-authored-by: Karl Erickson <karler@microsoft.com>
1 parent 0bf5462 commit 035f382

15 files changed

+37
-37
lines changed

‎articles/azure-developer-cli/faq.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ sections:
7373
7474
You can also go to https://portal.azure.com and then look for your resource group, which is `<your-environment-name>-rg`. If any of the deployments fail, select the error link to get more information.
7575
76-
For other resources, see [Troubleshoot common Azure deployment errors - Azure Resource Manager](https://docs.microsoft.com/azure/azure-resource-manager/troubleshooting/common-deployment-errors).
76+
For other resources, see [Troubleshoot common Azure deployment errors - Azure Resource Manager](/azure/azure-resource-manager/troubleshooting/common-deployment-errors).
7777
7878
- question: Is there a log file for `azd provision`?
7979
answer: |
@@ -89,7 +89,7 @@ sections:
8989
questions:
9090
- question: Can I rerun `azd up`?
9191
answer: |
92-
Yes. We use the [incremental deployment mode](https://docs.microsoft.com/azure/azure-resource-manager/templates/deployment-modes).
92+
Yes. We use the [incremental deployment mode](/azure/azure-resource-manager/templates/deployment-modes).
9393
9494
- question: How do I find the log file for `azd up`?
9595
answer: |
@@ -99,7 +99,7 @@ sections:
9999
questions:
100100
- question: What is an Azure service principal?
101101
answer: |
102-
An Azure service principal is an identity that's created for use with apps, hosted services, and automated tools to access Azure resources. This access is restricted by the roles that are assigned to the service principal, which gives you control over which resources can be accessed and at which level. For more information about authenticating from Azure to GitHub, see [Connect GitHub and Azure | Microsoft Docs](https://docs.microsoft.com/azure/developer/github/connect-from-azure?tabs=azure-portal%2Cwindows#use-the-azure-login-action-with-a-service-principal-secret).
102+
An Azure service principal is an identity that's created for use with apps, hosted services, and automated tools to access Azure resources. This access is restricted by the roles that are assigned to the service principal, which gives you control over which resources can be accessed and at which level. For more information about authenticating from Azure to GitHub, see [Connect GitHub and Azure | Microsoft Docs](../github/connect-from-azure.md?tabs=azure-portal%2cwindows#use-the-azure-login-action-with-a-service-principal-secret).
103103
104104
- question: Do I need to create an Azure service principal before I run `azd pipeline config`?
105105
answer: |
@@ -137,4 +137,4 @@ sections:
137137
138138
- question: Where can I find the log for the GitHub Actions job that I triggered when I ran `azd pipeline config`?
139139
answer: |
140-
Go to `https://github.com/<your-GH-account>/<your-repo>/actions`, and then refer to the log file in the workflow run.
140+
Go to `https://github.com/<your-GH-account>/<your-repo>/actions`, and then refer to the log file in the workflow run.

‎articles/azure-developer-cli/overview.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ This list is grouped by supported language. Each repository contains a complete
6060

6161
## Azure Developer CLI vs Azure CLI
6262

63-
[Azure Developer CLI (azd)](/azure/developer/azure-developer-cli) and [Azure CLI](/cli/azure/what-is-azure-cli) are both command-line tools.
63+
[Azure Developer CLI (azd)](./index.yml) and [Azure CLI](/cli/azure/what-is-azure-cli) are both command-line tools.
6464

6565
However, they help you do different tasks.
6666

@@ -104,4 +104,4 @@ Currently supported/planned languages:
104104
## Next steps
105105

106106
> [!div class="nextstepaction"]
107-
> [Get started using Azure Developer CLI (azd)](get-started.md)
107+
> [Get started using Azure Developer CLI (azd)](get-started.md)

‎articles/azure-developer-cli/reference.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ azd deploy
3737
azd monitor --overview
3838
```
3939

40-
For more information, visit the [Azure Developer CLI Dev Hub](https://aka.ms/azure-dev/devhub).
40+
For more information, visit the [Azure Developer CLI Dev Hub](./overview.md).
4141

4242
### Options
4343

@@ -516,7 +516,7 @@ azd monitor -–live
516516
azd monitor --logs
517517
```
518518

519-
For more information, go to [https://aka.ms/azure-dev/monitor](https://aka.ms/azure-dev/monitor).
519+
For more information, see [Monitor your app using Azure Developer CLI (azd)](./monitor-your-app.md).
520520

521521
```
522522
azd monitor [flags]
@@ -554,7 +554,7 @@ Manage GitHub Actions pipelines.
554554

555555
The Azure Developer CLI template includes a GitHub Actions pipeline configuration file (in the `.github/workflows` directory) that deploys your app whenever code is pushed to the main branch.
556556

557-
For more information, go to [https://aka.ms/azure-dev/pipeline](https://aka.ms/azure-dev/pipeline).
557+
For more information, see [Configure a pipeline and push updates using GitHub Actions](./configure-devops-pipeline.md).
558558

559559
### Options
560560

@@ -584,7 +584,7 @@ Create and configure your deployment pipeline by using GitHub Actions.
584584

585585
Create and configure your deployment pipeline by using GitHub Actions.
586586

587-
For more information, go to [https://aka.ms/azure-dev/pipeline](https://aka.ms/azure-dev/pipeline).
587+
For more information, see [Configure a pipeline and push updates using GitHub Actions](./configure-devops-pipeline.md).
588588

589589
```
590590
azd pipeline config [flags]
@@ -664,7 +664,7 @@ Restore app dependencies.
664664

665665
Run this command to download and install all the required libraries so that you can build, run, and debug the app locally.
666666

667-
For the best local run and debug experience, see [Debug by using the Visual Studio Code extension](https://aka.ms/azure-dev/vscode).
667+
For the best local run and debug experience, see [Debug by using the Visual Studio Code extension](./debug.md?pivots=ide-vs-code).
668668

669669
```
670670
azd restore [flags]

‎articles/github/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -53,11 +53,11 @@ landingContent:
5353
- linkListType: deploy
5454
links:
5555
- text: What is Azure Developer CLI?
56-
url: /azure/developer/azure-developer-cli/overview
56+
url: ../azure-developer-cli/overview.md
5757
- text: Get started
58-
url: /azure/developer/azure-developer-cli/get-started
58+
url: ../azure-developer-cli/get-started.md
5959
- text: See more in the Azure Developer CLI developer center
60-
url: /azure/developer/azure-developer-cli/
60+
url: ../azure-developer-cli/index.yml
6161

6262
# Card (optional)
6363
# - title: Visual Studio and Visual Studio Code
@@ -81,4 +81,4 @@ landingContent:
8181
- linkListType: get-started
8282
links:
8383
- text: Manage Azure Policies as code with GitHub
84-
url: manage-azure-policy.md
84+
url: manage-azure-policy.md

‎articles/index.yml

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ productDirectory:
4848
links:
4949
- url: /azure/azure-functions/create-first-function-vs-code-python
5050
text: Deploy serverless Python apps to Azure Functions
51-
- url: ./python/tutorial-deploy-app-service-on-linux-01.md
51+
- url: ./python/configure-python-web-app-local-environment.md
5252
text: Deploy Python apps to Azure App Service
5353
- url: /azure/storage/blobs/storage-quickstart-blobs-python
5454
text: Manage storage blobs with the Azure SDK for Python
@@ -164,11 +164,11 @@ productDirectory:
164164
- title: Azure Developer CLI (azd) Preview
165165
imageSrc: https://static.docs.com/ui/media/product/azure/azure-developer-cli.svg
166166
links:
167-
- url: /azure/developer/azure-developer-cli/overview
167+
- url: ./azure-developer-cli/overview.md
168168
text: What is Azure Developer CLI
169-
- url: /azure/developer/azure-developer-cli/get-started
169+
- url: ./azure-developer-cli/get-started.md
170170
text: Get started
171-
- url: /azure/developer/azure-developer-cli/
171+
- url: ./azure-developer-cli/index.yml
172172
text: See more in the Azure Developer CLI developer center
173173
#tools:
174174
#conceptualContent:

‎articles/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ ms.custom: devx-track-java
1313

1414
This article shows you how to configure a Java-based Spring Cloud Stream Binder to use [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs. In this article, you'll create the project by using Spring Initializr and deploy to Azure Spring Apps using Managed Identity.
1515

16-
By using [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs, you can take advantage of Spring Cloud Azure to use various types of credentials for authentication. For more information, see [Spring Cloud Azure authentication](/azure/developer/java/spring-framework/spring-cloud-azure?tabs=maven#spring-cloud-azure-authentication).
16+
By using [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs, you can take advantage of Spring Cloud Azure to use various types of credentials for authentication. For more information, see [Spring Cloud Azure authentication](./spring-cloud-azure.md?tabs=maven#spring-cloud-azure-authentication).
1717

1818
## Prerequisites
1919

@@ -369,4 +369,4 @@ For more information about Azure support for event hub Stream Binder and Apache
369369

370370
For more information about using Azure with Java, see the [Azure for Java Developers] and the [Working with Azure DevOps and Java](/azure/devops/).
371371

372-
The [Spring Framework](https://spring.io/) is an open-source solution that helps Java developers create enterprise-level applications. One of the more-popular projects that is built on top of that platform is [Spring Boot](https://spring.io/projects/spring-boot/), which provides a simplified approach for creating stand-alone Java applications. To help developers get started with Spring Boot, several sample Spring Boot packages are available in the [Spring Guides](https://github.com/spring-guides) collection of repositories on GitHub. In addition to choosing from the list of basic Spring Boot projects, the [Spring Initializr](https://start.spring.io/) helps developers get started with creating custom Spring Boot applications.
372+
The [Spring Framework](https://spring.io/) is an open-source solution that helps Java developers create enterprise-level applications. One of the more-popular projects that is built on top of that platform is [Spring Boot](https://spring.io/projects/spring-boot/), which provides a simplified approach for creating stand-alone Java applications. To help developers get started with Spring Boot, several sample Spring Boot packages are available in the [Spring Guides](https://github.com/spring-guides) collection of repositories on GitHub. In addition to choosing from the list of basic Spring Boot projects, the [Spring Initializr](https://start.spring.io/) helps developers get started with creating custom Spring Boot applications.

‎articles/java/spring-framework/includes/spring-cloud-azure/kafka-support.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -65,7 +65,7 @@ The following list shows all supported configuration options.
6565
- Prefix: `spring.cloud.azure`
6666
- Supported options: `spring.cloud.azure.credential.*`, `spring.cloud.azure.profile.*`
6767

68-
For the full list of global configuration options, see the [Global properties](/azure/developer/java/spring-framework/spring-cloud-azure-appendix#global-properties) section.
68+
For the full list of global configuration options, see the [Global properties](../../spring-cloud-azure-appendix.md#global-properties) section.
6969

7070
- Spring Boot Kafka common configuration
7171

@@ -317,4 +317,4 @@ spring:
317317
318318
### Samples
319319
320-
See the [azure-spring-boot-samples](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/spring-cloud-azure_4.3.0) repository on GitHub.
320+
See the [azure-spring-boot-samples](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/spring-cloud-azure_4.3.0) repository on GitHub.

‎articles/lab/includes/python-tutorial-multipage/intro.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,4 +9,4 @@ ms.custom: devx-track-javascript
99
In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
1010

1111
> [!TIP]
12-
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../../../python/tutorial-deploy-app-service-on-linux-01.md)**.
12+
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../../../python/configure-python-web-app-local-environment.md)**.

‎articles/lab/quickstart-python-flask-minimized.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ robots: noindex
1212
In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
1313

1414
> [!TIP]
15-
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/tutorial-deploy-app-service-on-linux-01.md)**.
15+
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/configure-python-web-app-local-environment.md)**.
1616
1717
<details>
1818
<summary >1. Set up your initial environment</summary>

‎articles/lab/quickstart-python-flask.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ robots: noindex
1212
In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
1313

1414
> [!TIP]
15-
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/tutorial-deploy-app-service-on-linux-01.md)**.
15+
> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/configure-python-web-app-local-environment.md)**.
1616
1717
## 1. Set up your initial environment
1818

@@ -235,4 +235,4 @@ The `--no-wait` argument allows the command to return before the operation is co
235235
> [Add user sign-in to a Python web app](/azure/active-directory/develop/quickstart-v2-python-webapp)
236236
237237
> [!div class="nextstepaction"]
238-
> [Tutorial: Run Python app in custom container](/azure/app-service/tutorial-custom-container)
238+
> [Tutorial: Run Python app in custom container](/azure/app-service/tutorial-custom-container)

‎articles/python/configure-python-web-app-local-environment.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ In Python web app development, you often work with Python-based web frameworks.
127127

128128
Three common Python web frameworks are [Django](https://www.djangoproject.com/), [Flask](https://flask.palletsprojects.com/en/2.1.x/), or [FastAPI](https://fastapi.tiangolo.com/). These and other web frameworks can be used with Azure.
129129

130-
Below is an example of how you might get started quickly with these frameworks locally. Running these commands, you'll end up with an application, albeit a simple one that could be deployed to Azure. Run these commands inside a [virtual environment](/azure/developer/python/configure-local-development-environment#configure-python-virtual-environment).
130+
Below is an example of how you might get started quickly with these frameworks locally. Running these commands, you'll end up with an application, albeit a simple one that could be deployed to Azure. Run these commands inside a [virtual environment](./configure-local-development-environment.md#configure-python-virtual-environment).
131131

132132
**Step 1:** Download the frameworks with [pip](https://pip.pypa.io/en/stable/cli/pip_install/).
133133
### [Django](#tab/django)
@@ -255,4 +255,4 @@ At this point, add a *requirements.txt* file and then you can deploy the web app
255255

256256
* [Quickstart: Create a Python (Django or Flask) web app in Azure App Service](/azure/app-service/quickstart-python).
257257
* [Tutorial: Deploy a Python (Django or Flask) web app with PostgreSQL in Azure](/azure/app-service/tutorial-python-postgresql-app)
258-
* [Tutorial: Deploy a Python web app to Azure with managed identity](./tutorial-python-managed-identity-01.md)
258+
* [Tutorial: Deploy a Python web app to Azure with managed identity](./tutorial-python-managed-identity-01.md)

‎articles/python/index.yml

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ landingContent:
3535
- linkListType: deploy
3636
links:
3737
- text: Flask using Visual Studio Code
38-
url: tutorial-deploy-app-service-on-linux-01.md
38+
url: ./configure-python-web-app-local-environment.md
3939
- text: Flask using CLI
4040
url: /azure/app-service/quickstart-python?toc=/azure/developer/python/toc.json&bc=/azure/developer/breadcrumb/toc.json
4141
- text: Python (Django or Flask) + PostgreSQL
@@ -95,4 +95,4 @@ landingContent:
9595
- text: Windows Subsystem for Linux (WSL)
9696
url: /windows/wsl/install-win10
9797
- text: Visual Studio (for Python/C++ development)
98-
url: /visualstudio/python/installation
98+
url: /visualstudio/python/installation

‎articles/python/tutorial-python-managed-identity-01.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ Each article in the tutorial covers a part or service shown in the service diagr
2020

2121
## How managed identity is used
2222

23-
Managed identity provides an identity for your app so that it can connect to Azure resources without the need to use a secret key or other application secret. Internally, Azure knows the identity of your app and what resources it's allowed to connect to. Managed identity is the recommended approach to authenticate an app in Azure when using the Azure SDK for Python as is shown in this tutorial. For more information about authentication in Azure with Python, see [How to authenticate Python apps to Azure services using the Azure SDK for Python](/azure/developer/python/sdk/authentication-overview).
23+
Managed identity provides an identity for your app so that it can connect to Azure resources without the need to use a secret key or other application secret. Internally, Azure knows the identity of your app and what resources it's allowed to connect to. Managed identity is the recommended approach to authenticate an app in Azure when using the Azure SDK for Python as is shown in this tutorial. For more information about authentication in Azure with Python, see [How to authenticate Python apps to Azure services using the Azure SDK for Python](./sdk/authentication-overview.md).
2424

2525
The sample Python app code doesn't change between the local development and Azure-hosted environments. Using the same code is possible because the [DefaultAzureCredential](/python/api/azure-identity/azure.identity.defaultazurecredential) is used, which handles both authentication scenarios as shown in the following diagram.
2626

@@ -101,4 +101,4 @@ When deployed, restaurants and review data are stored in Azure Database for Post
101101
## Next step
102102

103103
> [!div class="nextstepaction"]
104-
> [Run the web app locally >>>](./tutorial-python-managed-identity-02.md)
104+
> [Run the web app locally >>>](./tutorial-python-managed-identity-02.md)

0 commit comments

Comments
 (0)