Quickstart: Create a dev center and project for Deployment Environments by using an ARM template

This quickstart describes how to use an Azure Resource Manager template (ARM template) to create and configure an Azure Deployment Environments dev center and project for creating an environment.

An Azure Resource Manager template is a JavaScript Object Notation (JSON) file that defines the infrastructure and configuration for your project. The template uses declarative syntax. You describe your intended deployment without writing the sequence of programming commands to create the deployment.

If your environment meets the prerequisites and you're familiar with using ARM templates, select the Deploy to Azure button. The template opens in the Azure portal.

Prerequisites

• An Azure subscription. Create a free account if you don't have one.
• Owner or Contributor role on an Azure subscription or resource group.
• Microsoft Entra ID. Your organization must use Microsoft Entra ID for identity and access management.

Review the template

The template used in this quickstart is from Azure Quickstart Templates.

To view the template, see azuredeploy.json.

Azure resources defined in the template:

• Microsoft.DevCenter/devcenters. Create a dev center.
• Microsoft.DevCenter/devcenters/catalogs. Create a catalog.
• Microsoft.DevCenter/devcenters/environmentTypes. Create a dev center environment type.
• Microsoft.DevCenter/projects. Create a project.
• Microsoft.Authorization/roleAssignments. Create a role assignment.
• Microsoft.DevCenter/projects/environmentTypes. Create a project environment type.

Deploy the template

1. Select Open Cloud Shell above either of the following code blocks and follow the instructions to sign in to Azure.

2. When you see the prompt from the console, ensure that you're ready to deploy to your chosen subscription.

3. Select the PowerShell shell and follow the prompts.

4. If you want to continue deploying the template, select Copy on the code block, and then right-click the shell console and select Paste.

   • If you want to use the default parameter values, use this code:

     $location = Read-Host "Please enter region name, for example, eastus"
     $templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
     
     Write-Host "Start provisioning..."
     
     New-AzDeployment -Name (New-Guid) -Location $location -TemplateUri $templateUri
     
     Write-Host "Provisioning completed."
     
     

   • If you want to input your own values, use this code:

     $resourceGroupName = Read-Host "Please enter resource group name: "
     $devCenterName = Read-Host "Please enter dev center name: "
     $projectName = Read-Host "Please enter project name: "
     $environmentTypeName = Read-Host "Please enter environment type name: "
     $userObjectId = Read-Host "Please enter your user object ID, for example, xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
     
     $location = Read-Host "Please enter region name, for example, eastus"
     $templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
     
     Write-Host "Start provisioning..."
     
     New-AzDeployment -Name (New-Guid) -Location $location -TemplateUri $templateUri -resourceGroupName $resourceGroupName -devCenterName $devCenterName -projectName $projectName -environmentTypeName $environmentTypeName -userObjectId $userObjectId
     
     Write-Host "Provisioning completed."
     
     

It takes about 5 minutes to deploy the template.

Azure PowerShell is used to deploy the template. You can also use the Azure portal and Azure CLI. To learn other deployment methods, see Deploy templates.

Required parameters

• Resource group name: The name of the resource group where the dev center and project will be located.
• Dev center name: The name of the dev center.
• Project name: The name of the project that's associated with the dev center.
• Environment type name: The name of the environment type for both the dev center and the project.
• User object ID: The object ID of a user that's granted the Deployment Environments User role.

Alternatively, you can provide access to the deployment environments project in the Azure portal. See Provide user access to Azure Deployment Environments projects.

Review deployed resources

1. Sign in to the Azure portal.
2. Select Resource groups in the left pane.
3. Select the resource group that you created in the previous section.

Clean up resources

If you no longer need the resources you created, delete them by following these instructions:

1. Delete any environments that are associated with the project by using the Azure portal or the developer portal.
2. Delete the project resource.
3. Delete the dev center resource.
4. Delete the resource group.
5. Remove role assignments that you don't need anymore from the subscription.

Next step

In this quickstart, you created and configured a dev center and project. Go to the next quickstart to learn how to create an environment.