Definir o comportamento de restauração dos dados de volume
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Autopilot
Standard
Esta página oferece uma visão geral das políticas de restauração de dados de volume. Saiba
também como configurar vinculações e substituições das políticas de restauração de dados de volume.
Visão geral
A política de restauração dos dados de volume define como restaurar dados de volume de um backup.
É possível configurá-la no nível do plano de restauração. Ela tem as seguintes opções de política:
Provisionar novos volumes e restaurar dados de volume do backup: novos
volumes permanentes (PVs) são restaurados usando o volume correspondente de
dados de backup no backup.
Reutilizar volumes atuais que contêm dados: os PVs são pré-provisionados
usando a alça de volume do PV original no backup.
Não restaurar dados de volume: os PVs não são restaurados. O Backup apenas para GKE
restaura as declarações de volume permanentes (PVCs, na sigla em inglês) selecionadas e espera que o
driver de armazenamento correspondente para provisionar dinamicamente PVs em branco
ou vinculá-los a PVs pré-provisionados criados fora da banda.
Para instruções sobre como criar um plano com a política de restauração de dados de volume,
consulte Criar um plano de restauração.
Existem alguns motivos para definir uma restauração de volume personalizada
diferente da política de restauração de dados de volume padrão:
Para restaurar uma carga de trabalho com um ambiente de armazenamento que inclua
tipos de volumes com diferentes níveis de suporte ao backup de dados. Por exemplo:
a carga de trabalho pode conter volumes NFS e Persistent Disk.
Para aplicar um processo de restauração diferente a um volume específico.
O Backup para GKE fornece dois mecanismos para definir o comportamento personalizado da restauração de volume:
Vinculações específicas de tipo de volume, que podem ser definidas como parte de um plano de restauração.
Substituições específicas de volume, que podem ser definidas como parte de uma restore.
Processo de seleção da política de restauração de dados de volume
Durante o processo de restauração, o Backup para GKE seleciona o volume adequado
de restauração para todos PersistentVolumeClaim (PVCs) usando a seguinte sequência:
Antes de aplicar qualquer regra de transformação, todos PVCs são restaurados
por um processo de seleção e a primeira política no escopo é aplicada.
Se o PVC não estiver vinculado a um PersistentVolume (PV), somente a configuração de PVC
será restaurada. Isso não inclui qualquer tipo de dados.
Se o PVC estiver incluído em uma substituição de política de restauração de dados de volume, a
política de modificação tem precedência.
Se o tipo de volume do PVC estiver incluído em uma vinculação de política de restauração de dados de volume,
a política de vinculação será aplicada.
Se nenhuma das condições anteriores for correspondente, o PVC vai usar a política de restauração
dos dados de volume.
.
Vinculações da política de restauração de dados de volume
As vinculações da política de restauração de dados de volume permitem restaurar dados de volume com uma
política para um tipo específico de volume. Essa política tem precedência sobre a
política de restauração de volume padrão. A vinculação da política de restauração de dados de volume só é
compatível com os Persistent Disks do Compute Engine.
gcloud
Adicione vinculações de política de restauração de dados de volume a um plano de restauração:
VOLUME_TYPE=POLICY: vincula um tipo de volume compatível a
uma política de restauração de dados de volume. Por exemplo, gce-persistent-disk=restore-volume-data-from-backup.
cria uma vinculação que resulta na restauração dos volumes do Persistent Disk usando
a política Restaurar dados de volume do backup.
Console
Use as instruções a seguir para adicionar vinculações a um plano de restauração no console do Google Cloud:
No Console do Google Cloud, acesse a página do Google Kubernetes Engine.
Na seção Restaurar configuração, clique em Editar ao lado de Escopo.
Na seção Definir a substituição da política para tipos de volume específicos,
clique na caixa de seleção Persistent Disk do GCE.
Na lista Política de restauração de dados de volume, escolha uma política de restauração
que você quer usar no Persistent Disk do Compute Engine.
Clique em Salvar.
Substituições de política de restauração de dados de volume
As substituições da política de restauração de dados de volume definem como restaurar volumes específicos.
Os volumes são selecionados pelos namespaces e nomes de PVC deles. É possível incluir
vários volumes em uma única substituição.
As substituições não impõem um escopo exclusivo, ao contrário das vinculações. Isso significa que, durante
a restauração de volume, a política da última substituição que corresponde ao
namespace e nome são usados.
Exemplo de substituição
O exemplo a seguir substitui ns-1/test-pvc e ns-1/test-pvc-2 para usar
a política Reutilizar volumes atuais que contêm dados e ns-2/test-pvc-3
para usar a política Não restaurar dados de volume.
RESTORE_PLAN: o nome do plano de restauração
pai de origem da restauração.
BACKUP: o backup a ser restaurado.
OVERRIDES_FILE: o caminho para um arquivo YAML que define
no esquema, como mostrado no exemplo.
Console
Para criar uma substituição de política de restauração de dados de volume, é preciso fornecer o
nome de PVC, namespace de PVC e uma política de restauração.
Use as instruções a seguir para criar uma restauração com substituições no console do Google Cloud:
No Console do Google Cloud, acesse a página do Google Kubernetes Engine.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2024-11-21 UTC."],[],[],null,["# Define volume data restore behavior\n\nAutopilot Standard\n\n*** ** * ** ***\n\nThis page provides an overview of volume data restore policies. It also\nexplains how to configure volume data restore policy bindings and overrides.\n\nOverview\n--------\n\nThe volume data restore policy defines how to restore volume data from a backup.\nYou can configure it at the restore plan level. It has the following policy options:\n\n- **Provision new volumes and restore volume data from backup**: New persistent volumes (PVs) are restored using the corresponding volume backup data in the backup.\n- **Reuse existing volumes containing your data**: PVs are pre-provisioned using the volume handle of the original PV in the backup.\n- **Don't restore volume data**: PVs aren't restored. Backup for GKE only restores the selected persistent volume claims (PVCs) and expects the corresponding storage driver to either dynamically provision blank PVs or bind them to pre-provisioned PVs created out-of-band.\n\nFor instructions on creating a restore plan with volume data restore policy,\nsee [Create a restore plan](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore-plan#create_a_restore_plan).\n\nThere are a few reasons why you might want to define custom volume restore\nbehavior apart from the default volume data restore policy:\n\n- To restore a workload with a storage environment that includes different types of volumes with varying levels of data backup support. For example, your workload may contain NFS volumes and Persistent Disk volumes.\n- To apply a different restore process to a specific volume.\n\nBackup for GKE provides two mechanisms for defining custom volume restore behavior:\n\n- Volume type specific bindings, which you can define as part of a [restore plan](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore-plan#create_a_restore_plan).\n- Volume specific overrides, which you can define as part of a [restore](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore#create_a_restore).\n\nVolume data restore policy selection process\n--------------------------------------------\n\nDuring the restore process, Backup for GKE selects the appropriate volume\nrestore policy for each PersistentVolumeClaim (PVC) using the following sequence:\n\n1. Before any transformation rules are applied, each PVC to be restored moves through a selection process and applies the first in-scope policy.\n2. If the PVC is not bound to a backed up PersistentVolume (PV), only the PVC configuration is restored. This doesn't include any data.\n3. If the PVC is included in a volume data restore policy override, the override policy takes precedence.\n4. If the PVC's volume type is included in a volume data restore policy binding, the binding policy is applied.\n5. If none of the earlier conditions match, the PVC uses the default volume data restore policy.\n\n| **Note:** If the **Provision new volumes and restore volume data from backup** policy is applied to a volume without a volume backup, Backup for GKE restores the PVC configuration without data.\n\nVolume data restore policy bindings\n-----------------------------------\n\nThe volume data restore policy bindings let you restore volume data with a\npolicy for a specific volume type. This policy takes precedence over the\ndefault volume restore policy. The volume data restore policy binding is only\nsupported for Compute Engine Persistent Disks. \n\n### gcloud\n\nAdd volume data restore policy bindings to an existing restore plan: \n\n gcloud beta container backup-restore restore-plans update \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e \\\n --volume-data-restore-policy-bindings=[\u003cvar translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-nv\"\u003eVOLUME_TYPE\u003c/span\u003e\u003cspan class=\"devsite-syntax-o\"\u003e=\u003c/span\u003ePOLICY,...\u003c/var\u003e]\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e: the name of the restore plan that you want to update.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the [compute region](/compute/docs/regions-zones#available) for the resource, such as `us-central1`.\n- \u003cvar translate=\"no\"\u003eVOLUME_TYPE=POLICY\u003c/var\u003e: binds a supported volume type to a volume data restore policy. For example, `gce-persistent-disk=restore-volume-data-from-backup` creates a binding that results in Persistent Disk volumes being restored using the **Restore volume data from backup** policy.\n\n### Console\n\nUse the following instructions to add bindings to an existing restore plan in the Google Cloud console:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine** page.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. In the navigation menu, click **Backup for GKE**.\n\n3. Click the **Restore plans** tab.\n\n4. Click the restore plan name.\n\n5. Click the **Details** tab.\n\n6. In the **Restore configuration** section, click **Edit** that is next to **Scope**.\n\n7. In the **Define policy override for specific volume types** section,\n click the **GCE Persistent Disk** checkbox.\n\n8. From the **Volume data restore policy** list, choose a restore policy\n type that you want to use for Compute Engine Persistent Disk.\n\n9. Click **Save changes**.\n\nVolume data restore policy overrides\n------------------------------------\n\nThe volume data restore policy overrides define how to restore specific volumes.\nVolumes are selected by their PVC namespaces and PVC names. You can include\nmultiple volumes in a single override.\n\nOverrides don't enforce unique scoping, unlike bindings. This means that during\nvolume restoration, the policy from the latest override that matches a volume's\nnamespace and name is used.\n\n### Override example\n\nThe following example overrides `ns-1/test-pvc` and `ns-1/test-pvc-2` to use\nthe **Reuse existing volumes containing your data** policy and `ns-2/test-pvc-3`\nto use the **Don't restore volume data** policy. \n\n volumeDataRestorePolicyOverrides:\n - policy: REUSE_VOLUME_HANDLE_FROM_BACKUP\n selectedPvcs:\n namespacedNames:\n - namespace: ns-1\n name: test-pvc\n - namespace: ns-1\n name: test-pvc-2\n - policy: NO_VOLUME_DATA_RESTORATION\n selectedPvcs:\n namespacedNames:\n - namespace: ns-2\n name: test-pvc-3\n\n### gcloud\n\nCreate a restore with overrides: \n\n gcloud beta container backup-restore restores create \u003cvar translate=\"no\"\u003eRESTORE\u003c/var\u003e \\\n --project=\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e \\\n --location=\u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e \\\n --restore-plan=\u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e \\\n --backup=\u003cvar translate=\"no\"\u003eBACKUP\u003c/var\u003e \\\n --volume-data-restore-policy-overrides-file=\u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e\n\nReplace the following:\n\n- \u003cvar translate=\"no\"\u003eRESTORE\u003c/var\u003e: the name of the restore that you want to create.\n- \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: the ID of your Google Cloud project.\n- \u003cvar translate=\"no\"\u003eLOCATION\u003c/var\u003e: the [compute region](/compute/docs/regions-zones#available) of the parent restore plan.\n- \u003cvar translate=\"no\"\u003eRESTORE_PLAN\u003c/var\u003e: the name of the parent restore plan this restore is derived from.\n- \u003cvar translate=\"no\"\u003eBACKUP\u003c/var\u003e: the backup to restore.\n- \u003cvar translate=\"no\"\u003eOVERRIDES_FILE\u003c/var\u003e: the path to a YAML file that defines overrides in the schema as seen in the example.\n\n### Console\n\nTo create a volume data restore policy override, you need to provide the\nPVC name, PVC namespace, and a restore policy.\n\nUse the following instructions to create a restore with overrides in the Google Cloud console:\n\n1. In the Google Cloud console, go to the **Google Kubernetes Engine** page.\n\n [Go to Google Kubernetes Engine](https://console.cloud.google.com/kubernetes/list)\n2. In the navigation menu, click **Backup for GKE**.\n\n3. Click the **Backups** tab.\n\n4. In the list of backups, find the backup that you want to restore and click **Set up a restore**.\n\n5. Choose a restore plan from the list of plans that apply to this backup.\n\n6. In the **Name the restore** section, enter a name and optional description for the restore.\n\n7. In the **Override volume data restore policy** section, click **Add policy**\n and complete the following for each override:\n\n 1. In **PVC name**, enter the name of the PVC.\n 2. In **Namespace**, enter the namespace of the PVC.\n 3. From the **Volume restore policy** list, choose how to restore that PVC's volume data.\n8. Click **Restore**.\n\nWhat's next\n-----------\n\n- Learn more about [restoring a backup](/kubernetes-engine/docs/add-on/backup-for-gke/how-to/restore)."]]