Como usar a ferramenta gcloud para testar aplicativos e gerenciar índices

É possível usar a ferramenta de linha de comando gcloud para testar o aplicativo localmente e gerenciar índices da instância de produção do Cloud Firestore no modo Datastore. Nesta página, descrevemos o fluxo de trabalho típico dessas atividades.

A ferramenta gcloud é compatível com o seguinte fluxo de trabalho:

  1. Crie suporte local para uma instância do Cloud Datastore, incluindo diretório, arquivos obrigatórios e código do projeto.
  2. Inicie o emulador de Cloud Datastore, que oferece emulação local do ambiente do Cloud Datastore de produção.
  3. Gere definições de índice a partir das consultas do aplicativo ao emulador.
  4. Faça upload manual de definições de índice criadas ou geradas na instância do banco de dados da produção.
  5. Exclua índices não utilizados da instância do banco de dados de produção.

Fluxo de trabalho de desenvolvimento com a ferramenta de linha de comando

Este é o fluxo de trabalho típico da ferramenta gcloud:

  1. Inicie o emulador do Datastore.

  2. Defina variáveis de ambiente para que o aplicativo saiba que está usando o emulador.

  3. Inicie o aplicativo e teste-o no emulador. Execute as consultas que o aplicativo usa no emulador para gerar índices para a instância do banco de dados de produção.

  4. Faça upload dos índices gerados com o comando indexes create, passando o caminho para o arquivo index.yaml local, como no exemplo a seguir:

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

    Para o caminho do exemplo, pressupomos que você não tenha definido um diretório específico para a opção data-dir. Caso tenha definido um diretório específico, modifique o caminho para usar o caminho do arquivo index.yaml.

  5. Remova as variáveis de ambiente para que o aplicativo saiba que está usando a instância do banco de dados de produção.

  6. Execute o aplicativo na instância do banco de dados de produção.

  7. Com o tempo, convém não usar mais alguns dos índices. É possível excluí-los da instância do banco de dados de produção. Basta removê-los do arquivo index.yaml local e executar o comando indexes cleanup:

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

    Se você tiver definido um diretório específico para a opção data-dir, modifique o caminho do exemplo para direcionar ao seu arquivo index.yaml.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Documentação do Cloud Datastore