Skip to content

README.md

Latest commit

 

History

History
78 lines (51 loc) · 4.53 KB

README.md

File metadata and controls

78 lines (51 loc) · 4.53 KB

Azure Web App with Azure CosmosDB for NoSQL API

This sample demonstrates a Python Flask single-page web application called Vacation Planner hosted on an Azure Web App. The app runs on an Azure App Service Plan and stores activity data in the activities container of the sampledb NoSQL database on an Azure CosmosDB for NoSQL account.

Architecture

The following diagram illustrates the architecture of the solution:

Architecture Diagram

  • Azure Web App: Hosts the Python Flask application
  • Azure App Service Plan: Provides compute resources for the web app
  • Azure CosmosDB for NoSQL API: Stores activity data in a CosmosDB container

Prerequisites

Deployment

Set up the Azure emulator using the LocalStack for Azure Docker image. Before starting, ensure you have a valid LOCALSTACK_AUTH_TOKEN to access the Azure emulator. Refer to the Auth Token guide to obtain your Auth Token and set it in the LOCALSTACK_AUTH_TOKEN environment variable. The Azure Docker image is available on the LocalStack Docker Hub. To pull the image, execute:

docker pull localstack/localstack-azure-alpha

Start the LocalStack Azure emulator by running:

# Set the authentication token
export LOCALSTACK_AUTH_TOKEN=<your_auth_token>

# Start the LocalStack Azure emulator
IMAGE_NAME=localstack/localstack-azure-alpha localstack start -d
localstack wait -t 60

# Route all Azure CLI calls to the LocalStack Azure emulator
azlocal start-interception

Deploy the application to LocalStack for Azure using:

Note
When you deploy the application to LocalStack for Azure for the first time, the initialization process involves downloading and building Docker images. This is a one-time operation—subsequent deployments will be significantly faster. Depending on your internet connection and system resources, this initial setup may take several minutes.

Test

  1. Retrieve the port published and mapped to port 80 by the Docker container hosting the emulated Web App.
  2. Open a web browser and navigate to http://localhost:<published-port>.
  3. If the deployment was successful, you will see the following user interface for adding and removing activities:

Architecture Diagram

You can use the call-web-app.sh Bash script below to call the web app. The script demonstrates three methods for calling web apps:

  1. Through the LocalStack for Azure emulator: Call the web app via the emulator using its default host name. The emulator acts as a proxy to the web app.
  2. Via localhost and host port mapped to the container's port: Use 127.0.0.1 with the host port mapped to the container's port 80.
  3. Via container IP address: Use the app container's IP address on port 80. This technique is only available when accessing the web app from the Docker host machine.
  4. Via the default hostname: Call the web app via the default hostname <web-app-name>.azurewebsites.azure.localhost.localstack.cloud:4566.

CosmosDB Tooling

You can utilize CosmosDB Data Explorer to explore and manage your CosmosDB databases and containers. Ensure you connect using http://localhost:port connection string, where port corresponds to the port published by the CosmosDB container on the host and mapped to the internal CosmosDB port 1234.

CosmosDB Data Explorer

References