Quickstart: Create an Azure Migrate project using an ARM template

Article
04/13/2023

This quickstart describes how to set up an Azure Migrate project Recovery by using an Azure Resource Manager template (ARM template). Azure Migrate provides a centralized hub to assess and migrate to Azure on-premises servers, infrastructure, applications, and data. Azure Migrate supports assessment and migration of on-premises VMware VMs, Hyper-V VMs, physical servers, other virtualized VMs, databases, web apps, and virtual desktops.

This template creates an Azure Migrate project that will be used further for assessing and migrating your Azure on-premises servers, infrastructure, applications, and data.

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 will open in the Azure portal.

Prerequisites

If you don't have an active Azure subscription, you can create a free account before you begin.

Review the template

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

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "migrateProjectName": {
            "type": "string",
            "maxLength": 13,
            "metadata": {
                "description": "Specifies a name for creating the migrate project."
            }
        },
        "location": {
            "type": "string",
            "allowedValues": [
                "centralus",
                "eastasia",
                "northeurope",
                "westeurope",
                "westus2",
                "australiasoutheast",
                "uksouth",
                "ukwest",
                "canadacentral",
                "centralindia",
                "southindia",
                "japaneast",
                "japanwest",
                "brazilsouth",
                "koreasouth",
                "koreacentral",
                "francecentral",
                "switzerlandnorth",
                "australiaeast",
                "southeastasia",
                "centraluseuap",
                "eastus2euap",
                "canadaeast",
                "southcentralus",
                "usgovvirginia",
                "usgovarizona"
            ],
            "metadata": {
                "description": "Specifies the location for all resources."
            }
        }
    },
    "resources": [
        {
            "type": "Microsoft.Migrate/MigrateProjects",
            "apiVersion": "2020-05-01",
            "name": "[parameters('migrateProjectName')]",
            "location": "[parameters('location')]",
            "tags": {
                "Migrate Project": "[parameters('migrateProjectName')]"
            },
            "properties": {}
        },
        {
            "type": "Microsoft.Migrate/MigrateProjects/Solutions",
            "apiVersion": "2020-05-01",
            "name": "[concat(parameters('migrateProjectName'), '/Servers-Assessment-ServerAssessment')]",
            "dependsOn": [
                "[resourceId('Microsoft.Migrate/MigrateProjects', parameters('migrateProjectName'))]"
            ],
            "properties": {
                "tool": "ServerAssessment",
                "purpose": "Assessment",
                "goal": "Servers",
                "status": "Active"
            }
        },
        {
            "type": "Microsoft.Migrate/MigrateProjects/Solutions",
            "apiVersion": "2020-05-01",
            "name": "[concat(parameters('migrateProjectName'), '/Servers-Discovery-ServerDiscovery')]",
            "dependsOn": [
                "[resourceId('Microsoft.Migrate/MigrateProjects', parameters('migrateProjectName'))]"
            ],
            "properties": {
                "tool": "ServerDiscovery",
                "purpose": "Discovery",
                "goal": "Servers",
                "status": "Inactive"
            }
        },
        {
            "type": "Microsoft.Migrate/MigrateProjects/Solutions",
            "apiVersion": "2020-05-01",
            "name": "[concat(parameters('migrateProjectName'), '/Servers-Migration-ServerMigration')]",
            "dependsOn": [
                "[resourceId('Microsoft.Migrate/MigrateProjects', parameters('migrateProjectName'))]"
            ],
            "properties": {
                "tool": "ServerMigration",
                "purpose": "Migration",
                "goal": "Servers",
                "status": "Active"
            }
        }
    ]
}

Deploy the template

To deploy the template, the Subscription, Resource group, Project name, and Location are required.

To sign in to Azure and open the template, select the Deploy to Azure image.
Select or enter the following values:
- Subscription: Select your Azure subscription.
- Resource group: Select an existing group or select Create new to add a group.
- Region: Defaults to the resource group's location and becomes unavailable after a resource group is selected.
- Migrate Project Name: Provide a name for the vault.
- Location: Select the location where you want to deploy the Azure Migrate project and its resources.
Click Review + create button to start the deployment.

Validate the deployment

To confirm that the Azure Migrate project was created, use the Azure portal.

Navigate to Azure Migrate by searching for Azure Migrate in the search bar on the Azure portal.
Click the Discover, Assess, and Migrate button under the Servers, databases and web apps tile.
Select the Azure subscription and Project as per the values specified in the deployment.

Next steps

In this quickstart, you created an Azure Migrate project. To learn more about Azure Migrate and its capabilities, continue to the Azure Migrate overview.

Azure Migrate overview