Uredi

Deli z drugimi prek

Quickstart: Create and deploy a Python web app to Azure by using an azd template

This quickstart guides you through the easiest and fastest way to create and deploy a Python web and database solution to Azure. By following the instructions in this quickstart, you:

  • Choose an azd template based on the Python web framework, Azure database platform, and Azure web hosting platform you want to build on.
  • Use CLI commands to run an azd template to create a sample web app and database, and create and configure the necessary Azure resources. Then, deploy the sample web app to Azure.
  • Edit the web app on your local computer and use an azd command to redeploy.
  • Use an azd command to clean up Azure resources.

It should take less than 15 minutes to complete this tutorial. When you finish, you can start modifying the new project with your custom code.

To learn more about these azd templates for Python web app development, see:

Prerequisites

An Azure subscription - Create one for free

Install the following tools on your local computer:

Choose a template

Choose an azd template based on the Python web framework, Azure web hosting platform, and Azure database platform you want to build on.

  1. Select a template name (first column) from the following list of templates in the following tables. Use the template name during the azd init step in the next section.

    Template Web Framework Database Hosting Platform GitHub Repo
    azure-django-postgres-flexible-aca Django PostgreSQL Flexible Server Azure Container Apps repo
    azure-django-postgres-flexible-appservice Django PostgreSQL Flexible Server Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL Adapter) Azure Container Apps repo
    azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL Adapter) Azure App Service repo
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL Add-on Azure Container Apps repo

Run the template

Running an azd template is the same across languages and frameworks. The same basic steps apply to all templates. The steps are:

  1. At a terminal, navigate to a folder on your local computer where you typically store your local git repositories. Create a new folder named azdtest. Then, change into that directory by using the cd command.

    mkdir azdtest
cd azdtest

    Don't use Visual Studio Code's Terminal for this quickstart.

  2. To set up the local development environment, enter the following commands in your terminal and answer any prompts:

    azd init --template <template name>

    Substitute <template name> with one of the templates from the tables you selected in a previous step, such as azure-django-postgres-aca for example.

    When prompted for an environment name, use azdtest or any other name. The environment name is used when naming Azure resource groups and resources. For best results, use a short name, lower case letters, no special characters.

  3. To authenticate azd to your Azure account, enter the following commands in your terminal and follow the prompt:

    azd auth login

    Follow the instructions when prompted to "Pick an account" or sign in to your Azure account. Once you successfully authenticate, the following message is displayed in a web page: "Authentication complete. You can return to the application. Feel free to close this browser tab."

    When you close the tab, the shell displays the message:

    Logged in to Azure.

  4. Ensure that Docker Desktop is open and running in the background before attempting the next step.

  5. To create the necessary Azure resources, enter the following commands in your terminal and answer any prompts:

    azd up

    Important

    Once azd up completes successfully, the sample web app is available on the public internet and your Azure Subscription begins accruing charges for all resources that are created. The creators of the azd templates intentionally chose inexpensive tiers but not necessarily free tiers since free tiers often have restricted availability.

    Follow the instructions when prompted to choose Azure Subscription to use for payment, then select an Azure location to use. Choose a region that is close to you geographically.

    Executing azd up can take several minutes since it's provisioning and deploying multiple Azure services. As progress is displayed, watch for errors. If you see errors, try the following to fix the problem:

    • Delete the azd-quickstart folder and the quickstart instructions from the beginning.
    • When prompted, choose a simpler name for your environment. Only use lower-case letters and dashes. No numbers, upper-case letters, or special characters.
    • Choose a different location.

    If you still have problems, see the Troubleshooting section at the bottom of this document.

    Important

    When you finish working with the sample web app, use azd down to remove all of the services that azd up created.

  6. When azd up completes successfully, the following output is displayed:

    Screenshot of successful output from the azd command line interface with a callout around the endpoint URL to view the working Relecloud application deployed in Azure.

    Copy the first URL after the word - Endpoint: and paste it into the location bar of a web browser to see the sample web app project running live in Azure.

  7. Open a new tab in your web browser.

    1. Copy the second URL from the previous step and paste it into the location bar.
    2. The Azure portal displays all of the services in your new resource group that are deployed to host the sample web app project.

Edit and redeploy

Next, make a small change to the web app and then redeploy it.

  1. Open Visual Studio Code and open the azdtest folder.

  2. This template is configured to optionally use Dev Containers. When you see the Dev Container notification appear in Visual Studio Code, select the Reopen in Container button.

  3. Use Visual Studio Code's Explorer view to navigate to src/templates folder, and open the index.html file. Locate the following line of code:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    Change the text inside of the H1:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    Save your changes.

  4. To redeploy the app with your change, run the following command in your terminal:

    azd deploy

    Since you're using Dev Containers and are connected remotely into the container's shell, don't use Visual Studio Code's Terminal pane to run azd commands.

  5. When the command finishes, refresh your web browser to see the update. Depending on the web hosting platform you're using, it might take several minutes before your changes are visible.

    You're now ready to edit and delete files in the template. For more information, see What can I edit or delete in the template?

Clean up resources

  1. Clean up the resources created by the template by running the azd down command.

    azd down

    The azd down command deletes the Azure resources and the GitHub Actions workflow. When prompted, agree to deleting all resources associated with the resource group.

    You can also delete the azdtest folder, or use it as the basis for your own application by modifying the project's files.

Troubleshooting

If you see errors during azd up, try the following steps:

  • Run azd down to remove any resources that the command created. Alternatively, you can delete the resource group that you created in the Azure portal.
  • Delete the azdtest folder on your local computer.
  • In the Azure portal, search for Key Vaults. Select Manage deleted vaults, choose your subscription, select all key vaults that contain the name azdtest or whatever you named your environment, and select Purge.
  • Retry the steps in this quickstart. This time when prompted, choose a simpler name for your environment. Try a short name, lowercase letters, no numbers, no uppercase letters, and no special characters.
  • When retrying the quickstart steps, choose a different location.

For a more comprehensive list of possible issues and solutions, see the FAQ.

Related content

  • Last updated on