You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Merge pull request #278123 from Akhilesh-microsoft/ACA/ingress_how_to
[ACA: ingress-how-to]: Verified the article for links and freshness, reviewed the content, verified all the editorial parameters. Article seems good. Updated ms.date
Copy file name to clipboardExpand all lines: articles/container-apps/ingress-how-to.md
+17-17Lines changed: 17 additions & 17 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -5,15 +5,15 @@ services: container-apps
5
5
author: craigshoemaker
6
6
ms.service: container-apps
7
7
ms.topic: how-to
8
-
ms.date: 03/28/2023
8
+
ms.date: 06/13/2024
9
9
ms.author: cshoe
10
10
ms.custom: devx-track-azurecli
11
11
zone_pivot_groups: arm-azure-cli-portal
12
12
---
13
13
14
-
# Configure Ingress for your app in Azure Container Apps
14
+
# Configure Ingress for your app in Azure Container Apps
15
15
16
-
This article shows you how to enable [ingress](ingress-overview.md) features for your container app. Ingress is an application-wide setting. Changes to ingress settings apply to all revisions simultaneously, and don't generate new revisions.
16
+
This article shows you how to enable [ingress](ingress-overview.md) features for your container app. Ingress is an application-wide setting. Changes to ingress settings apply to all revisions simultaneously, and don't generate new revisions.
17
17
18
18
## Ingress settings
19
19
@@ -39,7 +39,7 @@ You can configure ingress for your container app using the Azure CLI, an ARM tem
39
39
40
40
::: zone pivot="azure-cli"
41
41
42
-
This `az containerapp ingress enable` command enables ingress for your container app. You must specify the target port, and you can optionally set the exposed port if your transport type is `tcp`.
42
+
This `az containerapp ingress enable` command enables ingress for your container app. You must specify the target port, and you can optionally set the exposed port if your transport type is `tcp`.
43
43
44
44
```azurecli
45
45
az containerapp ingress enable \
@@ -56,19 +56,19 @@ az containerapp ingress enable \
|`--type`| external | Allow ingress to your app from anywhere, or limit ingress to its internal Container Apps environment. |`external` or `internal`| Yes |
60
-
|`--allow-insecure`| allowInsecure | Allow HTTP connections to your app. || No |
59
+
|`--type`| external | Allow ingress to your app from anywhere, or limit ingress to its internal Container Apps environment. |`external` or `internal`| Yes |
60
+
|`--allow-insecure`| allowInsecure | Allow HTTP connections to your app. || No |
61
61
|`--target-port`| targetPort | The port your container listens to for incoming requests. | Set this value to the port number that your container uses. Your application ingress endpoint is always exposed on port `443`. | Yes |
62
62
|`--exposed-port`| exposedPort | (TCP ingress only) An port for TCP ingress. If `external` is `true`, the value must be unique in the Container Apps environment if ingress is external. | A port number from `1` to `65535`. (can't be `80` or `443`) | No |
63
-
|`--transport`| transport | The transport protocol type. | auto (default) detects HTTP/1 or HTTP/2, `http` for HTTP/1, `http2` for HTTP/2, `tcp` for TCP. | No |
63
+
|`--transport`| transport | The transport protocol type. | auto (default) detects HTTP/1 or HTTP/2, `http` for HTTP/1, `http2` for HTTP/2, `tcp` for TCP. | No |
64
64
65
65
::: zone-end
66
66
67
67
::: zone pivot="azure-portal"
68
68
69
69
Enable ingress for your container app by using the portal.
70
70
71
-
You can enable ingress when you create your container app, or you can enable ingress for an existing container app.
71
+
You can enable ingress when you create your container app, or you can enable ingress for an existing container app.
72
72
- To configure ingress when you create your container app, select **Ingress** from the **App Configuration** tab of the container app creation wizard.
73
73
- To configure ingress for an existing container app, select **Ingress** from the **Settings** menu of the container app resource page.
74
74
@@ -79,19 +79,19 @@ You can configure ingress when you create your container app by using the Azure
79
79
1. Set **Ingress** to **Enabled**.
80
80
1. Configure the ingress settings for your container app.
81
81
1. Select **Limited to Container Apps Environment** for internal ingress or **Accepting traffic from anywhere** for external ingress.
82
-
1. Select the **Ingress Type**: **HTTP** or **TCP** (TCP ingress is only available in environments configured with a custom VNET).
82
+
1. Select the **Ingress Type**: **HTTP** or **TCP** (TCP ingress is only available in environments configured with a custom virtual network).
83
83
1. If *HTTP* is selected for the **Ingress Type**, select the **Transport**: **Auto**, **HTTP/1** or **HTTP/2**.
84
84
1. Select **Insecure connections** if you want to allow HTTP connections to your app.
85
85
1. Enter the **Target port** for your container app.
86
-
1. If you have selected **TCP** for the **Transport** option, enter the **Exposed port** for your container app. The exposed port number can be `1` to `65535`. (can't be `80` or `443`)
86
+
1. If you selected **TCP** for the **Transport** option, enter the **Exposed port** for your container app. The exposed port number can be `1` to `65535`. (can't be `80` or `443`)
87
87
88
-
The **Ingress** settings page for your container app also allows you to configure **IP Restrictions**. For information to configure IP restriction, see [IP Restrictions](ip-restrictions.md).
88
+
The **Ingress** settings page for your container app also allows you to configure **IP Restrictions**. For information to configure IP restriction, see [IP Restrictions](ip-restrictions.md).
89
89
90
90
::: zone-end
91
91
92
92
::: zone pivot="azure-resource-manager"
93
93
94
-
Enable ingress for your container app by using the `ingress` configuration property. Set the `external` property to `true`, and set your `transport` and `targetPort` properties.
94
+
Enable ingress for your container app by using the `ingress` configuration property. Set the `external` property to `true`, and set your `transport` and `targetPort` properties.
95
95
-`external` property can be set to *true* for external or *false* for internal ingress.
96
96
- Set the `transport` to `auto` to detect HTTP/1 or HTTP/2, `http` for HTTP/1, `http2` for HTTP/2, or `tcp` for TCP.
97
97
- Set the `targetPort` to the port number that your container uses. Your application ingress endpoint is always exposed on port `443`.
@@ -129,13 +129,13 @@ az containerapp ingress disable \
129
129
130
130
::: zone pivot="azure-portal"
131
131
132
-
You can disable ingress for your container app using the portal.
132
+
You can disable ingress for your container app using the portal.
133
133
134
134
1. Select **Ingress** from the **Settings** menu of the container app page.
135
135
1. Deselect the **Ingress****Enabled** setting.
136
136
1. Select **Save**.
137
137
138
-
:::image type="content" source="media/ingress/screenshot-disable-ingress.png" alt-text="Sceenshot of disabling container app ingress.":::
138
+
:::image type="content" source="media/ingress/screenshot-disable-ingress.png" alt-text="Sceenshot of disabling container app ingress.":::
139
139
140
140
::: zone-end
141
141
@@ -145,7 +145,7 @@ Disable ingress for your container app by omitting the `ingress` configuration p
0 commit comments