Microsoft Dev Box Sample

This provides Azure Bicep templates to create Microsoft Dev Box within your subscription.

Acknowledgement

• This templates create minimum number of resources on Azure.
• If you need more comprehensive example, find this repository instead.

Prerequisites

• Azure Subscription: Get free subscription
• Azure Developer CLI: Install
• Azure CLI: Install

Getting Started

1. Fork this repository to your GitHub account.

2. Set the environment name.

   # PowerShell
   $AZURE_ENV_NAME="dbox$(Get-Random -Max 9999)"
   
   # Bash
   AZURE_ENV_NAME="dbox$RANDOM"

3. Set the user principal name (UPN) of your tenant. It typically looks like alias@domain.

   Make sure the UPN MUST be within the tenant. External account or Microsoft Account is not allowed.

   # PowerShell
   $upn="{USER_PRINCIPAL_NAME}"
   
   # Bash
   upn="{USER_PRINCIPAL_NAME}"

4. Run the commands in the following order to provision resources.

   # Azure CLI
   az login
   
   # Azure Dev CLI
   azd auth login
   azd init -e $AZURE_ENV_NAME
   azd env set PROJECT_USER_IDS $(az ad user show --id $upn --query "id" -o tsv)
   azd env set PROJECT_ADMIN_IDS $(az ad user show --id $upn --query "id" -o tsv)
   azd up

5. Once all provisioned, log into Microsoft Developer Portal.

6. Create a new Dev Box to use.

7. Once the Dev Box is running, log into the Dev Box with your account.

Want to try more?

Here are some documents you might be interested in:

• Microsoft Dev Box – Announcement
• What is Microsoft Dev Box?
• Set up Microsoft Dev Box
• Create a Dev Box from Developer Portal
• Azure Dev Center Quick Start