|
1 | 1 | --- |
2 | | -title: 'Quickstart: Deploy an existing container image in the Azure portal' |
3 | | -description: Deploy an existing container image to Azure Container Apps using the Azure portal. |
| 2 | +title: 'Quickstart: Deploy an Existing Container Image in the Azure Portal' |
| 3 | +description: Deploy an existing container image to Azure Container Apps by using the Azure portal. |
4 | 4 | services: container-apps |
5 | 5 | author: craigshoemaker |
6 | 6 | ms.service: azure-container-apps |
7 | 7 | ms.topic: quickstart |
8 | | -ms.date: 10/14/2024 |
| 8 | +ms.date: 03/26/2026 |
9 | 9 | ms.author: cshoe |
10 | | -zone_pivot_groups: container-apps-registry-types |
11 | 10 | --- |
12 | 11 |
|
13 | 12 | # Quickstart: Deploy an existing container image in the Azure portal |
14 | 13 |
|
15 | | -Azure Container Apps enables you to run microservices and containerized applications on a serverless platform. With Container Apps, you enjoy the benefits of running containers while leaving behind the concerns of manually configuring cloud infrastructure and complex container orchestrators. |
| 14 | +Azure Container Apps allows you to run microservices and containerized applications on a serverless platform. With Container Apps, you enjoy the benefits of running containers while leaving behind the concerns of manually configuring cloud infrastructure and complex container orchestrators. |
16 | 15 |
|
17 | | -This article demonstrates how to deploy an existing container to Azure Container Apps using the Azure portal. |
| 16 | +This article demonstrates how to deploy an existing container to Azure Container Apps by using the Azure portal. |
18 | 17 |
|
19 | 18 | > [!NOTE] |
20 | 19 | > Private registry authorization is supported via registry username and password. |
21 | 20 |
|
22 | 21 | ## Prerequisites |
23 | 22 |
|
24 | | -- Azure account with an active subscription. |
25 | | - - If you don't have one, you [can create one for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). |
26 | | -## Setup |
27 | | - |
28 | | -Begin by signing in to the [Azure portal](https://portal.azure.com). |
| 23 | +- An Azure account with an active subscription. If you don't have one, you can [create one for free](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn). |
29 | 24 |
|
30 | 25 | ## Create a container app |
31 | 26 |
|
32 | 27 | To create your container app, start at the Azure portal home page. |
33 | 28 |
|
34 | | -1. Search for **Container Apps** in the top search bar. |
35 | | -1. Select **Container Apps** in the search results. |
36 | | -1. Select the **Create** button. |
| 29 | +1. Sign in to the [Azure portal](https://portal.azure.com). |
37 | 30 |
|
38 | | -### Basics tab |
| 31 | +1. Search for and select **Container Apps** in the search bar. |
39 | 32 |
|
40 | | -In the *Basics* tab, do the following actions. |
| 33 | +1. Select the **Create** button, then choose **+ Container App**. |
41 | 34 |
|
42 | | -#### Enter project details |
| 35 | +### Basics tab |
| 36 | + |
| 37 | +On the **Basics** tab, enter the following information: |
43 | 38 |
|
44 | 39 | | Setting | Action | |
45 | 40 | |---|---| |
46 | 41 | | Subscription | Select your Azure subscription. | |
47 | | -| Resource group | Select **Create new** and enter **my-container-apps**. | |
48 | | -| Container app name | Enter **my-container-app**. | |
49 | | - |
50 | | -#### Create an environment |
| 42 | +| Resource group | Select **Create new** and enter *my-container-apps*. | |
| 43 | +| Container app name | Enter *my-container-app*. | |
| 44 | +| Optimize for Azure Functions | Leave the checkbox unchecked. | |
| 45 | +| Deployment source | Select **Container image**. | |
| 46 | +| Region | Select **Canada Central**. | |
| 47 | +| Container Apps environment | Accept the default. | |
51 | 48 |
|
52 | | -1. In the *Create Container App environment* field, select **Create new**. |
53 | | -1. In the *Create Container App Environment* page on the *Basics* tab, enter the following values: |
| 49 | +Select **Next: Container**. |
54 | 50 |
|
55 | | - | Setting | Value | |
56 | | - |---|---| |
57 | | - | Environment name | Enter **my-environment**. | |
58 | | - | Region | Select **Canada Central**. | |
| 51 | +### Container tab |
59 | 52 |
|
60 | | -1. Select the **Monitoring** tab to create a Log Analytics workspace. |
61 | | -1. Select **Create new** in the *Log Analytics workspace* field. |
62 | | -1. Enter **my-container-apps-logs** in the *Name* field of the *Create new Log Analytics Workspace* dialog. |
63 | | - |
64 | | - The *Location* field is pre-filled with *Canada Central* for you. |
| 53 | +On the **Container** tab, enter the following information: |
65 | 54 |
|
66 | | -1. Select **OK**. |
67 | | -1. Select the **Create** button at the bottom of the *Create Container App Environment* page. |
68 | | -1. Select the **Next: App settings** button at the bottom of the page. |
69 | | - |
70 | | -### App settings tab |
71 | | - |
72 | | -In the *App settings* tab, do the following actions: |
73 | | - |
74 | | -::: zone pivot="container-apps-private-registry" |
75 | 55 | | Setting | Action | |
76 | 56 | |---|---| |
77 | | -| Use quickstart image | **Uncheck** the checkbox. | |
78 | | -| Name | Enter **my-portal-app**. | |
| 57 | +| Use quickstart image | Uncheck the checkbox. | |
| 58 | +| Name | Enter *my-portal-app*. | |
79 | 59 | | Image source | Select your container image repository source. If your container is hosted in a registry other than **Azure Container Registry**, select **Docker Hub or other registries**. | |
80 | | -| Image type | Select **Private**. | |
81 | | -| Registry login server | Enter the domain (including subdomain) of your container registry. | |
82 | | -| Registry user name | Enter your user name for the registry. | |
83 | | -| Registry password | Enter your password for the registry. | |
84 | | -| Image and tag | Enter the image name, including tag. | |
85 | | -::: zone-end |
86 | | - |
87 | | -::: zone pivot="container-apps-public-registry" |
88 | | -| Setting | Action | |
89 | | -|---|---| |
90 | | -| Use quickstart image | **Uncheck** the checkbox. | |
91 | | -| Name | Enter **my-portal-app**. | |
92 | | -| Image source | Select your container image repository source. If your container is hosted in a registry other than **Azure Container Registry**, select **Docker Hub or other registries**. | |
93 | | -| Registry login server | Enter the domain (including subdomain) of your container registry. | |
94 | | -| Image type | Select **Public**. | |
95 | | -| Image and tag | Enter the image name, including tag. | |
96 | | -::: zone-end |
| 60 | +| Subscription | Select your Azure subscription. | |
| 61 | +| Registry | Select your registry. | |
| 62 | +| Image and image tag | Enter the image name, including tag. | |
| 63 | + |
| 64 | +Select **Next: Ingress**. |
97 | 65 |
|
98 | | -#### Application ingress settings |
| 66 | +### Ingress tab |
99 | 67 |
|
100 | 68 | | Setting | Action | |
101 | 69 | |---|---| |
102 | | -| Ingress | Select **Enabled** or **Disabled**. | |
| 70 | +| Ingress | Check or uncheck the checkbox. | |
103 | 71 |
|
104 | | -If you enabled ingress, configure the following settings: |
| 72 | +If you checked the box to enable ingress, configure the following settings: |
105 | 73 |
|
106 | 74 | | Setting | Action | |
107 | 75 | |---|---| |
108 | | -| Ingress visibility | Select **Internal** to only allow ingress from other apps in the same virtual network, and select **External** to publicly expose your container app. | |
| 76 | +| Ingress traffic | Select **Limited to Container App Environment** to restrict traffic to this container app. Select **Accepting traffic from anywhere** to publicly expose your container app. | |
109 | 77 | | Target port | Enter the port you want to expose your container app. | |
110 | 78 |
|
111 | 79 | ### Deploy the container app |
112 | 80 |
|
113 | | -1. Select the **Review and create** button at the bottom of the page. |
| 81 | +1. Select the **Review and create** button. |
114 | 82 |
|
115 | | - Next, the settings in the Container App are verified. If no errors are found, the *Create* button is enabled. |
| 83 | + If no errors are found, the **Create** button is enabled. |
116 | 84 |
|
117 | | - If there are errors, any tab containing errors is marked with a red dot. Navigate to the appropriate tab. Fields containing an error is highlighted in red. Once all errors are fixed, select **Review and create** again. |
| 85 | + 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. |
118 | 86 |
|
119 | 87 | 1. Select **Create**. |
120 | 88 |
|
121 | | - 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*. |
| 89 | + 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**. |
122 | 90 |
|
123 | 91 | ### Verify deployment |
124 | 92 |
|
125 | | -You can verify your deployment is successful by querying the Log Analytics workspace. You might need to wait a 5 to 10 minutes for the analytics to arrive for the first time before you're able to query the logs. |
126 | | - |
127 | | -After 5 to 10 minutes of creating the container app, follow these steps to view logged messages: |
| 93 | +You can verify your deployment is successful by querying the Log Analytics workspace. You might need to wait 5 to 10 minutes for the analytics to arrive for the first time before you're able to query the logs. |
128 | 94 |
|
129 | 95 | 1. Select **Go to resource** to view your new container app. |
130 | | -1. Select **Logs** under the *Monitoring* header. |
131 | | -1. Select the **Load to editor** button from any of the cards. |
132 | | -1. Replace the generated code with the following query: |
| 96 | + |
| 97 | +1. Under **Monitoring**, select **Logs**. |
| 98 | + |
| 99 | +1. Select **KQL mode** from the menu bar. |
| 100 | + |
| 101 | +1. Enter the following query: |
133 | 102 |
|
134 | 103 | ```text |
135 | 104 | ContainerAppConsoleLogs_CL | where ContainerAppName_s == 'my-container-app' | project ContainerAppName_s, Log_s, TimeGenerated |
136 | 105 | ``` |
137 | 106 |
|
138 | 107 | 1. Select the **Run** button. |
| 108 | +
|
139 | 109 | 1. Inspect the results in the table. |
140 | 110 |
|
141 | 111 | ## Clean up resources |
142 | 112 |
|
143 | 113 | If you're not going to continue to use this application, you can delete the Azure Container Apps instance and all the associated services by removing the resource group. |
144 | 114 |
|
145 | | -1. Select the **my-container-apps** resource group from the *Overview* section. |
146 | | -1. Select the **Delete resource group** button at the top of the resource group *Overview*. |
147 | | -1. Enter the resource group name **my-container-apps** in the *Are you sure you want to delete "my-container-apps"* confirmation dialog. |
148 | | -1. Select **Delete**. |
149 | | - The process to delete the resource group might take a few minutes to complete. |
| 115 | +1. Select your resource group from the **Overview** section, then select the **Delete resource group** button. |
| 116 | +
|
| 117 | +1. Confirm the resource group name, and then select **Delete**. The process to delete the resource group might take a few minutes to complete. |
150 | 118 |
|
151 | 119 | > [!TIP] |
152 | 120 | > Having issues? Let us know on GitHub by opening an issue in the [Azure Container Apps repo](https://github.com/microsoft/azure-container-apps). |
153 | 121 |
|
154 | | -## Next steps |
| 122 | +## Next step |
155 | 123 |
|
156 | 124 | > [!div class="nextstepaction"] |
157 | 125 | > [Communication between microservices](communicate-between-microservices.md) |
0 commit comments