Como gerenciar sessões com o Firestore

Este tutorial mostra como lidar com sessões no Cloud Run.

Muitos aplicativos precisam gerenciar sessões de autenticação e preferências do usuário. O framework Jetty vem com uma implementação baseada em memória para executar esta função. No entanto, essa implementação não é adequada para um aplicativo que pode ser veiculado de várias instâncias, porque a sessão gravada em uma instância pode ser diferente nas outras. Este tutorial mostra como lidar com sessões no Cloud Run.

Objetivos

• Gravar o aplicativo.
• Executar o aplicativo localmente.
• Implantar o aplicativo no Cloud Run.

Custos

Neste documento, você usará os seguintes componentes faturáveis do Google Cloud:

• Cloud Run
• Firestore

Para gerar uma estimativa de custo baseada na projeção de uso deste tutorial, use a calculadora de preços. Novos usuários do Google Cloud podem estar qualificados para uma avaliação gratuita.

Ao concluir as tarefas descritas neste documento, é possível evitar o faturamento contínuo excluindo os recursos criados. Saiba mais em Limpeza.

Antes de começar

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Firestore API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Firestore API.

   Enable the API

8. No Console do Google Cloud, abra o app no Cloud Shell.

   Acesse o Cloud Shell

   O Cloud Shell oferece acesso por linha de comando aos seus recursos de nuvem diretamente no navegador. Abra o Cloud Shell no navegador e clique em Continuar para fazer o download do código de amostra e carregá-lo no diretório de aplicativos.

9. No Cloud Shell, configure a CLI gcloud para usar seu novo projeto do Google Cloud:

   # Configure gcloud for your project
   gcloud config set project YOUR_PROJECT_ID
   

10. Atualize o Maven para usar o Java 11 por padrão:

    sudo update-alternatives --config java
    

    Quando solicitado, digite o número para selecionar Java 11. Anote o caminho listado para essa versão.
11. Exporte o caminho que você copiou na etapa anterior como uma variável de ambiente:

    export JAVA_HOME=java-11-path
    

O app da Web

Esse aplicativo exibe saudações em idiomas diferentes para cada usuário. Usuários recorrentes são sempre recebidos no mesmo idioma.

Para que o app possa armazenar as preferências de um usuário, você precisa de uma maneira de armazenar informações sobre o usuário atual em uma sessão. Este aplicativo de exemplo usa um WebFilter para recuperar e atualizar dados da sessão no Firestore.

session-handling/src/main/java/com/example/fluentd/util/FirestoreSessionFilter.java (em inglês)

Ver no GitHub

@Override
public void init(FilterConfig config) throws ServletException {
  // Initialize local copy of datastore session variables.
  firestore = FirestoreOptions.getDefaultInstance().getService();
  sessions = firestore.collection("sessions");

  try {
    // Delete all sessions unmodified for over two days.
    Calendar cal = Calendar.getInstance();
    cal.setTime(new Date());
    cal.add(Calendar.HOUR, -48);
    Date twoDaysAgo = Calendar.getInstance().getTime();
    QuerySnapshot sessionDocs =
        sessions.whereLessThan("lastModified", dtf.format(twoDaysAgo)).get().get();
    for (QueryDocumentSnapshot snapshot : sessionDocs.getDocuments()) {
      snapshot.getReference().delete();
    }
  } catch (InterruptedException | ExecutionException e) {
    throw new ServletException("Exception initializing FirestoreSessionFilter.", e);
  }
}

O diagrama a seguir ilustra como o Firestore lida com sessões para o aplicativo Cloud Run.

O HttpServletRequest usa um cookie para armazenar um ID exclusivo para a sessão local, que corresponde a um documento no Firestore com os detalhes da sessão.

Como excluir sessões

O Firestore não exclui sessões antigas ou expiradas. É possível excluir dados da sessão no Console do Google Cloud ou implementar uma estratégia de exclusão automática. Se você usar soluções de armazenamento para sessões como Memcache ou Redis, as sessões expiradas serão excluídas automaticamente.

Como executar no local

1. Inicie o servidor HTTP:

   mvn jetty:run
   

2. Veja seu app no navegador da Web:

   Cloud Shell

   Na barra de ferramentas do Cloud Shell, clique em Visualização da Web e selecione Visualizar na porta 8080.

   Máquina local

   No navegador, acesse http://localhost:8080

   Você verá uma das cinco saudações: "Hello World", "Hallo Welt", "Hola mundo", "Salut le Monde" ou "Ciao Mondo." O idioma será alterado se você abrir a página em um navegador diferente ou no modo de navegação anônima. Veja e edite os dados da sessão no Console do Google Cloud.

   

3. Para interromper o servidor HTTP, pressione Control+C na janela do terminal.

Como implantar e executar no Cloud Run

Você pode usar o Cloud Run para criar e implantar um aplicativo que seja executado de forma confiável sob carga pesada e com grandes quantidades de dados.

1. Na janela do seu terminal, crie e implante uma imagem do seu código no Google Container Registry (GCR) com o plug-in Maven do Jib.

   mvn clean package jib:build

2. Implante o app no Cloud Run:

      gcloud beta run deploy session-handling --image gcr.io/MY_PROJECT/session-handling 
   
            --platform managed --region us-central1 --memory 512M
      

   Substitua MY_PROJECT pelo ID do projeto Cloud que você criou. Visite o URL retornado por este comando para ver como os dados da sessão persistem entre o carregamento da página.

Como depurar o aplicativo

Se você não conseguir se conectar ao seu aplicativo Cloud Run, verifique o seguinte:

1. Verifique se os comandos de implantação gcloud foram concluídos com êxito e não geraram erros. Se houver erros (por exemplo, message=Build failed), corrija-os e tente implantar o aplicativo Cloud Run novamente.

2. No Console do Cloud, acesse a página Explorador de registros.

   Acessar a página Explorador de registros

   1. Na lista suspensa Recursos selecionados recentemente, clique em Aplicativo Cloud Run e, em seguida, clique em Todos os module_id. Você verá uma lista de solicitações de quando visitou seu aplicativo. Caso contrário, verifique se você selecionou Todos os module_id na lista suspensa. Se você vir mensagens de erro impressas no Console do Cloud, verifique se o código do aplicativo corresponde ao código na seção sobre como gravar o app da Web.

   2. Verifique se a API Firestore está ativada.

Limpar

Exclua o projeto

Cuidado: excluir um projeto tem os seguintes efeitos:

• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.

Se você planeja passar por várias arquiteturas, tutoriais ou guias de início rápido, a reutilização de projetos pode evitar que você exceda os limites da cota do projeto.

1. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

Excluir a instância do Cloud Run

Exclua o serviço do Cloud Run.

• No Console do Cloud, acesse a página Serviços do Cloud Run.

  Acessar a página "Serviços"

• Selecione o serviço que você quer excluir.
• Clique em Excluir para excluir o serviço.

A seguir

• Veja outros tutoriais do Cloud Functions.
• Teste o Cloud Run, que permite executar contêineres sem estado em um ambiente totalmente gerenciado ou em seu próprio cluster do Google Kubernetes Engine.