| title | Tutorial: Containerized Python web apps on Azure - Build and test locally |
|---|---|
| description | Build and test a containerized Python web app locally. |
| ms.topic | conceptual |
| ms.date | 06/27/2022 |
| ms.custom | devx-track-python |
| ms.prod | azure-python |
| author | jess-johnson-msft |
| ms.author | jejohn |
This article is part of a tutorial about containerizing and deploy a Python web app to Azure App Service. App Service enables you to run containerized web apps and deploy through continuous integration/continuous deployment (CI/CD) capabilities with Docker Hub, Azure Container Registry, and Visual Studio Team Services. In this part of the tutorial, you learn how to build and run the containerized Python web app locally.
After completing this part of the tutorial, you will
-
Understand a Dockerfile and how it it is used to build the container image.
-
Understand how to use tags as reference for Docker images and use the tag to reference the image.
These instructions require Visual Studio Code, the Docker extension for VS Code, and Docker.
| Instructions | Screenshot |
|---|---|
| [!INCLUDE A screenshot showing how to open the Docker extension in Visual Studio Code] | :::image type="content" source="./media/tutorial-container-web-app/visual-studio-code-open-docker-extension-240px.png" lightbox="./media/tutorial-container-web-app/visual-studio-code-open-docker-extension.png" alt-text="A screenshot showing how to open the Docker extension in Visual Studio Code." ::: |
| [!INCLUDE A screenshot showing how to build the Docker image in Visual Studio Code] | :::image type="content" source="./media/tutorial-container-web-app/visual-studio-code-docker-extension-build-image-240px.png" lightbox="./media/tutorial-container-web-app/visual-studio-code-docker-extension-build-image.png" alt-text="A screenshot showing how to build the Docker image in Visual Studio Code." ::: |
| [!INCLUDE A screenshot showing how to confirm the built image in Visual Studio Code] | :::image type="content" source="./media/tutorial-container-web-app/visual-studio-code-docker-extension-view-images-240px.png" lightbox="./media/tutorial-container-web-app/visual-studio-code-docker-extension-view-images.png" alt-text="A screenshot showing how to confirm the built image in Visual Studio Code." ::: |
These instructions require Docker.
[!INCLUDE Build an image with the Docker CLI]
At this point, you have build an image locally. You can also see and work the image with Docker Desktop.
The sample app requires a MongoDB connection string, database name, and collection name. The MongoDB database must be accessible to you locally as well as in Azure. You can create an Azure Cosmos DB for MongoDB with theses steps for Azure portal, Azure CLI, PowerShell, or VS Code.
[!INCLUDE Run an image with the Docker CLI]
You can also start a container from an image and stop it with the Docker Desktop.