Hello, Azure Developer CLI (azd)

This template provides an introductory demo template for the Azure Developer CLI (azd). Run the template to provision and deploy resources to Azure and experiment with a working sample app.

Visit the Azure Developer CLI templates overview page for more information about templates. The following assets are included in the hello-azd template:

• A small sample app to demonstrate deployment and connections to services provisioned by azd.
• Infrastructure-as-code (IaC) Bicep files under the infra folder that demonstrate how to provision resources and setup resource tagging for azd.
• A dev container configuration file under the .devcontainer directory that installs infrastructure tooling by default. This can be readily used to create cloud-hosted developer environments such as GitHub Codespaces.
• Continuous deployment workflows for CI providers such as GitHub Actions under the .github directory, and Azure Pipelines under the .azdo directory that work for most use-cases.

Get started

Complete the following steps to run the template and provision resources on Azure:

1. Install the Azure Developer CLI on your device.

2. Install Docker Desktop on your device. This is needed to package the container app.

3. In the command line tool of your choice, run the azd init command to clone and initialize this template repo.

   azd init -t hello-azd

4. Package, provision and deploy the app using a single command by running azd up.

The template provisions and deploys the required Azure resources for the app to run, which may take several minutes. When the process completes, your browser should open to the following page:

The template completed the following tasks for you:

• Packaged up your app code for deployment.
• Created an Azure Container Registry.
• Created an Azure Container Apps environment and app.
• Created an Azure Storage account with an attachments blob container and tickets table.
• Created a managed identity and assigned it to the Container App.
• Assigned identity-based Blob and Table Storage access.
• Configured environment settings for Azure Storage endpoints.
• Deployed the app to Azure Container Apps.

The app is now ready to use!

Important

The deployed demo is publicly accessible and doesn't require users to sign in. Don't submit sensitive or production data, and run azd down when you finish exploring the template.

Additional resources

Visit the following resources for more information about working with the Azure Developer CLI and templates:

• Azure Developer CLI documentation
• Awesome AZD template gallery
• Azure Developer CLI training modules

Other sample templates

Explore some other common Azure Developer CLI templates:

• React Web App with C# API and SQL Database on Azure
• React Web App with Node.js API and MongoDB on Azure
• React Web App with Python API and MongoDB on Azure