This Python web app is a restaurant review application using the Flask framework. The app is intended to be used as a container running on Azure App Service with a connection to an Azure Cosmos DB API for MongoDB.
Following the tutorial TBD: coming soon, you can deploy this web app Azure, hosted in a fully managed Azure App Service. Azure managed identity enables the App Service to pull container images from an Azure Container Registry. MongoDB connection info is passed to the code through environment variables.
If you need an Azure account, you can create on for free.
A Django sample application with similar functionality is at Django container web app.
Here are some ways you can run the sample web app in this repository.
| Scenario | As-is repo code | Containerized app |
|---|---|---|
| Local environment | Run repo code in virtual environment with requirements.txt. Set environment variables in shell before running. | Build image from repo and run locally in Docker container. Pass environment variables in Docker CLI command or with VS Code task definition 1. |
| Azure App Service Web App for Containers | Deploy repo code to App service. Set environment variables as App Service configuration settings. See note about subpath. 2 | Build image locally or in Azure and push to container registry like Azure Container Registry. Configure App Service to pull from registry. Set environment variables as App Service configuration settings. |
| Azure Container Apps | n/a | Build image locally or in Azure and push to container registry like Azure Container Registry. Create a Container App with deployment from the registry. Configure environment variables for the container. |
(1) The .vscode directory settings.json and tasks.json are configured either for a MongoDB local connection or an Azure Cosmos DB connection. The tasks and templates in .vscode are only used when using Visual Studio Code locally.
(2) This app was designed to be containerized and run on App Service. If you want to deploy to App Service without containerizing it, then be sure to set the subpath to the azureporject folder, which contains the manage.py file. Do that by:
- In VS Code: F1 or CTRL + SHIFT + P to open the command palette.
- Type "Preferences: Open Workspace Settings" and select to open.
- In the Settings search field, enter "@id:appService.deploySubpath appser".
- Set the subpath as "azureproject".
The Web App for Containers scenario is covered in the tutorial TBD: coming soon.
The sample code requires the following environment variables passed in as described in the scenario table above.
CONNECTION_STRING=<connection-string>
DB_NAME=restaurants_reviews
COLLECTION_NAME=restaurants_reviews
For a local MongoDB instance, the connection string is of the form mongodb://127.0.0.1:27017. An Azure Cosmos DB API for MongoDB connections string is of the form mongodb://<server-name>:<password>@<server-name>.mongo.cosmos.azure.com:10255/?ssl=true&<other-parameters>.
The requirements.txt has the following packages:
| Package | Description |
|---|---|
| Flask | Web application framework. |
| gunicorn | Gunicorn ‘Green Unicorn’ is a Python WSGI HTTP Server for UNIX. |
| pymongo | The PyMongo distribution contains tools for interacting with MongoDB database from Python. |
| Flask-WTF | Form rendering, validation, and CSRF protection for Flask with WTForms. Uses CSRFProtect extension. |
| requests | Python HTTP for Humans. |