In File Explorer or a terminal, create a new empty directory, and change into it.
Run the azd init command and specify the template you want to use as a parameter:
azd init --template todo-nodejs-mongo
Note: this command will initialize the application, including cloning the GitHub repo.
You will be prompted for an environment name, which sets the prefix for the resource group that will be created to hold the Azure resources. What is an Environment Name in azd?
After you specify the environment, azd clones the template project to your machine and initializes the project.
Provision and deploy the app resources
Run the azd up command:
azd up
If you are not already signed-in to Azure, the browser will launch and ask you to sign-in.
Once you are signed-in to Azure, you will be prompted for the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
After you provide these values, the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
When the azd up command completes successfully, the CLI displays two links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy updates to your application.
Once your Codespace is created, right-click azure.yaml in the root directory. From the options, select up (provision resources, and deploy code to Azure).
Provide parameters
When you run the azd up command, you'll be prompted to provide the following information and to sign in using a web browser and an authentication code:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
This process may take some time to complete, as the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CodeSpaces terminal displays two Azure portal links to view resources created:
The app has been built and deployed to Azure. Using the web app URL output from the azd up command, you can browse to the fully functional app.
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run and debug that requires launching a web browser is currently not support because of known limitation with GitHub Codespaces. For better experience, we recommend using Codespaces in Desktop.
A DevContainer is a Docker image that includes all of the prerequisites you need to run this app on your local machine.
Open a terminal, create a new empty directory, and change into it.
Run the following command to initialize the project:
azd init --template todo-nodejs-mongo
Provide parameters
When you run the azd init command, you'll be prompted to provide the following information:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Open DevContainer
Open the project in VS Code, hit F1 and choose: Remote-Containers: Rebuild and Reopen in Container
Run up command
Run the following command:
azd up
When you run the azd up command, you'll be prompted to provide the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
The azd up command may take some time to run as it completes the following steps:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CLI displays two Azure portal links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy your application.
In File Explorer or a terminal, create a new empty directory, and change into it.
Run the azd init command and specify the template you want to use as a parameter:
azd init --template todo-python-mongo
Note: this command will initialize the application, including cloning the GitHub repo.
You will be prompted for an environment name, which sets the prefix for the resource group that will be created to hold the Azure resources. What is an Environment Name in azd?
After you specify the environment, azd clones the template project to your machine and initializes the project.
Provision and deploy the app resources
Run the azd up command:
azd up
If you are not already signed-in to Azure, the browser will launch and ask you to sign-in.
Once you are signed-in to Azure, you will be prompted for the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
After you provide these values, the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
When the azd up command completes successfully, the CLI displays two links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy updates to your application.
Once your Codespace is created, right-click azure.yaml in the root directory. From the options, select up (provision resources, and deploy code to Azure).
Provide parameters
When you run the azd up command, you'll be prompted to provide the following information and to sign in using a web browser and an authentication code:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
This process may take some time to complete, as the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CodeSpaces terminal displays two Azure portal links to view resources created:
The app has been built and deployed to Azure. Using the web app URL output from the azd up command, you can browse to the fully functional app.
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run and debug that requires launching a web browser is currently not supported because of known limitation with GitHub Codespaces. For a better experience, we recommend using Codespaces in Desktop.
A DevContainer is a Docker image that includes all of the prerequisites you need to run this app on your local machine.
Open a terminal, create a new empty directory, and change into it.
Run the following command to initialize the project:
azd init --template todo-python-mongo
Provide parameters
When you run the azd init command, you'll be prompted to provide the following information:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Open DevContainer
Open the project in VS Code, hit F1 and choose: Dev Containers: Rebuild and Reopen in Container
Run up command
Run the following command:
azd up
When you run the azd up command, you'll be prompted to provide the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
The azd up command may take some time to run as it completes the following steps:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CLI displays two Azure portal links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run a C# template
Let's put the basic Azure Developer CLI (azd) commands to the test and run one of our C# template applications. We'll use the React Web App with C# API and MongoDB on Azure for this guide.
Upon completion, you'll get the code in your development environment and be able to run commands to build, deploy, and monitor the app in Azure.
In File Explorer or a terminal, create a new empty directory, and change into it.
Run the azd init command and specify the template you want to use as a parameter:
azd init --template todo-csharp-cosmos-sql
Note: this command will initialize the application, including cloning the GitHub repo.
You will be prompted for an environment name, which sets the prefix for the resource group that will be created to hold the Azure resources. What is an Environment Name in azd?
After you specify the environment, azd clones the template project to your machine and initializes the project.
Provision and deploy the app resources
Run the azd up command:
azd up
If you are not already signed-in to Azure, the browser will launch and ask you to sign-in.
Once you are signed-in to Azure, you will be prompted for the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
After you provide these values, the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
When the azd up command completes successfully, the CLI displays two links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy updates to your application.
Once your Codespace is created, right-click azure.yaml in the root directory. From the options, select up (provision resources, and deploy code to Azure).
Provide parameters
When you run the azd up command, you'll be prompted to provide the following information and to sign in using a web browser and an authentication code:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
This process may take some time to complete, as the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CodeSpaces terminal displays two Azure portal links to view resources created:
The app has been built and deployed to Azure. Using the web app URL output from the azd up command, you can browse to the fully functional app.
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run and debug that requires launching a web browser is currently not supported because of known limitation with GitHub Codespaces. For a better experience, we recommend using Codespaces in Desktop.
A DevContainer is a Docker image that includes all of the prerequisites you need to run this app on your local machine.
Open a terminal, create a new empty directory, and change into it.
Run the following command to initialize the project:
azd init --template todo-csharp-cosmos-sql
Provide parameters
When you run the azd init command, you'll be prompted to provide the following information:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Open DevContainer
Open the project in VS Code, hit F1 and choose: Remote-Containers: Rebuild and Reopen in Container
Run up command
Run the following command:
azd up
When you run the azd up command, you'll be prompted to provide the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
The azd up command may take some time to run as it completes the following steps:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CLI displays two Azure portal links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run a Java template
Let's put the basic Azure Developer CLI (azd) commands to the test and run one of our Java template applications. We'll use the React Web App with Java API and MongoDB on Azure for this guide.
Upon completion, you'll get the code in your development environment and be able to run commands to build, deploy, and monitor the app in Azure.
In File Explorer or a terminal, create a new empty directory, and change into it.
Run the azd init command and specify the template you want to use as a parameter:
azd init --template todo-java-mongo
Note: this command will initialize the application, including cloning the GitHub repo.
You will be prompted for an environment name, which sets the prefix for the resource group that will be created to hold the Azure resources. What is an Environment Name in azd?
After you specify the environment, azd clones the template project to your machine and initializes the project.
Provision and deploy the app resources
Run the azd up command:
azd up
If you are not already signed-in to Azure, the browser will launch and ask you to sign-in.
Once you are signed-in to Azure, you will be prompted for the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
After you provide these values, the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
When the azd up command completes successfully, the CLI displays two links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy updates to your application.
Once your Codespace is created, right-click azure.yaml in the root directory. From the options, select up (provision resources, and deploy code to Azure).
Provide parameters
When you run the azd up command, you'll be prompted to provide the following information and to sign in using a web browser and an authentication code:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
This process may take some time to complete, as the azd up command:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CodeSpaces terminal displays two Azure portal links to view resources created:
The app has been built and deployed to Azure. Using the web app URL output from the azd up command, you can browse to the fully functional app.
Note
You can call azd up as many times as you like to both provision and deploy your application.
Run and debug that requires launching a web browser is currently not supported because of known limitation with GitHub Codespaces. For a better experience, we recommend using Codespaces in Desktop.
A DevContainer is a Docker image that includes all of the prerequisites you need to run this app on your local machine.
Open a terminal, create a new empty directory, and change into it.
Run the following command to initialize the project:
azd init --template todo-java-mongo
Provide parameters
When you run the azd init command, you'll be prompted to provide the following information:
Parameter
Description
Environment Name
Prefix for the resource group that will be created to hold all Azure resources. What is an Environment Name in azd? You can always create a new environment with azd env new.
Open DevContainer
Open the project in VS Code, hit F1 and choose: Remote-Containers: Rebuild and Reopen in Container
Run up command
Run the following command:
azd up
When you run the azd up command, you'll be prompted to provide the following information:
Parameter
Description
Azure Location
The Azure location where your resources will be deployed.
Azure Subscription
The Azure Subscription where your resources will be deployed.
The azd up command may take some time to run as it completes the following steps:
Creates and configures all necessary Azure resources (azd provision), including:
Access policies and roles for your account
Service-to-service communication with Managed Identities
Packages and deploys the code (azd deploy)
Once you've provided the necessary parameters and the azd up command completes, the CLI displays two Azure portal links to view resources created:
ToDo API app
ToDo web app frontend
Note
You can call azd up as many times as you like to both provision and deploy your application.
Clean up resources
When you no longer need the resources created in this article, run the following command to power down the app:
azd down
Request help
For information on how to file a bug, request help, or propose a new feature for the Azure Developer CLI, please visit the troubleshooting and support page.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
