Create an environment by using the Azure Developer CLI

To enable Azure Developer CLI features in Visual Studio Code, install the Azure Developer CLI extension, version v0.8.3. Select the Extensions icon in the Activity bar, search for Azure Developer CLI, and then select Install.

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

In Visual Studio 2022 17.3 Preview 2 or later, you can enable integration with azd as a preview feature.

To enable the azd feature, go to Tools > Options > Environment > Preview Features and select Integration with azd, the Azure Developer CLI.

When the feature is enabled, you can use the Azure Developer CLI from your terminal of choice on Windows, Linux, or macOS.

The output of commands issued from the command palette is displayed in an azd dev terminal like the following example:

Sign in to Azure at the CLI using the following command:

 azd auth login

Access your Azure resources by logging in. When you initiate a log in, a browser window opens and prompts you to log in to Azure. After you sign in, the terminal displays a message that you're signed in to Azure.

To open the Developer Command prompt:

1. From the Tools menu, select Terminal.

2. In the Terminal window, select Developer Command Prompt.

   

Sign in to AZD using the Developer Command Terminal:

 azd auth login

 azd config set platform.type devcenter

 azd config set platform.type devcenter

1. In Visual Studio Code, open the folder that contains your application code.

2. Open the command palette, and enter Azure Developer CLI init, then from the list, select Azure Developer CLI (azd): init.

   

3. In the list of templates, to continue without selecting a template, press ENTER twice.

4. In the AZD terminal, select Use code in the current directory.

   

5. azd init identifies the services defined in your app code and prompts you to confirm and continue, remove a service, or add a service. Select Confirm and continue initializing my app.

   

6. azd init continues to gather information to configure your app. For this example application, you're prompted for the name of your MongoDB database instance, and ports that the services listen on.

   

7. Enter a name for your local AZD environment.

   

8. azd init displays a list of the projects you have access to. Select the project for your environment

   

9. azd init displays a list of environment definitions in the project. Select an environment definition.

   

   AZD creates the project resources, including an azure.yaml file in the root of your project.

1. At the CLI, navigate to the folder that contains your application code.

2. Run the following command to initialize your application and supply information when prompted:

   azd init
   

3. In the AZD terminal, select Use code in the current directory.

   

   AZD scans the current directory and gathers more information depending on the type of app you're building. Follow the prompts to configure your AZD environment.

4. azd init identifies the services defined in your app code and prompts you to confirm and continue, remove a service, or add a service. Select Confirm and continue initializing my app.

   

5. azd init continues to gather information to configure your app. For this example application, you're prompted for the name of your MongoDB database instance, and ports that the services listen on.

   

6. Enter a name for your local AZD environment.

   

7. azd init displays a list of the projects you have access to. Select the project for your environment.

   

8. azd init displays a list of environment definitions in the project. Select an environment definition.

   

   AZD creates the project resources, including an azure.yaml file in the root of your project.

1. At the CLI, navigate to the folder that contains your application code.

2. Run the following command to initialize your application and supply information when prompted:

   azd init
   

3. In the AZD terminal, select Use code in the current directory.

   

   AZD scans the current directory and gathers more information depending on the type of app you're building. Follow the prompts to configure your AZD environment.

4. azd init identifies the services defined in your app code and prompts you to confirm and continue, remove a service, or add a service. Select Confirm and continue initializing my app.

   

5. azd init continues to gather information to configure your app. For this example application, you're prompted for the name of your MongoDB database instance, and ports that the services listen on.

   

6. Enter a name for your local AZD environment.

   

7. azd init displays a list of the projects you have access to. Select the project for your environment.

   

8. azd init displays a list of environment definitions in the project. Select an environment definition.

   AZD creates the project resources, including an azure.yaml file in the root of your project.

1. In Explorer, right-click azure.yaml, and then select Azure Developer CLI (azd) > Provision Azure Resources (provision).

   

2. AZD scans Azure Deployment Environments for projects that you have access to. In the AZD terminal, select or enter the following information:

   1. Project
   2. Environment definition
   3. Environment type
   4. Location

3. AZD instructs ADE to create a new environment based on the information you gave in the previous step.

4. You can view the resources created in the Azure portal or in the developer portal.

Provision your application to Azure using the following command:

azd provision

1. 'azd provision' provides a list of projects that you have access to. Select the project that you want to provision your application to.

   

2. 'azd provision' provides a list of environment definitions in the selected project. Select the environment definition that you want to use to provision your application.

   

3. 'azd provision' provides a list of environment types in the selected project. Select the environment type that you want to use to provision your application.

   

4. AZD instructs ADE to create a new environment based on the information you gave in the previous step.

   

5. You can view the resources created in the Azure portal or in the developer portal.

Provision your application to Azure using the following command:

azd provision

1. 'azd provision' provides a list of projects that you have access to. Select the project that you want to provision your application to.

   

2. 'azd provision' provides a list of environment definitions in the selected project. Select the environment definition that you want to use to provision your application.

   

3. 'azd provision' provides a list of environment types in the selected project. Select the environment type that you want to use to provision your application.

4. AZD instructs ADE to create a new environment based on the information you gave in the previous step.

5. You can view the resources created in the Azure portal or in the developer portal.

1. In Explorer, right-click azure.yaml, and then select Azure Developer CLI (azd) > View Local and Remote Environments (env list).

   

   You're prompted to select a project and an environment definition.

Use the following command to view the environments that you have access to: the local AZD environment and the remote Azure Deployment Environments environment.

azd env list

azd env list prompts you to select a project and an environment definition.

Use the following command to view the environments that you have access to: the local AZD environment and the remote Azure Deployment Environments environment.

azd env list

azd env list prompts you to select a project and an environment definition.

1. In Explorer, right-click azure.yaml, and then select Azure Developer CLI (azd) > Deploy Azure Resources (deploy).

   

2. You can verify that your code is deployed by selecting the end point URLs listed in the AZD terminal.

Deploy your application code to the remote Azure Deployment Environments environment you provisioned using the following command:

azd deploy

Deploying your code to the remote environment can take several minutes.

You can view the progress of the deployment in the Azure portal:

When deployment completes, you can view the resources that were provisioned in the Azure portal:

You can verify that your code is deployed by selecting the end point URLs listed in the AZD terminal.

For this sample application, you see something like this:

Deploy your application code to the remote Azure Deployment Environments environment you provisioned using the following command:

azd deploy

Deploying your code to the remote environment can take several minutes.

You can view the progress of the deployment in the Azure portal:

When deployment completes, you can view the resources that were provisioned in the Azure portal:

You can verify that your code is deployed by selecting the end point URLs listed in the AZD terminal.

In Explorer, right-click azure.yaml, and then select Azure Developer CLI (azd) > Delete Deployment and Resources (down).

Confirm that you want to delete the environment by entering y when prompted.

Delete your Azure resources by using the following command:

azd down --environment <environmentName>

Delete your Azure resources by using the following command:

azd down --environment <environmentName>