Restaurar um backup

Autopilot Padrão

Nesta página, descrevemos como restaurar um backup em um cluster no Google Kubernetes Engine (GKE) usando o serviço Backup para o GKE.

Introdução

Depois que um backup é criado, os administradores podem criar uma restauração para ele, que inicia a restauração de uma parte do conteúdo desse backup em um cluster de destino (que pode ser diferente do cluster em que o backup foi criado originalmente.

Quando um backup é restaurado, os recursos do Kubernetes são recriados no cluster de destino. Depois que os recursos são criados, a restauração da funcionalidade da carga de trabalho está sujeita ao processo de reconciliação de cluster regular. Por exemplo, os pods são programados para os nós e iniciados nesses nós.

Antes de começar

Planeje um conjunto de restaurações.

Funções exigidas

Para ter as permissões necessárias para criar e gerenciar uma restauração, peça ao administrador para conceder a você o Administrador de restauração do Backup para GKE (roles/gkebackup.restoreAdmin), que é um subconjunto do papel do IAM de administrador do Backup para GKE (roles/gkebackup.admin) no projeto. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Criar uma restauração

É possível restaurar um backup usando a Google Cloud CLI ou o Console do Google Cloud.

gcloud

Para restaurar um backup, execute o seguinte comando:

gcloud beta container backup-restore restores create RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --backup=BACKUP

Substitua:

RESTORE: o nome da restauração que você quer criar.
PROJECT_ID: o ID do seu projeto do Google Cloud.
LOCATION: a região de computação do plano de restauração pai.
RESTORE_PLAN: o nome do plano de restauração pai de origem da restauração.
BACKUP: o backup a ser restaurado. Ele precisa estar localizado no plano de backup a que o plano pai de restauração se refere:
- projects/PROJECT_ID/locations/LOCATION/backupPlans/BACKUP_PLAN/backups/BACKUP

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore restores create.

Console

Use as instruções a seguir para criar uma restauração no console do Google Cloud:

Acesse a página Google Kubernetes Engine no console do Google Cloud.

Acessar o Google Kubernetes Engine
No menu de navegação, clique em Backup para o GKE.
Clique na guia Backups.
Na lista de backups, encontre o backup que você quer restaurar e clique em Configurar uma restauração.
Escolha um plano de restauração na lista de planos que se aplicam a esse backup.
Insira um Nome e uma Descrição opcional para a restauração.
Clique em Restaurar.

Ver uma restauração

Veja uma restauração e os detalhes dela usando a gcloud CLI ou o Console do Google Cloud.

gcloud

Para listar as restaurações de um plano de restauração, execute o seguinte comando:

gcloud beta container backup-restore restores list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Somente para comandos list, é possível fornecer - como o valor de qualquer parâmetro, exceto PROJECT_ID. O valor - atua como um caractere curinga. Se você não especificar uma opção de linha de comando ou definir uma property, o valor - será o padrão para qualquer parâmetro.

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore restores list.

Para ver os detalhes de uma restauração, execute o seguinte comando:

gcloud beta container backup-restore restores describe RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore restores describe.

Console

Use as instruções a seguir para visualizar uma restauração e os detalhes dela no console do Google Cloud:

Acesse a página Google Kubernetes Engine no console do Google Cloud.

Acessar o Google Kubernetes Engine
No menu de navegação, clique em Backup para o GKE.
Clique na guia Restaurações.
Na lista de restaurações, clique no nome da restauração e veja os detalhes.

Ver uma restauração de volume

Uma restauração de volume é um registro de uma restauração de volume. Esse recurso é criado e gerenciado automaticamente pelo agente como parte da operação de restauração.

Visualize uma restauração de volume e os detalhes dela usando a gcloud CLI.

gcloud

Para listar todas as restaurações de volume para uma restauração, execute o seguinte comando:

gcloud beta container backup-restore volume-restores list \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --restore=RESTORE

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore volume-restores list.

Para ver os detalhes de uma restauração de volume, execute o seguinte comando:

gcloud beta container backup-restore volume-restores describe VOLUME_RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --restore=RESTORE

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore volume-restores describe.

Atualizar uma restauração

Atualize uma restauração usando a CLI gcloud ou o Console do Google Cloud.

gcloud

Para atualizar uma restauração, por exemplo, adicionando uma nova descrição, execute o seguinte comando:

gcloud beta container backup-restore restores update RESTORE\
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN \
    --description=DESCRIPTION

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore restores update.

Console

Use as instruções a seguir para atualizar uma restauração no console do Google Cloud:

Acesse a página Google Kubernetes Engine no console do Google Cloud.

Acessar o Google Kubernetes Engine
No menu de navegação, clique em Backup para o GKE.
Clique na guia Restaurar.
Na lista de restaurações, clique no nome da restauração.
No campo "Descrição", clique em Editar. Atualize a descrição e clique em Salvar alterações.

Excluir uma restauração

Ao contrário dos backups, as restaurações não têm artefatos associados. Depois de restaurar um backup, é possível excluí-lo sem afetar o cluster de destino ou o backup de origem.

É possível excluir uma restauração usando a gcloud CLI ou o Console do Google Cloud.

gcloud

Para excluir uma restauração, execute o seguinte comando:

gcloud beta container backup-restore restores delete RESTORE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --restore-plan=RESTORE_PLAN

Para ver a lista completa de opções, consulte a documentação do gcloud beta container backup-restore restores delete.

Console

Use as instruções a seguir para excluir uma restauração no console do Google Cloud:

Acesse a página Google Kubernetes Engine no console do Google Cloud.

Acessar o Google Kubernetes Engine
No menu de navegação, clique em Backup para o GKE.
Clique na guia Restaurações.
Na lista de restaurações, clique no nome da restauração.
Clique em Excluir.
Digite o nome do plano de restauração e clique em Excluir na caixa de diálogo de confirmação.

A seguir

Saiba mais sobre como planejar um conjunto de restaurações.