Single project recovery
This article explains the project backup recovery process for Azure DevOps and Azure DevOps Server.
Project recovery in Azure DevOps and Azure DevOps Server allows you to quickly restore a selected project with all its repositories and other project data.
Recovery process
Deleted artifacts cannot be restored while they remain in the recycle bin — they can be restored, but you must remove them from the recycle bin first.
Azure does not allow restoring deleted packages to the same feed. Once a package is deleted, it must remain deleted. Restoring to a new feed does not have this limitation, so all packages should be restored there.
Get into the restore view using the following method:
Open the Azure DevOps tab (DevOps > Azure DevOps), then click the Restore button next to the organization whose backup you want to restore (recover
icon in list view).
You can also use the Explore button to restore your data.
Go to the Projects & repositories tab and search for the project you want to restore, then click the Restore button in the action menu of that project.
Select the backup plan from which you want to restore data. Click the drop-down under Backup plans section and choose one of the plans from the list.
Choose the backup version from all the backups that have already been performed — select the desired date and click the Restore button.
Select the destination for the recovery and click Next.
You can choose any device or organization registered in GitProtect.
Select the data to restore and click Restore selected or Restore all to proceed.
GitProtect allows you to select specific metadata to restore — each element can be included or excluded by toggling the switch next to it.
The available data to restore depends on the restoration destination.
In the Data to restore section at the top, you can edit the previously selected data to restore if needed.
In the Restore to section, you can change the previously selected recovery destination if needed.
In the Throttling prevention section, you can add additional Azure DevOps accounts to avoid throttling.
Configure the recovery destination settings, depending on where the backup will be restored.
Restore to a Git organization
Select the target organization.
If you are restoring your project to Azure DevOps or DevOps Server organization:
Set a unique, custom name for the project in Restore settings (or use the custom name automatically generated by GitProtect).
Choose whether to restore repositories from the project's copy:
When the Restore repositories from this project's copy switch is turned off during the restore process, along with the project, all of its protected repositories are restored. This applies regardless of whether the repositories were protected by the same plan or by different plans. The latest available backups are used.
When the switch is turned on, a different restore mechanism is applied. In this case, only repositories backed up by the same plan as the project are restored.
Due to required changes, the latter mechanism is not available for backups created with versions earlier than 2.0.5 or for workers running versions lower than 2.0.5.
If you are restoring your project to a different Git organization than the original (for example, Bitbucket, GitLab, etc.), you have to set custom names for all repositories in the project or add a suffix to the original repository names. You can also choose whether to add a label to the restored elements.
If the custom name or the original repository name already exists in the selected Git organization, the restore will fail. To complete the restoration successfully, you must choose unique repository names or select the Add suffix to repo name option so the restored repositories keep their original names with an automatically generated suffix.
Adjust the bandwidth settings.
Check which worker is set as the default for recovery and change it if necessary.
Restore to a device
To restore a repository to a local device, you must have a Git client installed on that device.
You can restore only the repository (without metadata) when restoring data to local resources.
Select the destination device (a registered device).
Make sure the device where you want to restore data has the GitProtect worker installed and the Git client added to the PATH environment variable. The PATH variable is usually configured automatically after Git installation (a system restart may be required). If it isn’t, set it manually to the path of the git.exe file:
C:\Program Files\Git\bin\git.exeTo configure the PATH variable, open the environment variables, select the PATH variable, and click the Edit button. Copy the path to the git.exe file and add it to the PATH variable.
Specify the restoration directory and configure other options (for example, whether to overwrite existing data or reduce bandwidth). If needed, you can create a new restoration folder on the selected drive from the Management Service level.
After defining all parameters, click the Restore button to begin the recovery process. When the process is complete, a new project/repository/folder will be created in your organization account/local device. You can monitor the restoration process in the Tasks tab.
Last updated