• Table of Contents
• What is Cookiecutter-Relecloud?
• Deployment Options
• Deploying your cookiecutter template
• Getting Updates from this Template
• Running your Deployment via DevContainer/Github Codespaces
• Deploy your template to Azure

Cookiecutter is a command-line utility that creates projects from cookiecutters (project templates), e.g. creating a Python package project from a Python package project template.

Relecloud is a sample web app created by the Microsoft Python Cloud Advocacy team.

While most cookiecutter generated projects are designed to build with a particular stack, Cookiecutter-Relecloud allows you to create a relecloud project with your choice of web framework, database, and deployment options.

• Sync new updates to your project via cruft
• Deploy your project to Azure using Azure Developer CLI

|✅ (Developed)|🛠️ (In Development)|❌ (Currently Not Supported)|

To request support please create a new discussion.

• Django Postgres - Flexible Server Azure Container Apps
• Django Postgres - Flexible Server Azure App Service
• Django CosmosDB Postgres Adapter Azure Container Apps
• Django CosmosDB Postgres Adapter Azure App Service
• Django Azure Container Apps Postgres Addon Azure Container Apps

• FastAPI Postgres - Flexible Server Azure Container Apps
• FastAPI Postgres - Flexible Server Azure App Service
• FastAPI CosmosDB Postgres Adapter Azure Container Apps
• FastAPI CosmosDB Postgres Adapter Azure App Service
• FastAPI Azure Container Apps Postgres Addon Azure Container Apps

• Flask Postgres - Flexible Server Azure Container Apps
• Flask Postgres - Flexible Server Azure App Service
• Flask CosmosDB Postgres Adapter Azure Container Apps
• Flask CosmosDB Postgres Adapter Azure App Service
• Flask Azure Container Apps Postgres Addon Azure Container Apps
• Flask CosmosDB - MongoDB Adapter Azure Container Apps
• Flask CosmosDB - MongoDB Adapter Azure App Service
• Flask MySQL - Flexible Server Azure App Service
• Flask MySQL - Flexible Server Azure Container Apps

1. Create a new folder
2. Create a virtual environment

python -m venv venv
source venv/bin/activate

2. Install necessary files

python -m pip install cruft packaging ruff 

3. Generate the project using this template

python -m cruft create https://github.com/kjaymiller/cookiecutter-relecloud

Cruft allows you to update your project with the latest changes from this template. To do so, run the following command:

cruft update

This template is designed to work with DevContainers and GitHub Codespaces. You can deploy the Github Codespaces instance by clicking the green code button and creating a new codespace.

To deploy the dev container locally you can do so with a compatible code editor like Visual Studio Code.

These templates are configured to deploy to Microsoft Azure via the Azure Developer CLI. You can deploy your project immediately using azd up