Mover uma instância

Nesta página, descrevemos como mover uma instância no Spanner.

É possível mover sua instância do Spanner de qualquer instância a qualquer outra configuração de instância, inclusive configurações regionais, birregionais e multirregionais. Transporte a instância não causar inatividade, e o Spanner continua fornecer as garantias de transação normais, incluindo consistência forte, durante a mudança.

Também é possível mover sua instância da configuração da instância de origem para uma configuração de instância personalizada (por exemplo, uma configuração base nam3 com uma réplica somente leitura us-west2). Como não é possível atualizar a topologia você precisa criar uma instância personalizada de rede com a topologia que você quer primeiro. Depois de criar a nova da instância, mova sua instância da instância de origem para a nova configuração da instância personalizada.

Por que mover sua instância do Spanner?

Os benefícios de mover sua instância incluem:

• Aumentar a disponibilidade: ter 99,999% de disponibilidade sem inatividade depois de realizar uma mudança regional para birregional ou multirregional.
• Reduzir latência: reduza a latência e aumente a cobertura geográfica com o réplicas somente leitura adicionais por meio de uma região regional para birregional ou multirregional ou multirregião para multirregião.
• Reduzir custos: reduza os custos por hora migrando de um local birregional ou multirregional. para uma configuração regional.
• Colocar banco de dados: colocar o banco de dados do Spanner com o aplicativo cliente movendo a instância para um local mais otimizado.

Preços

Ao mover uma instância, as configurações da instância de origem e de destino estão sujeitas a cobranças de computação e armazenamento horárias. Quando a migração for concluída, você será cobrado pelo armazenamento da instância no configuração de destino.

Se você estiver movendo sua instância para um novo local regional, birregional ou multirregional configuração da instância, você poderá estar sujeito a cobranças de transferência de dados de saída. Para mais informações, consulte Preços do Spanner.

Limitações

