Escalonar uma implantação de VM

Para lidar com o tráfego de banco de dados em constante 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 da VM, siga estas etapas:

Como prática recomendada, recomendamos o escalonamento vertical 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 resolvível da nova VM. 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 sua 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 ao deployment. 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 passou 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 e participar da 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 servidor 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 no total da 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 sua 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 repositório de dados hospedado no servidor. Monitore o status do servidor até que ele não apareça mais na saída:

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

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

    Para evitar corrupção de dados ou que servidores desconectados registrem atualizações conflitantes, não reinicie o processo spanner nessa VM usando o mesmo base_dir sem primeiro limpar as pastas de dados antigos.

Próximas etapas