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

This quickstart describes how to use an Azure Resource Manager template (ARM template) to create and configure a 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

• If you don't have an Azure subscription, create a free account before you begin.
• Owner or Contributor role on an Azure subscription or resource group.
• Microsoft Entra AD. Your organization must use Microsoft Entra AD for identity and access management.
• Microsoft Intune subscription. Your organization must use Microsoft Intune for device 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 on either of the following code blocks and follow instructions to sign in to Azure.

2. Wait until you see the prompt from the console, then ensure you're set to deploy to the subscription you want.

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

   1. If you want to use the default parameter values:

      $location = Read-Host "Please enter region name e.g. 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."
      
      

   2. If you want to input your own values:

      $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 e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      
      $location = Read-Host "Please enter region name e.g. 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 are located.
• Dev Center Name: The name of the dev center.
• Project Name: The name of the project that is associated with the dev center.
• Environment Type Name: The name of the environment type for both the dev center and project.
• User Object ID: The object ID of the user that is granted the Deployment Environments User role.

Alternatively, you can provide access to 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 from the left pane.
3. Select the resource group that you created in the previous section.

Clean up resources

1. Delete any environments associated with the project either through 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 the role assignments that you don't need anymore from the subscription.

Next steps

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

Quickstart: Create and access an environment