You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/backup/azure-kubernetes-service-cluster-restore.md
+18-78Lines changed: 18 additions & 78 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -16,8 +16,8 @@ This article describes how to restore backed-up Azure Kubernetes Service (AKS).
16
16
17
17
Azure Backup now allows you to back up AKS clusters (cluster resources and persistent volumes attached to the cluster) using a backup extension, which must be installed in the cluster. Backup vault communicates with the cluster via this Backup Extension to perform backup and restore operations.
18
18
19
-
>[!Note]
20
-
>Vaulted backup and Cross Region Restore for AKS using Azure Backup are currently in preview.
19
+
>[!NOTE]
20
+
>Vaulted backup and Cross Region Restore for AKS using Azure Backup are currently in preview.
21
21
22
22
## Before you start
23
23
@@ -33,97 +33,37 @@ For more information on the limitations and supported scenarios, see the [suppor
33
33
34
34
To restore the backed-up AKS cluster, follow these steps:
35
35
36
-
1. Go to **Backup center** and select **Restore**.
37
-
38
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/start-kubernetes-cluster-restore.png" alt-text="Screenshot shows how to start the restore process.":::
39
-
40
-
2. On the next page, select **Select backup instance**, and then select the *instance* that you want to restore.
41
-
42
-
If the instance is available in both *Primary* and *Secondary Region*, select the *region to restore* too, and then select **Continue**.
43
-
44
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-backup-instance-for-restore.png" alt-text="Screenshot shows selection of backup instance for restore.":::
45
-
46
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/choose-instances-for-restore.png" alt-text="Screenshot shows choosing instances for restore.":::
3. Click **Select restore point** to select the *restore point* you want to restore.
51
-
52
-
If the restore point is available in both Vault and Operation datastore, select the one you want to restore from.
53
-
54
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-restore-points-for-kubernetes.png" alt-text="Screenshot shows how to view the restore points.":::
55
-
56
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/choose-restore-points-for-kubernetes.png" alt-text="Screenshot shows selection of a restore point.":::
57
-
58
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/open-restore-page.png" alt-text="Screenshot shows how to go to the Restore page.":::
59
-
60
-
61
-
4. In the **Restore parameters** section, click **Select Kubernetes Service** and select the *AKS cluster* to which you want to restore the backup to.
62
-
63
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/parameter-selection.png" alt-text="Screenshot shows how to initiate parameter selection.":::
64
-
65
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-kubernetes-service-parameter.png" alt-text="Screenshot shows selection of parameter Kubernetes Service.":::
66
-
67
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/set-for-restore-after-parameter-selection.png" alt-text="Screenshot shows the Restore page with the selection of Kubernetes parameter.":::
68
-
69
-
5. To select the *backed-up cluster resources* for restore, click **Select resources**.
70
-
71
-
Learn more about [restore configurations](#restore-configurations).
72
-
73
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-resources-to-restore-page.png" alt-text="Screenshot shows the Select Resources to restore page.":::
74
-
75
-
6. If you selected a recovery point for restore from *Vault-standard datastore*, then provide a *snapshot resource group* and *storage account* as the staging location.
76
-
77
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/restore-parameters.png" alt-text="Screenshot shows the parameters to add for restore from Vault-standard storage.":::
78
-
79
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/restore-parameter-storage.png" alt-text="Screenshot shows the storage parameter to add for restore from Vault-standard storage.":::
80
-
81
-
>[!Note]
82
-
>Currently, resources created in the staging location can't belong within a Private Endpoint. Ensure that you enable _public access_ on the storage account provided as a staging location.
83
-
84
-
7. Select **Validate** to run validation on the cluster selections for restore.
85
-
86
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/validate-restore-parameters.png" alt-text="Screenshot shows the validation of restore parameters.":::
87
-
88
-
89
-
8. Once the validation is successful, select **Review + restore** and restore the backups to the selected cluster.
90
-
91
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/review-restore-tab.png" alt-text="Screenshot shows the Review + restore tab for restore.":::
36
+
1. In the Azure portal, navigate to your AKS cluster resource.
37
+
1. From the service menu, under **Settings**, select **Backup** > **Restore**.
38
+
1. On the *Start: Restore* page, select **Select backup instance**, select the *instance* that you want to restore, and then select **Select** > **Continue**.
39
+
1. On the *Basics* tab of the *Restore* page, select the *Restore Region* you want to restore the backup to, and then select **Next: Restore point**.
40
+
1. Select **Select restore point**, select the *restore point* you want to restore from, and then select **Select** > **Next: Restore parameters**.
41
+
1. On the *Restore parameters* tab, ensure that the *AKS cluster* is selected as the *restore target*, and then select **Validate**.
42
+
1. Once the validation completes, select **Next: Review + restore** > **Restore**.
92
43
93
44
### Restore configurations
94
45
95
-
As part of item-level restore capability of AKS backup, you can utilize multiple restore configuration filters to perform restore.
46
+
As part of item-level restore capability of AKS backup, you can utilize multiple restore configuration filters to perform restore.
96
47
97
-
- Select the *Namespaces* that you want to restore from the list. The list shows only the backed-up Namespaces.
48
+
-On the *Restore parameters* tab, next to *Restore configuration*, select **Select resources**, and select the *Namespaces* that you want to restore from the list. The list shows only the backed-up namespaces.
98
49
99
50
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-namespace.png" alt-text="Screenshot shows selection of Namespace.":::
100
51
101
-
You can also select the checkboxes if you want to restore cluster scoped resources and persistent volumes (of Azure Disk only).
102
-
103
-
To restore specific cluster resources, use the labels attached to them in the textbox. Only resources with the entered labels are backed up.
104
-
105
52
- You can provide *API Groups* and *Kinds* to restore specific resource types. The list of *API Group* and *Kind* is available in the *Appendix*. You can enter *multiple API Groups*.
53
+
- To restore a workload, such as Deployment from a backup via API Group, the entry should be:
106
54
107
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/use-api-for-restore.png" alt-text="Screenshot shows the usage of API for restore.":::
108
-
109
-
- To restore a workload, such as Deployment from a backup via API Group, the entry should be:
110
-
111
-
-**Kind**: Select **Deployment**.
112
-
-**Group**: Select **Group**.
113
-
-**Namespace Mapping**: To migrate the backed-up cluster resources to a different *Namespace*, select the *backed-up Namespace*, and then enter the *Namespace* to which you want to migrate the resources.
114
-
115
-
If the *Namespace* doesn't exist in the AKS cluster, it gets created. If a conflict occurs during the cluster resources restore, you can skip or patch the conflicting resources.
116
-
117
-
:::image type="content" source="./media/azure-kubernetes-service-cluster-restore/select-backed-up-namespace-for-migrate.png" alt-text="Screenshot shows the selection of namespace for migration.":::
55
+
-**Kind**: Select **Deployment**.
56
+
-**Group**: Select **Group**.
57
+
-**Namespace Mapping**: To migrate the backed-up cluster resources to a different *Namespace*, select the *backed-up Namespace*, and then enter the *Namespace* to which you want to migrate the resources.
118
58
119
59
Azure Backup for AKS currently supports the following two options when doing a restore operation when resource clash happens (backed-up resource has the same name as the resource in the target AKS cluster). You can choose one of these options when defining the restore configuration.
120
60
121
61
-**Skip**: This option is selected by default. For example, if you backed up a PVC named *pvc-azuredisk* and you're restoring it in a target cluster that has the PVC with the same name, then the backup extension skips restoring the backed-up persistent volume claim (PVC). In such scenarios, we recommend you to delete the resource from the cluster, and then do the restore operation.
122
62
123
-
-**Patch**: This option allows the patching mutable variable in the backed-up resource on the resource in the target cluster. If you want to update the number of replicas in the target cluster, you can opt for patching as an operation.
63
+
-**Patch**: This option allows the patching mutable variable in the backed-up resource on the resource in the target cluster. If you want to update the number of replicas in the target cluster, you can opt for patching as an operation.
124
64
125
-
>[!Note]
126
-
>AKS backup currently doesn't delete and recreate resources in the target cluster if they already exist. If you attempt to restore Persistent Volumess in the original location, delete the existing Persistent Volumes, and then do the restore operation.
65
+
>[!NOTE]
66
+
>AKS backup currently doesn't delete and recreate resources in the target cluster if they already exist. If you attempt to restore Persistent Volumes in the original location, delete the existing Persistent Volumes, and then do the restore operation.
> You can change the subnet of a primary network interface while the virtual machine is started. You can't change the subnet of a secondary network interface in the same manner. To change the subnet of a secondary network interface, you must first stop and de-allocate the virtual machine.
505
+
503
506
### Add or remove from application security groups
504
507
505
508
You can add NICs only to application security groups in the same virtual network and location as the NIC.
0 commit comments