Usar a ferramenta gcloud para testar aplicações e gerir índices

Pode usar a Google Cloud CLI para testar a sua aplicação localmente e para gerir índices para a sua instância de produção do Firestore no modo Datastore. Esta página descreve o fluxo de trabalho típico para estas atividades.

A CLI gcloud suporta o seguinte fluxo de trabalho:

  1. Crie suporte local para uma instância do Datastore, incluindo o diretório, os ficheiros necessários e o ID do projeto.
  2. Inicie o emulador do Datastore, que oferece uma emulação local do ambiente de produção do Datastore.
  3. Gere definições de índice a partir das consultas da sua aplicação para o emulador.
  4. Carregue definições de índice criadas ou geradas manualmente para a instância de base de dados de produção.
  5. Elimine os índices não usados da instância da base de dados de produção.

O fluxo de trabalho de desenvolvimento com a ferramenta de linha de comandos

Segue-se o fluxo de trabalho típico com a CLI gcloud:

  1. Inicie o emulador do Datastore.

  2. Defina variáveis de ambiente para que a sua aplicação saiba que está a usar o emulador.

  3. Inicie a aplicação e teste-a no emulador. Tem de executar as consultas que a sua aplicação usa no emulador para gerar índices para a instância da base de dados de produção.

  4. Carregue os índices gerados com o comando indexes create, transmitindo o caminho para o seu ficheiro index.yaml local, como no exemplo seguinte:

    gcloud datastore indexes create ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    O caminho de exemplo pressupõe que não definiu um diretório específico para a opção data-dir. Se tiver definido um diretório específico, modifique o caminho para usar o caminho para o seu ficheiro index.yaml.

  5. Remova as variáveis de ambiente para que a sua aplicação saiba que está a usar a instância da base de dados de produção.

  6. Execute a sua aplicação na instância de base de dados de produção.

  7. Ao longo do tempo, pode deixar de usar alguns dos índices. Pode eliminar índices não usados da instância da base de dados de produção removendo-os do ficheiro index.yaml local e, em seguida, invocando o comando indexes cleanup:

    gcloud datastore indexes cleanup ~/.config/gcloud/emulators/datastore/WEB-INF/index.yaml

    Se tiver definido um diretório específico para a opção data-dir, modifique o caminho no exemplo para usar o caminho para o seu ficheiro index.yaml.

O que se segue?