Who is this for?

This Learning Path is an introductory topic for developers interested in creating and running a Docker container in Microsoft Azure using Azure Container Instances (ACI).

What will you learn?

Upon completion of this Learning Path, you will be able to:

  • Create a container instance on ACI.
  • Run a Docker container in ACI.
  • Enable Admin in Azure Container Registry (ACR), which is required when you're deploying Docker containers from the ACR.

Prerequisites

Before starting, you will need the following:

Summary

AI-assisted

This summary was drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
You’ll create an instance in ACI, run a sample ASP.NET container, and verify connectivity on port 8080. Then, you’ll inspect the public IP, use Azure Cloud Shell to check the container registry, and enable the ACR Admin account required for registry-based deployment.

Frequently asked questions

AI-assisted

These FAQs were drafted with an approved AI-assisted workflow and reviewed by Arm contributors before publication. Human technical review remains part of the process so the final page reflects engineering rigor, accuracy, and Arm editorial standards.

Close
?
Which container image should I use to create the first instance?
Use the Microsoft sample ASP.NET image: mcr.microsoft.com/dotnet/samples:aspnetapp.
How do I find the public IP and verify the application is running?
Open the Overview tab of the aspnet-sample container instance and copy the public IP address. Paste the IP into a browser with port 8080 (for example, IP:8080) and check that the page loads.
What should I check if the browser doesn't load the app on port 8080?
Confirm that the container instance has finished provisioning and is running. Verify that you’re using the correct Public IP and port 8080.
How do I confirm that my registry is ready for deployment?
In Azure Cloud Shell, run az acr list -o table and check the ADMIN ENABLED column. If it’s not enabled, turn on the admin account in the registry settings before deploying to ACI.
Can I deploy an arm64 container image to ACI?
At the time covered by this Learning Path, ACI is described as incompatible with arm64 Docker containers. Use the provided Microsoft sample image to validate the ACI workflow, and check the current Azure documentation if you need to confirm the service’s present capabilities.
Next