Nesta página, descrevemos como restaurar um backup em um cluster no Google Kubernetes Engine (GKE) usando o serviço Backup para o GKE.
Esta página é destinada a administradores de backup e recuperação de desastres (DR) que gerenciam e executam recuperações em toda a organização. Para saber mais sobre papéis comuns e tarefas de exemplo referenciados no conteúdo do Google Cloud, consulte Tarefas e funções de usuário comuns do GKE Enterprise.
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 papel do IAM de
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 seu projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
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.
No menu de navegação, clique em Backup para 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.
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.
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 edit 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.
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 deleteExcluir.
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.