\nIf you include the need to copy a resource or set of resources, instead of only moving, the list expands a lot.<\/p>\n
Azure already offers the resources to do this: ARM templates, automated deployments, Data Sync, Recovery Services Vault, VM replication and so on. The problem is that sometimes, to move a set of objects together, you may need to use many of these services and understand how to use them.<\/p>\n
The solution is a new free service, still in preview, called Azure Resource Mover<\/strong>. This service reduces the complexity of moving resources, minimizing the number of decisions needed on how the resources will be moved. More than that, the last step, deleting the source of the move, is optional, as you will see in detail later. You can use this feature, not only to move resources, but also to copy and distribute them across many regions. During the move process, only one side (source or destination) will be active, but once you finish the move, if you decide not to delete the source, you have in fact a new deployment of the solution.<\/p>\n This article demonstrates two step-by-step moves to explain how the new Azure Resource Mover<\/strong> works displaying a complete test of the features. I start with two virtual machines, in two different regions, and both will move to North Europe<\/em>.<\/p>\n I created two resource groups<\/strong> as a starting point: MoverDemo<\/em> and MoverDemo2<\/em>, in different regions, UK South<\/em> and East US<\/em>.<\/p>\n In each resource group, I created a virtual machine and the objects that follow it, shown in the image below.<\/p>\n On the Azure Portal<\/a>, you can use features still in preview, such as Resource Mover<\/strong>. Sometimes the Resource Mover<\/strong> may appear visible as an icon in the middle of the Azure services, but this usually happens when it was already used.<\/p>\n Another option is to use the search box on the site to find Azure<\/strong> Resource Mover<\/strong>, then click on it.<\/p>\n A third option is to use the Move<\/strong> button on top of the resource group screen. Open the resource group and click the Move<\/strong> button. Before Azure<\/strong> Resource Mover<\/strong> preview, there were only two options, move to another resource group and move to another subscription. Resource Mover<\/strong> included a new option: Move to another location.<\/p>\n There is a small difference between opening Resource Mover<\/strong> directly or using the move to another location button. When you use the move button, you will directly open the wizard to add new objects to move. However, if you open the Resource Mover<\/strong> by clicking the button on the Home page of the portal, you will see the initial screen shown in the next section.<\/p>\n Azure Resource Mover<\/strong> is not a simple Azure object; it is an environment for a wizard execution. The first thing you\u2019ll see, when Overview<\/em> is selected on the left side, is this guidance. This reflects, almost exactly, the sequence of steps of a move process:<\/p>\n These are the three main steps, but this is not the complete process, as you will discover on further steps.<\/p>\n On the middle-top screen, you will notice the information about source and target regions of the move. It may seem a bit strange at first glance, but this is not only information about the move, but a context control. Each set of source and target is a context for the move. You add objects in the context and start the steps for the move operation, being able to do it for each context.<\/p>\n If one employee starts a move in a context, changes the context and does not touch it anymore, no one will know about the existence of that move. In this situation, you may need to use CLI to find the existing contexts\/move collections objects. You can open cloud shell from the top of the Azure Portal window and execute the following statement:<\/p>\n The main properties you may notice are the type (moveCollection), id, and resourceGroup . These properties identify the existence of the moveCollection and the source and target of the move. Mind that you will only see this result after adding objects to a context because this will generate the moveCollection object. The product group is working on the creation of an overview section to list all the existing Move Collections<\/strong>, solving the problem above.<\/p>\n One good way to do this is filtering by resource group. You may notice the selection windows only show the resource groups that have at least one resource in the source region.<\/p>\n \n A screen will appear explaining the steps of the wizard. This screen also advises you that a new resource group will be created to keep metadata information and about the creation of a system managed identity which will receive permission to make the move. You need to mark the checkbox, agreeing with these steps, before clicking the button and moving forward.<\/p>\n The Status<\/strong> column shows in which step each object is. The Issues<\/strong> column alerts about any pending problem. At this point, you can already identify all the steps in the move process, although the sequence may not always be so clear:<\/p>\n Add Objects:<\/strong> Add in the context the objects to be moved. This step is completed.<\/p>\n Validate Dependencies:<\/strong> The objects included may depend on other objects. You need to execute a dependency validation for all of them.<\/p>\n Prepare:<\/strong> All the objects need preparation, and these preparations can be different for each object. It may involve cache, for example, additional metadata in the metadata resource group, and so on.<\/p>\n Initiate Move:<\/strong> The move task itself. This step creates the object in the destination region<\/p>\n Commit Move:<\/strong> This step works as a confirmation that we would like to keep the objects on the destination region.<\/p>\n Delete Source:<\/strong> This last step is optional. You can choose to delete the source objects or not. This makes Resource Mover<\/strong> way more powerful since it can be used to duplicate objects.<\/p>\n These steps, such as prepare, move, and commit, may appear as a black box for anyone who is using them. Here is a more in-depth explanation.<\/p>\n The service was made to work for many objects, and more and more objects will be included. These steps may have different meanings depending on the object. The main difference is related to stateless and stateful objects.<\/p>\n Stateless:<\/strong> Objects which don\u2019t contain data, only definition and metadata, such as IP addresses and virtual networks.<\/p>\n Stateful:<\/strong> Objects which contain data, such as virtual machines and SQL databases.<\/p>\n The steps apply differently depending on the object:<\/p>\n Prepare:<\/strong> For stateless objects, the prepare step creates the arm template for the object deployment. Stateful objects are more complex. The action may be different for each kind of object, such as replication for VMs, for example, but the prepare step will be just a preparation for the action.<\/p>\n Move:<\/strong> This step will implement the preparation. It can be a simple deployment of the ARM template created or the establishment of a replication, but for stateful objects, the actions may vary.<\/p>\n Commit:<\/strong> This is the confirmation to proceed to the destination object. For stateless objects, this doesn\u2019t mean too much, but for stateful objects, this may mean the replication being broken, for example.<\/p>\n Follow these steps<\/p>\n Having the dependency validation finished, a new button will appear on top of the screen, Add dependencies<\/strong>, as in the image below.<\/p>\n The resource group also needs to be moved together with the virtual machine. More than that: It needs to be moved first.<\/p>\n At this point, you will get back to the same screen listing the resources to move, the only difference is the presence of the resource group.<\/p>\n After including the missing dependencies, you need to validate again to ensure there is no additional dependency missing. After the 2nd<\/sup> round of validation, the screen will look like the image below: No issues pending, no blue alerts, but the Status<\/strong> column telling what the next step is.<\/p>\n At this point, when the Status<\/strong> column shows the next step is the Prepare<\/strong>, you can customize the destination configuration for each object.<\/p>\n The column Destination Configuration<\/strong> has the destination name of the object as a link. If you click the link, you will reach a page to customize the object. Each object has different customization options.<\/p>\n Below you can see the configuration options of a virtual machine and a network interface<\/p>\n After including the objects into the context, you don\u2019t need to execute the steps for all the objects together. In fact, it\u2019s exactly the opposite: In some situations, the objects will require that a dependency is moved first before even the prepare step, while in other situations you will have stateless and stateful objects mixed.<\/p>\n One stateful object can even take days to be moved (databases or virtual machines). You will want to ensure all stateless are moved first and only after that move the stateful objects within an acceptable window in the production environment.<\/p>\n During the following steps, you will move each context using different sequences, just as an example that this can be done. However, for virtual machines, both contexts have a requirement: The resource group needs to be moved first<\/p>\n As you may notice, the Status<\/strong> column changes only for the resource group, displaying the next step<\/p>\n At this point, you may notice how the objects are advancing in different steps. The resource group was already moved, the stateless objects are already prepared, and the virtual machine will be prepared now.<\/p>\n Once the preparation of the virtual machine has completed, you will see the status of the objects like the image below:<\/p>\n At this point of the execution, these are the resource groups we can find:<\/p>\n At this stage, you have two move contexts with all the objects on the \u2018Commit move\u2019 pending<\/em> status. Our example will be more complete by committing only one of the contexts and deleting the other.<\/p>\n It\u2019s still possible to identify further dependencies not included until this point. On this example, the network interface of the virtual machine is included in the context.<\/p>\n The commit breaks the relationship between the source and the destination. The last pending step is to delete the source, but this is an optional step, you can choose to delete the source or not, so you would complete a move or have a copy of the objects.<\/p>\n This is an excellent moment to look again at the metadata resource group. The content of the resource group Resourcemoverrg-eastus-northeurope<\/em> is like the image below:<\/p>\n The recovery Services vault is a service used for virtual machine replication. You can check more details about the Recovery Services Vault<\/a> on the Microsoft website.<\/p>\n The storage account, for its part, has a container and many files used during the move process<\/p>\n As you noticed before, the steps of the move were applied as deployments over this resource group. Checking the list of deployments, you will find something like the image below:<\/p>\n Azure<\/strong> Resource Mover<\/strong> used Replication Policies<\/strong> to replicate the virtual machine. You can read more details about Replication Policies<\/strong><\/a> on the Microsoft website.<\/p>\n The move needs to be done in steps according to the dependency of the objects, the discarding of the move also needs to be done in steps, in reverse, according to the dependencies<\/p>\n All the objects depend on the resource group, so the objects need to be removed first, and the resource group will be left for last<\/p>\n After the discard, the objects return to the status \u2018Initiate Move\u2019 pending. They still need to be removed from the context<\/p>\n The move from UK South to North Europe is completed, committed. The last step is to delete the source objects. However, there is no automated way to do that, deleting the source is up to you.<\/p>\n Besides deleting the source, you also need to remove everything from the context, exactly as you did with the other context, East US to North Europe.<\/p>\n Returning to the home of the Azure Portal and looking for the resource groups, you will notice the destination resource group was removed, but the metadata resource group is still in place.<\/p>\n Azure Resource Mover is an environment for a wizard, leaving many details hidden in background objects. The metadata resource group may appear to be empty, but checking in more details, you will discover the resource group has deployments. <\/p>\n Clicking on the link of the image above, you can see these deployments in more details.<\/p>\n Clicking on the successful deployment on this list, you can see details about the objects deployed.<\/p>\n As you may notice on the type column, the objects deployed are MoveResources<\/strong>, deployed inside a MoveCollection<\/strong>. Each object included in the move context generates a MoveResource.<\/strong><\/p>\n The move collection is still in place, although it doesn\u2019t have any move resources. You can open cloud shell and execute the following statement to check:<\/p>\n The result, count of move collections, is still 2, both move collections are still present. You can drop the metadata resource group, but the group has a lock. You need to delete the lock first, as you may notice on the image below.<\/p>\n After removing the lock, you can remove the resource group with no further problem<\/p>\n When the removal of the metadata resource group is completed, you can execute the count again, this time we will get only a single move collection.<\/p>\n This is a preview version, probably while reading and testing this article you may have noticed many details which could be improved. You can leave a comment on this article, and let\u2019s talk about what could be improved.<\/p>\n You may also be interested in the following documentation of this new feature:<\/p>\n Overview<\/a><\/p>\n Support matrix for VM & networking resources<\/a><\/p>\n VM and Networking tutorial<\/a><\/p>\nSet up the VMs<\/h2>\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-41.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-152.png\")
<\/p>\nFinding Azure Resource Mover<\/h2>\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-153.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-154.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-42.png\")
<\/p>\nStarting the Azure Resource Mover wizard<\/h2>\n
\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-155.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-156.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-157.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-158.png\")
\nWhile testing the context, you may have noticed that, once you change to an empty context, you will only be able to return to the previous one if you know the combination of source-destination.<\/p>\naz resource list --resource-type Microsoft.Migrate\/moveCollections<\/pre>\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-43.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-44.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-159.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-160.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-161.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-162.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-163.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-45.png\")
<\/p>\nHow do the steps work?<\/h2>\n
Resolving dependencies<\/h2>\n
\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-164.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-165.png\")
<\/p>\n\n
\n
\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-166.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-167.png\")
<\/p>\n\n
Modifying the destination configuration<\/h2>\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-46.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-47.png\")
<\/p>\nMoving the resources<\/h2>\n
\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-7.png\")
<\/p>\n\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-168.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-48.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-8.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-49.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-9.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-10.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-50.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-11.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-computer-description-automatica-4.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-12.png\")
<\/p>\n\n
\n<\/strong><\/li>\n<\/ul>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-51.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-52.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-computer-description-automatica-5.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-computer-description-automatica-6.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-53.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-54.png\")
<\/p>\n\n
\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-55.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-56.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-57.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-58.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-59.png\")
<\/p>\nThe metadata resource group<\/h2>\n
![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-169.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-60.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-61.png\")
<\/p>\nDiscarding a move<\/h2>\n
\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-62.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-63.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-64.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-65.png\")
<\/p>\n\n
\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-computer-description-automatica-7.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-66.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-67.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-computer-screen-description-aut-1.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-68.png\")
<\/p>\n\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-69.png\")
<\/p>\n\n
Deleting source objects<\/h2>\n
\n
Deleting the metadata resource group<\/h2>\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-70.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-170.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-171.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-172.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-social-media-post-description-a-13.png\")
<\/p>\n((az resource list --resource-type Microsoft.Migrate\/moveCollections --output table) | wc -l) -1<\/pre>\n
![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-71.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-72.png\")
<\/p>\n![\"A](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/a-screenshot-of-a-cell-phone-description-automati-73.png\")
<\/p>\n![](\"https:\/\/www.red-gate.com\/simple-talk\/wp-content\/uploads\/2020\/09\/word-image-173.png\")
<\/p>\nConclusion<\/h2>\n