Escalonar uma implantação de VM

Para lidar com o tráfego de banco de dados em mudança ou armazenar mais partições, ajuste o número de nós de servidor no ambiente de máquina virtual. Use estes procedimentos para gerenciar implantações de VM.

Antes de começar

Para escalonar a implantação de VM, siga estas etapas:

Como prática recomendada, escalone verticalmente até 32 GB de memória por servidor antes de adicionar mais servidores para escalonar horizontalmente.

Adicionar servidores raiz

Para adicionar um novo servidor raiz a uma implantação de VM, siga estas etapas:

  1. Inicie um novo servidor em uma nova VM em uma zona atual. Inicialize o servidor usando o comando spanner start. O exemplo a seguir inicia um servidor raiz:

    spanner start \
  --root \
  --server-address=HOSTNAME \
  --zone=ZONE \
  --base-dir=BASE_DIR

    Substitua:

    • HOSTNAME: o nome de domínio totalmente qualificado (FQDN) ou o nome do host da nova VM que pode ser resolvido. Por exemplo, new-root-server.example.com.
    • ZONE: a zona de destino. Por exemplo, us-central1-a.
    • BASE_DIR: o caminho do diretório em que os dados são armazenados. Por exemplo, /spanner.

  2. Adicione o servidor à implantação atual. Registre o novo servidor raiz com a implantação principal. Verifique se os argumentos de nome do host e porta correspondem aos parâmetros usados no comando spanner start e especifique a zona a ser atribuída ao servidor raiz.

    spanner deployment servers create SERVER_ENDPOINT \
  --zone=ZONE \
  --deployment-endpoint=ENDPOINT

    Substitua:

    • SERVER_ENDPOINT: o endereço do novo servidor raiz. Por exemplo, new-root-server.example.com:15000.
    • ZONE: a zona de destino. Por exemplo, us-central1-a.
    • ENDPOINT: o endpoint da implantação principal. Por exemplo, my-spanner-deployment:15000.

    O comando spanner deployment servers create inicia uma operação de longa duração para adicionar o servidor à implantação. As operações de longa duração podem levar um tempo considerável para serem concluídas. Para mais informações, consulte Gerenciar e observar operações de longa duração na documentação do Spanner.

  3. Verifique se o servidor entrou na implantação. Liste os servidores para verificar se o servidor foi registrado e fez a transição para o estado Ready:

    spanner deployment servers list \
  --zone=ZONE \
  --deployment-endpoint=ENDPOINT

Adicionar servidores não raiz

Para adicionar um servidor não raiz, inicie o processo spanner em uma VM e configure-o para se conectar a um ou mais servidores raiz no cluster para entrar na implantação.

Este exemplo inicia um servidor não raiz e o adiciona à implantação:

spanner start \
  --server-address=HOSTNAME \
  --join-servers=JOIN_SERVERS \
  --zone=ZONE \
  --base-dir=BASE_DIR

Substitua:

  • HOSTNAME: o nome do host da nova VM. Por exemplo, new-non-root-server.example.com.
  • JOIN_SERVERS: uma lista separada por vírgulas de endpoints de servidores raiz atuais. Por exemplo, root-server1.example.com:15000.
  • ZONE: o nome da zona. Por exemplo, us-central1-a.
  • BASE_DIR: o caminho do diretório em que os dados são armazenados. Por exemplo, /spanner.

Remover servidores

Siga as mesmas etapas para remover um servidor raiz ou não raiz. Se você estiver removendo um servidor raiz, mantenha um número ímpar de servidores raiz totais na implantação (entre 1 e 9).

Para desativar um servidor de VM, siga estas etapas:

  1. Exclua o servidor da implantação:

    spanner deployment servers delete SERVER_ENDPOINT \
  --zone=ZONE \
  --deployment-endpoint=ENDPOINT

    Substitua:

    • SERVER_ENDPOINT: o endereço do servidor a ser removido. Por exemplo, server-to-remove:15000.
    • ZONE: a zona que contém o servidor. Por exemplo, us-central1-a.
    • ENDPOINT: o endpoint da implantação principal. Por exemplo, my-spanner-deployment:15000.

  2. Aguarde a conclusão da realocação de dados. A realocação de partições leva tempo, dependendo do tamanho do armazenamento de dados hospedado no servidor. Monitore o status do servidor até que ele não seja mais listado na saída:

    spanner deployment servers list \
  --zone=ZONE \
  --deployment-endpoint=ENDPOINT

  3. Desligue o processo do servidor. Faça login na VM e interrompa o processo spanner.

    Para evitar corrupção de dados ou fazer com que servidores desconectados gravem atualizações conflitantes, não reinicie o processo spanner nessa VM usando o mesmo base_dir sem antes limpar as pastas de dados antigas.

Próximas etapas