Skip to content

Commit 4db6698

Browse files
committed
[ACA] Add portal instructions for AFD integration.
1 parent d8b5e44 commit 4db6698

File tree

4 files changed

+158
-31
lines changed

4 files changed

+158
-31
lines changed

articles/container-apps/how-to-integrate-with-azure-front-door.md

Lines changed: 132 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -6,20 +6,137 @@ author: craigshoemaker
66
ms.service: azure-container-apps
77
ms.custom: devx-track-azurepowershell, devx-track-azurecli, ignite-2024
88
ms.topic: how-to
9-
ms.date: 02/03/2025
9+
ms.date: 02/20/2025
1010
ms.author: cshoe
11+
zone_pivot_groups: azure-cli-or-portal
1112
---
1213

1314
# Create a private link to an Azure Container App with Azure Front Door (preview)
1415

1516
In this article, you learn how to connect directly from Azure Front Door to your Azure Container Apps using a private link instead of the public internet. In this tutorial, you create an Azure Container Apps workload profiles environment, an Azure Front Door, and connect them securely through a private link. You then verify the connectivity between your container app and the Azure Front Door.
1617

18+
::: zone pivot="azure-portal"
19+
20+
## Prerequisites
21+
22+
- Azure account with an active subscription.
23+
- If you don't have one, you [can create one for free](https://azure.microsoft.com/free/).
24+
25+
- This feature is only supported for workload profile environments.
26+
27+
## Create a container app
28+
29+
Create a resource group to organize the services related to your container app deployment.
30+
31+
Begin by signing in to the [Azure portal](https://portal.azure.com).
32+
33+
1. Search for **Container Apps** in the top search bar.
34+
1. Select **Container Apps** in the search results.
35+
1. Select the **Create** button.
36+
37+
1. In the *Create Container App* page, in the *Basics* tab, enter the following values.
38+
39+
| Setting | Action |
40+
|---|---|
41+
| Subscription | Select your Azure subscription. |
42+
| Resource group | Select the **Create new resource group** link and enter **my-container-apps**. |
43+
| Container app name | Enter **my-container-app**. |
44+
| Deployment source | Select **Container image**. |
45+
| Region | Select **Central US**. |
46+
47+
1. In the *Create Container Apps Environment* field, select the **Create new environment** link.
48+
49+
1. In the *Create Container Apps Environment* page, in the *Basics* tab, enter the following values:
50+
51+
| Setting | Value |
52+
|--|--|
53+
| Environment name | Enter **my-environment**. |
54+
| Zone redundancy | Select **Disabled** |
55+
56+
1. Select the **Networking** tab.
57+
58+
1. Set *Public Network Access* to **Disable: Block all incoming traffic from the public internet.**
59+
60+
1. Leave **Use your own virtual network** set to **No**.
61+
62+
1. Leave **Enable private endpoints** set to **No**.
63+
64+
1. Select **Create**.
65+
66+
1. In the *Create Container App* page, select the **Container** tab.
67+
68+
1. Select **Use quickstart image**.
69+
70+
<!-- Deploy the container app -->
71+
[!INCLUDE [container-apps-create-portal-deploy.md](../../includes/container-apps-create-portal-deploy.md)]
72+
73+
1. When you browse to the container app endpoint, you see the following message:
74+
75+
```
76+
The public network access on this managed environment is disabled. To connect to this managed environment, please use the Private Endpoint from inside your virtual network. To learn more https://aka.ms/PrivateEndpointTroubleshooting.
77+
```
78+
79+
Instead, you use an AFD endpoint to access your container app.
80+
81+
## Create an Azure Front Door profile
82+
83+
1. Search for **Front Door** in the top search bar.
84+
1. Select **Front Door and CDN profiles** in the search results.
85+
1. Select **Azure Front Door** and **Quick Create**.
86+
1. Select the **Continue to create a Front Door** button.
87+
88+
1. In the *Create a Front Door profile* page, in the *Basics* tab, do the following.
89+
90+
1. Under the **Subscription** field, you might see the error `Microsoft.Cdn is not registered for the subscription.`. To resolve this:
91+
1. Browse to your subscription page and select **Settings** > **Resource providers**.
92+
1. Select **Microsoft.Cdn** from the provider list.
93+
1. Select **Register**.
94+
95+
1. For *Resource group*, select **my-container-apps**.
96+
97+
1. For *Name*, enter **my-afd-profile**.
98+
99+
1. Set *Tier* to **Premium**. Private link is not supported for origins in an AFD profile on the Standard tier.
100+
101+
1. Set *Endpoint name* to **my-afd-endpoint**.
102+
103+
1. Set *Origin type* to **Container Apps**.
104+
105+
1. Set *Origin host name* to the hostname of your container app. Your hostname looks like the following example: `my-container-app.orangeplant-77e5875b.centralus.azurecontainerapps.io`.
106+
107+
1. Select **Enable private link service**.
108+
109+
1. Set *Region* to **(US) Central US**.
110+
111+
1. Set *Target sub resource* to **managedEnvironments**.
112+
113+
1. In the *Request message* field, enter **AFD Private Link Request**.
114+
115+
1. Select **Review + create**.
116+
117+
118+
119+
## Clean up resources
120+
121+
If you're not going to continue to use this application, you can delete the container app and all the associated services by removing the resource group.
122+
123+
1. Select the **my-container-apps** resource group from the *Overview* section.
124+
1. Select the **Delete resource group** button at the top of the resource group *Overview*.
125+
1. Enter the resource group name **my-container-apps** in the *Are you sure you want to delete "my-container-apps"* confirmation dialog.
126+
1. Select **Delete**.
127+
128+
The process to delete the resource group could take a few minutes to complete.
129+
130+
::: zone-end
131+
132+
::: zone pivot="azure-cli"
133+
17134
## Prerequisites
18135
19136
- Azure account with an active subscription.
20137
- If you don't have one, you [can create one for free](https://azure.microsoft.com/free/).
21138
22-
- This feature is only available with the [Azure CLI](/cli/azure/install-azure-cli). To ensure you're running the latest version of the Azure CLI, run the following command.
139+
- To ensure you're running the latest version of the [Azure CLI](/cli/azure/install-azure-cli), run the following command.
23140
24141
```azurecli
25142
az upgrade
@@ -119,11 +236,17 @@ az group create \
119236
--output tsv)
120237
```
121238
122-
If you browse to the container app endpoint, you receive `ERR_CONNECTION_CLOSED` because the container app environment has public access disabled. Instead, you use an AFD endpoint to access your container app.
239+
1. When you browse to the container app endpoint, you receive `ERR_CONNECTION_CLOSED` because the container app environment has public access disabled. Instead, you use an AFD endpoint to access your container app.
123240
124241
## Create an Azure Front Door profile
125242
126-
Create an AFD profile. Private link is not supported for origins in an AFD profile with SKU `Standard_AzureFrontDoor`.
243+
1. Make sure the `Microsoft.Cdn` resource provider is registered for your subscription.
244+
245+
```azurecli
246+
az provider register --namespace Microsoft.Cdn
247+
```
248+
249+
1. Create an AFD profile. Private link is not supported for origins in an AFD profile with SKU `Standard_AzureFrontDoor`.
127250

128251
```azurecli
129252
az afd profile create \
@@ -265,6 +388,11 @@ If you're not going to continue to use this application, you can remove the **my
265388
az group delete --name $RESOURCE_GROUP
266389
```
267390

391+
::: zone-end
392+
393+
> [!TIP]
394+
> Having issues? Let us know on GitHub by opening an issue in the [Azure Container Apps repo](https://github.com/microsoft/azure-container-apps).
395+
268396
## Related content
269397

270398
- [Azure Private Link](/azure/private-link/private-link-overview)

articles/container-apps/how-to-use-private-endpoint.md

Lines changed: 14 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -34,28 +34,28 @@ Begin by signing in to the [Azure portal](https://portal.azure.com).
3434
1. Select **Container Apps** in the search results.
3535
1. Select the **Create** button.
3636

37-
1. In the *Create Container App* page on the *Basics* tab, enter the following values.
37+
1. In the *Create Container App* page, in the *Basics* tab, enter the following values.
3838

3939
| Setting | Action |
4040
|---|---|
4141
| Subscription | Select your Azure subscription. |
42-
| Resource group | Select **Create new** and enter **my-container-apps**. |
42+
| Resource group | Select the **Create new resource group** link and enter **my-container-apps**. |
4343
| Container app name | Enter **my-container-app**. |
4444
| Deployment source | Select **Container image**. |
4545
| Region | Select **Central US**. |
4646

47-
1. In the *Create Container Apps Environment* field, select the **Create new** link.
47+
1. In the *Create Container Apps Environment* field, select the **Create new environment** link.
4848

49-
1. In the *Create Container Apps Environment* page on the *Basics* tab, enter the following values:
49+
1. In the *Create Container Apps Environment* page, in the *Basics* tab, enter the following values:
5050

5151
| Setting | Value |
5252
|--|--|
5353
| Environment name | Enter **my-environment**. |
5454
| Zone redundancy | Select **Disabled** |
5555

56-
1. Select the **Networking** tab to create a virtual network (VNet). By default, public network access is enabled, which means private endpoints are disabled.
56+
1. Select the **Networking** tab.
5757

58-
1. Disable public network access.
58+
1. Set *Public Network Access* to **Disable: Block all incoming traffic from the public internet.** By default, public network access is enabled, which means private endpoints are disabled.
5959

6060
1. Leave **Use your own virtual network** set to **No**.
6161
You can use an existing VNet, but private endpoints are only supported by workload profiles environments, which require a subnet with a minimum CIDR range of `/27` or larger. To learn more about subnet sizing, see the [networking architecture overview](./networking.md#subnet).
@@ -76,21 +76,18 @@ Begin by signing in to the [Azure portal](https://portal.azure.com).
7676

7777
1. Select **Create**.
7878

79-
1. In the *Create Container App* page on the *Basics* tab, select **Next : Container >**.
79+
1. In the *Create Container App* page, select the **Container** tab.
8080

81-
1. In the *Create Container App* page on the *Container* tab, select **Use quickstart image**.
81+
1. Select **Use quickstart image**.
8282

83-
1. Select **Review and create** at the bottom of the page.
83+
<!-- Deploy the container app -->
84+
[!INCLUDE [container-apps-create-portal-deploy.md](../../includes/container-apps-create-portal-deploy.md)]
8485

85-
If no errors are found, the *Create* button is enabled.
86+
1. When you browse to the container app endpoint, you see the following message:
8687

87-
If there are errors, any tab containing errors is marked with a red dot. Navigate to the appropriate tab. Fields containing an error are highlighted in red. Once all errors are fixed, select **Review and create** again.
88-
89-
1. Select **Create**.
90-
91-
A page with the message *Deployment is in progress* is displayed. Once the deployment is successfully completed, you see the message: *Your deployment is complete*.
92-
93-
When you browse to the container app endpoint, you receive `ERR_CONNECTION_CLOSED` because your container app environment has public access disabled. Instead, you access your container app using your private endpoint.
88+
```
89+
The public network access on this managed environment is disabled. To connect to this managed environment, please use the Private Endpoint from inside your virtual network. To learn more https://aka.ms/PrivateEndpointTroubleshooting.
90+
```
9491
9592
::: zone-end
9693

articles/container-apps/quickstart-portal.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -58,18 +58,14 @@ In the *Basics* tab, do the following actions.
5858

5959
1. Select the **Container** tab.
6060

61-
1. Select *Use quickstart image*.
61+
1. Select **Use quickstart image**.
6262

6363
<!-- Deploy the container app -->
6464
[!INCLUDE [container-apps-create-portal-deploy.md](../../includes/container-apps-create-portal-deploy.md)]
6565

66-
### Verify deployment
66+
1. The following message appears in your browser.
6767

68-
Select **Go to resource** to view your new container app.
69-
70-
Select the link next to *Application URL* to view your application. The following message appears in your browser.
71-
72-
:::image type="content" source="media/get-started/azure-container-apps-quickstart.png" alt-text="Your first Azure Container Apps deployment.":::
68+
:::image type="content" source="media/get-started/azure-container-apps-quickstart.png" alt-text="Your first Azure Container Apps deployment.":::
7369

7470
## Clean up resources
7571

includes/container-apps-create-portal-deploy.md

Lines changed: 9 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
author: craigshoemaker
33
ms.service: azure-container-apps
44
ms.topic: include
5-
ms.date: 01/10/2024
5+
ms.date: 02/20/2025
66
ms.author: cshoe
77
---
88

@@ -12,8 +12,14 @@ ms.author: cshoe
1212

1313
If no errors are found, the *Create* button is enabled.
1414

15-
If there are errors, any tab containing errors is marked with a red dot. Navigate to the appropriate tab. Fields containing an error are highlighted in red. Once all errors are fixed, select **Review and create** again.
15+
If there are errors, any tab containing errors is marked with a red dot. Navigate to the appropriate tab. Fields containing an error are highlighted in red. Once all errors are fixed, select **Review and create** again.
1616

1717
1. Select **Create**.
1818

19-
A page with the message *Deployment is in progress* is displayed. Once the deployment is successfully completed, you see the message: *Your deployment is complete*.
19+
A page with the message *Deployment is in progress* is displayed. Once the deployment is successfully completed, you see the message: *Your deployment is complete*.
20+
21+
### Verify deployment
22+
23+
1. Select **Go to resource** to view your new container app.
24+
25+
1. Select the link next to *Application URL* to view your application.

0 commit comments

Comments
 (0)