Skip to content

Commit 258c11d

Browse files
committed
Add new documentation for quickstart ARM template
1 parent fffc39f commit 258c11d

File tree

3 files changed

+51
-26
lines changed

3 files changed

+51
-26
lines changed

articles/deployment-environments/overview-what-is-azure-deployment-environments.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -91,6 +91,7 @@ Start using Azure Deployment Environments:
9191

9292
- [Key concepts for Azure Deployment Environments](./concept-environments-key-concepts.md)
9393
- [Azure Deployment Environments scenarios](./concept-environments-scenarios.md)
94+
- [Quickstart: Create dev center and project (ARM)](./quickstart-create-devcenter-and-project-arm.md)
9495
- [Quickstart: Create and configure a dev center](./quickstart-create-and-configure-devcenter.md)
9596
- [Quickstart: Create and configure a project](./quickstart-create-and-configure-projects.md)
9697
- [Quickstart: Create and access environments](./quickstart-create-access-environments.md)

articles/deployment-environments/quickstart-create-and-configure-devcenter.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The following diagram shows the steps to configure a dev center for Azure Deploy
2222

2323
:::image type="content" source="media/quickstart-create-and-configure-devcenter/steps-configure-devcenter.png" alt-text="Diagram showing the stages required to configure a dev center for Deployment Environments." lightbox="media/quickstart-create-and-configure-devcenter/steps-configure-devcenter-expanded.png"::::::
2424

25-
You need to perform the steps in this quickstart and then [create a project](quickstart-create-and-configure-projects.md) before you can [create a deployment environment](quickstart-create-access-environments.md).
25+
You need to perform the steps in this quickstart and then [create a project](quickstart-create-and-configure-projects.md) before you can [create a deployment environment](quickstart-create-access-environments.md). Alternatively to creating these resources manually, you can also follow this quickstart to [deploy the dev center and project using an ARM template](./quickstart-create-devcenter-and-project-arm.md).
2626

2727
## Prerequisites
2828

articles/deployment-environments/quickstart-create-devcenter-and-project-arm.md

Lines changed: 49 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -47,51 +47,75 @@ Azure resources defined in the template:
4747

4848
## Deploy the template
4949

50-
1. Select **Open Cloudshell** from the following code block to open Azure Cloud Shell, and then follow the instructions to sign in to Azure.
50+
1. Select **Open Cloudshell** on either of the following code blocks and follow instructions to sign in to Azure.
51+
2. Wait until you see the prompt from the console, then ensure you're set to deploy to the subscription you want.
52+
3. If you want to continue deploying the template, select **Copy** on the code block, then right-click the shell console and select **Paste**
5153

52-
```azurepowershell-interactive
53-
$resourceGroupName = Read-Host "Please enter resource group name e.g. test-ade-rg"
54-
$userPrincipalId = Read-Host "Please enter user principal ID e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
55-
$devcenterName = Read-Host "Please enter dev center name e.g. test-dev-center"
56-
$projectName = Read-Host "Please enter project name e.g. test-project"
57-
$environmentTypeName = Read-Host "Please enter environment type name or leave it empty to default to the name 'Sandbox'"
58-
$location = Read-Host "Please enter region name e.g. eastus"
59-
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
54+
1. If you want to use the default parameter values:
6055

61-
if ([string]::IsNullOrWhiteSpace($environmentTypeName)) {
62-
$environmentTypeName = "Sandbox"
63-
}
56+
```azurepowershell-interactive
57+
$location = Read-Host "Please enter region name e.g. eastus"
58+
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
6459
65-
Write-Host "Start provisioning..."
60+
Write-Host "Start provisioning..."
6661
67-
New-AzDeployment -Name (New-Guid) -Location $location -TemplateUri $templateUri -resourceGroupName $resourceGroupName -userPrincipalId $userPrincipalId -devcenterName $devcenterName -projectName $projectName -environmentTypeName $environmentTypeName
62+
New-AzDeployment -Name (New-Guid) -Location $location -TemplateUri $templateUri
6863
69-
Write-Host "Provisioning completed."
64+
Write-Host "Provisioning completed."
7065
71-
```
66+
```
7267
73-
Wait until you see the prompt from the console.
74-
75-
2. Ensure you're set to deploy to the subscription you want.
76-
3. Select **Copy** from the previous code block to copy the PowerShell script.
77-
4. Right-click the shell console pane and then select **Paste**.
78-
5. Enter the values.
68+
2. If you want to input your own values:
7969
80-
It takes about 30 minutes to deploy the template.
70+
```azurepowershell-interactive
71+
$resourceGroupName = Read-Host "Please enter resource group name: "
72+
$devCenterName = Read-Host "Please enter dev center name: "
73+
$projectName = Read-Host "Please enter project name: "
74+
$environmentTypeName = Read-Host "Please enter environment type name: "
75+
$userObjectId = Read-Host "Please enter your user object ID e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
76+
77+
$location = Read-Host "Please enter region name e.g. eastus"
78+
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.devcenter/deployment-environments/azuredeploy.json"
79+
80+
Write-Host "Start provisioning..."
81+
82+
New-AzDeployment -Name (New-Guid) -Location $location -TemplateUri $templateUri -resourceGroupName $resourceGroupName -devCenterName $devCenterName -projectName $projectName -environmentTypeName $environmentTypeName -userObjectId $userObjectId
83+
84+
Write-Host "Provisioning completed."
85+
86+
```
87+
88+
It takes about 5 minutes to deploy the template.
8189
8290
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](../azure-resource-manager/templates/deploy-portal.md).
8391
84-
## Review deployed resources
92+
### Required Parameters
93+
94+
- *Resource Group Name*: The name of the resource group where the dev center and project will be located.
95+
- *Dev Center Name*:
96+
- *Project Name*:
97+
- *Environment Type Name*:
98+
- *User Object ID*:
8599
100+
Alternatively, you can provide access to deployment environments project in the Azure portal, see [Provide user access to Azure Deployment Environments projects](./how-to-configure-deployment-environments-user.md)
86101
102+
## Review deployed resources
103+
104+
1. Sign in to the [Azure portal](https://portal.azure.com).
105+
2. Select **Resource groups** from the left pane.
106+
3. Select the resource group that you created in the previous section.
87107
88108
## Clean up resources
89109
90110
1. If there are environments associated with the project resource, delete them first either through the Azure Portal or the developer portal
91111
2. Delete the project resource
92112
3. Delete the dev center resource
93113
4. Delete the resource group
114+
5. Remove the role assignments that you don't need anymore from the subscription
94115
95116
## Next steps
96117
97-
- [Quickstart: Create and access an environment](./quickstart-create-access-environments.md)
118+
In this quickstart, you created and configured a dev center and project. Advance to the next quickstart to learn how to create an environment.
119+
120+
> [!div class="nextstepaction"]
121+
> [Quickstart: Create and access an environment](./quickstart-create-access-environments.md)

0 commit comments

Comments
 (0)