• Para mover sua instância, ela deve ter um mínimo de 1 nó (1.000 unidades de processamento).
• Não é possível mover sua instância entre projetos e contas do Google Cloud.
• Não é possível mover uma instância de teste gratuito do Spanner. É possível mover a instância após o upgrade para uma instância paga.
• Se você tiver solicitações ativas usando um endpoint de serviço regional em qualquer um dos recursos da instância, a movimentação da instância afeta todas as solicitações que usam o endpoint regional porque a aplicação regional bloqueia o acesso a instâncias entre regiões. As solicitações que usam um endpoint global são sem ser afetada.
• Os backups do Spanner são específicos para uma configuração de instância e não são incluídos na movimentação de uma instância. Para Para mais informações, consulte Backups.
• As seguintes APIs são desativadas durante uma movimentação de instância:
  • InstanceAdmin.DeleteInstance
  • InstanceAdmin.UpdateInstance
  • DatabaseAdmin.CreateDatabase
  • DatabaseAdmin.UpdateDatabaseDdl (desativado se default_leader for especificado na solicitação.
  • DatabaseAdmin.RestoreDatabase
  • DatabaseAdmin.CreateBackup
  • DatabaseAdmin.CopyBackup
• Não é possível mover instâncias que contêm qualquer componente ativado para CMEK bancos de dados.
• Se um banco de dados tiver um líder padrão modificado, a seleção será preservada se nomear uma região de leitura/gravação no configuração da instância de destino e essa configuração é multirregional. Se a configuração de destino for regional ou não incluem a região de leitura/gravação nomeada, a seleção líder padrão será limpos.
• Mover uma instância altera o atributo de configuração da instância instância. Se você gerencia os recursos do Spanner por automação, prepare e resolva quaisquer inconsistências que possam surgir.
  • Por exemplo, se você usar o Terraform para gerenciar instâncias e bancos de dados do Spanner e ative terraform apply --auto-approve para manter seus recursos sincronizados todas as instâncias e recursos filhos são excluídos quando a instância é movida. Atualize a configuração para evitar exclusão e perda de dados. Consulte Opções de aplicação do Terraform para mais informações sobre o comando apply.
• Enquanto a instância é movida, o serviço de monitoramento e os gráficos podem mostrar dados na origem e no destino configurações de instância da instância ou só pode refletir o desempenho em uma instância configuração do Terraform.
• Se você configurou a ferramenta de escalonamento automático de código aberto, precisará desativá-la. Ela falha porque InstanceAdmin.UpdateInstance (usado para alterações no nó e na unidade de processamento).

• Não é possível mover uma instância se o Escalonador automático gerenciado do Spanner está habilitado nele. Para mover a instância, é preciso desativar o escalonador automático gerenciado, mover a instância e reativar o escalonador automático.

  Além disso, se você estiver usando o escalonamento automático, você precisa provisionar nós suficientes para o uso máximo da CPU de acordo com o as recomendações máximas observadas e, em seguida, desative o escalonamento automático antes de mover a instância.

Considerações sobre desempenho

Quando uma instância está sendo movida, ela tem latências de leitura/gravação maiores e uma taxa de cancelamento de transação mais alta. O uso da CPU durante a migração pode aumentar para 100%, porque a movimentação da instância é realizada usando uma CPU extra provisionada pelo o usuário. No entanto, mover uma instância não causa inatividade. O horário para mover uma instância depende de vários fatores, incluindo o tamanho bancos de dados, o número de nós e o tipo de mudança (por exemplo, regional para multirregional).

Depois de mover uma instância, o desempenho dela varia de acordo com os detalhes da configuração da instância. Por exemplo: birregional e configurações multirregionais costumam ter maior latência de gravação e menor latência de leitura configurações regionais.

Backups

Quando você move uma instância, os backups na instância de origem não são movidos para a nova configuração de destino automaticamente. A movimentação da instância será cancelada se Existem backups na configuração da instância de origem quando você inicia a instância se moverem. É importante copiar seus backups e considerar as plano de recuperação de dados antes de migrar instância.

Se houver backups na instância de origem que precisem ser mantidos, recomendamos copie os backups para o configuração da instância de destino e outra instância com a mesma instância como a instância de origem a ser movida. Dessa forma:

• É possível copiar os backups para a configuração da instância de destino imediatamente após a conclusão da migração da instância.
• Se você precisar cancelar a movimentação da instância, será possível restaurar rapidamente seus backups da instância com a mesma configuração da origem configuração da instância.

Depois de copiar seus backups para outra instância, é necessário excluir na instância de origem antes de movê-la. Então, uma vez a movimentação da instância for concluída, você terá uma cópia do backup no configuração do Terraform. Também é possível criar um backup.

Para saber mais sobre como copiar backups e os custos associados, consulte Copiar um backup.

Como mover uma instância

É possível mover uma instância usando o Cloud Shell do console do Google Cloud e a CLI gcloud usando os comandos gcloud.

Pré-requisitos

Antes de mover a configuração da instância, verifique se você leia as Limitações e Considerações sobre desempenho em outras seções. Em seguida, siga estas etapas:

1. Verifique se você tem a permissão do IAM spanner.instances.update na instância de origem.
2. Se aplicável, mova as instâncias que não são de produção. (como teste e preparo) antes de mover as instâncias de produção para ajudar avaliar e entender o impacto no desempenho das cargas de trabalho durante uma instância se moverem.
3. Quando você move uma instância do Spanner, o processo de mudança exclui as tags de instância que você criou Data Catalog. Para preservar sua você precisará exportá-las antes da movimentação e importá-las após a movimentação. Para mais informações, consulte Exportar e importar tags.

Para ter acesso às práticas recomendadas, siga também estas diretrizes:

• Testar cargas de trabalho de desempenho em instâncias de não produção no destino antes de mover a instância de produção. Testar mover uma instância de teste semelhante à sua instância de produção para ter uma noção de quanto tempo levará para mover sua instância de produção.
• Use o Key Visualizer para verificar se não há pontos de acesso nos seus bancos de dados.
• Verifique se você tem uma cota de nós suficiente na configuração da instância de destino para dar suporte ao pico de uso esperado da instância. Para mais informações, consulte Cotas do Spanner e Limites.
• Verifique se o uso máximo da CPU de sua instância for menor que 40% para a configuração da instância movida e a quantidade de armazenamento por nó for menor que 1 tebibyte (TiB);
• Não faça alterações na instância durante a movimentação. Isso inclui alterar o número de nós da instância, alterar esquemas do banco de dados, criação ou eliminação de bancos de dados e criação ou exclusão de backups.

Se você mover sua instância de acordo com essas recomendações, a migração geralmente é concluído em até 24 horas. No entanto, dependendo do aplicativo carga de trabalho, o tempo de conclusão pode ser maior ou menor.

Mover uma instância

Console do Google Cloud

1. Clique em . Ative o Cloud Shell na parte superior do console do Google Cloud.

   Uma sessão do Cloud Shell é aberta em um novo frame no na parte de baixo do console do Google Cloud e mostra um prompt de linha de comando. A inicialização da sessão pode levar alguns segundos.

2. Usar o gcloud spanner instances move para mover a instância.

   gcloud spanner instances move INSTANCE_ID \
   --target-config=TARGET_CONFIG
   

   Substitua:

   • INSTANCE_ID: o identificador permanente da instância que que você quer mover.
   • TARGET_CONFIG: um identificador permanente da instância. para onde quer mover a instância. A nova área geográfica o local da instância. Pode ser regional, birregional, multirregional ou de instância personalizada (por exemplo, nam3, us-central1 ou custom-nam3-us-west2).

Por exemplo, para mover a instância test-instance da atual configuração da instância como nam3, execute o seguinte:

  gcloud spanner instances move test-instance --target-config=nam3

Opcional: se você quiser adicionar uma réplica somente leitura, us-west2, à base configuração da instância nam3, faça o seguinte:

1. Clone a configuração de base e adicione a réplica somente leitura:

   gcloud spanner instance-configs create custom-nam3-us-west2 \
   --clone-config=nam3 --add-replicas=location=us-west2, type=READ_ONLY
   

2. Mover a instância test-instance da instância atual para esta nova configuração de instância custom-nam3-us-west2:

   gcloud spanner instances move test-instance --target-config=custom-nam3-us-west2
   

CLI da gcloud

Usar o gcloud spanner instances move para mover a instância.

gcloud spanner instances move INSTANCE_ID \
--target-config=TARGET_CONFIG

Substitua:

• INSTANCE_ID: o identificador permanente da instância que que você quer mover.
• TARGET_CONFIG: um identificador permanente da instância. para onde quer mover a instância. A nova área geográfica o local da instância. Pode ser regional, birregional ou configuração de instância multirregional (por exemplo, nam3, us-central1, ou custom-nam3-us-west2).

Por exemplo, para mover a instância test-instance da atual configuração da instância como nam3, execute o seguinte:

  gcloud spanner instances move test-instance --target-config=nam3

Opcional: se você quiser adicionar uma réplica somente leitura, us-west2, à base configuração da instância nam3, faça o seguinte:

1. Clone a configuração de base e adicione a réplica somente leitura:

   gcloud spanner instance-configs create custom-nam3-us-west2 \
   --clone-config=nam3 --add-replicas=location=us-west2, type=READ_ONLY
   

2. Mover a instância test-instance da instância atual para esta nova configuração de instância custom-nam3-us-west2:

   gcloud spanner instances move test-instance --target-config=custom-nam3-us-west2
   

Como monitorar o progresso da movimentação e do cancelamento da instância

Você pode usar gcloud spanner operations describe ou criar um Painel do Cloud Monitoring para monitorar o progresso de uma movimentação de instância.

Ver o progresso da operação de movimentação e cancelamento

Para acompanhar o progresso de uma movimentação ou cancelamento de movimentação de uma instância operação, use o método gcloud spanner operations describe kubectl. Esse comando exige o ID da operação da movimentação de instância em andamento. operação

1. Para saber o ID da operação de transferência da instância, execute o seguinte comando:

   gcloud spanner operations list --instance="INSTANCE_ID"
   

   Substitua:

   • INSTANCE-ID: o identificador permanente da instância que você querem se mover.

   A saída mostra uma lista de operações de longa duração, incluindo a migração de instância operação

2. Execute o comando gcloud spanner operations describe para conferir o progresso porcentagem e status:

   gcloud spanner operations describe OPERATION_ID --instance=INSTANCE_ID
   

   Substitua:

   • OPERATION_ID: o ID da operação de movimentação da instância. que você quer verificar.
   • INSTANCE_ID: o ID da instância que você quer verificação.

Monitorar uma operação de movimentação de instância

É possível criar um painel personalizado do Cloud Monitoring para exibir durante a movimentação da instância, uma operação de longa duração com potencial implicações do serviço.

Os gráficos Armazenamento total e Armazenamento total do banco de dados por banco de dados no painel são úteis para monitorar o progresso da mudança. Confira o na configuração de origem cai gradualmente enquanto o armazenamento na a configuração de destino aumenta.

Console do Google Cloud

1. Faça o download do move-instance-dashboard.json . Esse arquivo tem as informações necessárias para preencher um painel personalizado no Monitoring.

2. No console do Google Cloud, acesse a página  Painéis:

   Ir para Painéis

   Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoramento.

3. Na página Visão geral dos painéis, clique em Criar painel.
4. Na barra de ferramentas do painel, clique no menu suspenso Configurações do painel. Depois, Selecione JSON e, em seguida, Editor do JSON.
5. No painel JSON Editor, copie o conteúdo do move-instance-dashboard.json do qual você fez o download e colá-lo no editor.
6. Para aplicar as mudanças ao painel, clique em Aplicar alterações. Se você não quiser usar este painel, volte para "Painéis" Página de visão geral.
7. Depois que o painel for criado, clique em Adicionar filtro. Em seguida, selecione project_id ou instance_id para monitorar o progresso da instância. se moverem.

CLI da gcloud

1. Faça o download do move-instance-dashboard.json . Esse arquivo tem as informações necessárias para preencher um painel personalizado no Monitoring.

2. Para criar um painel em um projeto, use o comando gcloud monitoring dashboards create:

   gcloud monitoring dashboards create --config-from-file=move-instance-dashboard.json
   

   Para mais informações, consulte a referência gcloud monitoring dashboards create.

Como cancelar uma movimentação de instância

Só é possível cancelar uma movimentação de instância que ainda está em andamento. Se você quiser reverter uma movimentação de instância já concluída, terá que iniciar uma nova movimentação.

Você pode usar gcloud spanner operations cancel para cancelar operações de movimentação de instâncias. O cancelamento não é instantâneo e leva aproximadamente o mesmo tempo decorrido desde a início da mudança. Isso ocorre porque os dados precisam ser movidos de volta para a instância de origem configuração do Terraform.

Esse comando exige o ID da operação da movimentação de instância em andamento. operação

1. Encontre o ID da operação executando:

   gcloud spanner operations list --type=INSTANCE --instance="INSTANCE_ID"
   --filter="done:False AND metadata.@type:MoveInstanceMetadata
   

   Substitua:

   • INSTANCE_ID: o identificador permanente da instância que você querem se mover.

   A saída mostra uma lista de operações de movimentação de instâncias em andamento.

2. Execute o comando gcloud spanner operations cancel para cancelar a instância mover:

   gcloud spanner operations cancel OPERATION_ID
   

   Substitua:

   • OPERATION_ID: o ID da operação de movimentação da instância que que você quer cancelar.

A seguir

• Saiba mais sobre o Spanner Configurações regionais, birregionais e multirregionais.
• Saiba mais sobre as regiões e zonas do Google Cloud.