Sitzungen mit Cloud Firestore verarbeiten

In dieser Anleitung wird gezeigt, wie Sitzungen in Cloud Run verarbeitet werden.

Viele Anwendungen benötigen eine Sitzungsverarbeitung zur Authentifizierung und für Nutzereinstellungen. Das Jetty-Framework enthält eine speicherbasierte Implementierung, um diese Funktion auszuführen. Diese Implementierung eignet sich jedoch nicht für eine Anwendung, die über mehrere Instanzen bereitgestellt werden kann, da sich die Sitzung, die in einer bestimmten Instanz aufgezeichnet wird, von Sitzungen in anderen Instanzen unterscheiden kann. In dieser Anleitung wird gezeigt, wie Sitzungen in Cloud Run verarbeitet werden.

Lernziele

• Anwendung schreiben
• Anwendung lokal ausführen
• Stellen Sie die Anwendung in Cloud Run bereit.

Kosten

In diesem Dokument verwenden Sie die folgenden kostenpflichtigen Komponenten von Google Cloud:

• Cloud Run
• Firestore

Mit dem Preisrechner können Sie eine Kostenschätzung für Ihre voraussichtliche Nutzung vornehmen. Neuen Google Cloud-Nutzern steht möglicherweise eine kostenlose Testversion zur Verfügung.

Nach Abschluss der in diesem Dokument beschriebenen Aufgaben können Sie weitere Kosten vermeiden, indem Sie die erstellten Ressourcen löschen. Weitere Informationen finden Sie unter Bereinigen.

Hinweis

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. Öffnen Sie die Anwendung in der Google Cloud Console in Cloud Shell.

   Zu Cloud Shell

   Cloud Shell bietet Ihnen direkt über den Browser Befehlszeilenzugriff auf Ihre Cloud-Ressourcen. Öffnen Sie Cloud Shell im Browser und klicken Sie auf Fortfahren, um den Beispielcode herunterzuladen und ins Anwendungsverzeichnis zu wechseln.

9. Konfigurieren Sie die gcloud-Befehlszeile in Cloud Shell so, dass Ihr neues Google Cloud-Projekt verwendet wird:

   # Configure gcloud for your project
   gcloud config set project YOUR_PROJECT_ID
   

10. Aktualisieren Sie Maven so, dass standardmäßig Java 11 verwendet wird:

    sudo update-alternatives --config java
    

    Geben Sie bei Aufforderung die Nummer ein, um Java 11 auszuwählen. Notieren Sie sich den für diese Version aufgeführten Pfad.
11. Exportieren Sie den Pfad, den Sie im vorherigen Schritt kopiert haben:

    export JAVA_HOME=java-11-path
    

Die Webanwendung

In dieser Anwendung werden Begrüßungen in verschiedenen Sprachen für jeden Nutzer angezeigt. Wiederkehrende Nutzer werden immer in derselben Sprache begrüßt.

Bevor sich in der Anwendung die Einstellungen für einen Nutzer speichern lassen, benötigen Sie eine Möglichkeit zum Speichern der Informationen über den aktuellen Nutzer in einer Sitzung. Diese Beispielanwendung verwendet eine WebFilter, um Sitzungsdaten in Firestore abzurufen und zu aktualisieren.

session-handling/src/main/java/com/example/Gettingstarted/util/FirestoreSessionFilter.java

Auf GitHub ansehen

@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);
  }
}

Das folgende Diagramm zeigt, wie Firestore Sitzungen für die Cloud Run-Anwendung verarbeitet.

HttpServletRequest verwendet ein Cookie, um eine eindeutige ID für die lokale Sitzung zu speichern, die einem Dokument in Firestore mit den Sitzungsdetails entspricht.

Sitzungen löschen

Firestore löscht keine alten oder abgelaufenen Sitzungen. Du kannst in der Google Cloud Console Sitzungsdaten löschen oder eine Strategie zum automatischen Löschen implementieren. Wenn Sie zum Speichern von Sitzungen Lösungen wie Memcache oder Redis verwenden, werden abgelaufene Sitzungen automatisch gelöscht.

Lokal ausführen

1. Starten Sie den HTTP-Server:

   mvn jetty:run
   

2. Sehen Sie sich die App in Ihrem Webbrowser an:

   Cloud Shell

   Klicken Sie in der Symbolleiste von Cloud Shell auf Webvorschau und wählen Sie Vorschau auf Port 8080 aus.

   Lokaler Computer

   Rufen Sie in Ihrem Browser http://localhost:8080 auf.

   Sie sehen eine von fünf Begrüßungen: "Hallo Welt", "Hallo Welt", "Hola mundo", "Salut le Monde" oder "Ciao Mondo". Die Sprache ändert sich, wenn Sie die Seite in einem anderen Browser oder im Inkognitomodus öffnen. Sie können die Sitzungsdaten in der Google Cloud Console aufrufen und bearbeiten.

   

3. Drücken Sie im Terminalfenster Control+C, um den HTTP-Server zu beenden.

In Cloud Run bereitstellen und ausführen

Mit Cloud Run können Sie eine Anwendung erstellen und bereitstellen, die unter hoher Last und mit großen Datenmengen zuverlässig ausgeführt wird.

1. Erstellen Sie im Terminalfenster ein Image Ihres Codes und stellen Sie es in Google Container Registry (GCR) mit dem Maven-Plug-in Jib bereit.

   mvn clean package jib:build

2. Stellen Sie die Anwendung für Cloud Run bereit:

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

   Ersetzen Sie MY_PROJECT durch die ID des von Ihnen erstellten Cloudprojekts. Rufen Sie die von diesem Befehl zurückgegebene URL auf, um zu sehen, wie Sitzungsdaten zwischen dem Laden der Seite beibehalten werden.

Fehler in der Anwendung beheben

Wenn Sie keine Verbindung zu Ihrer Cloud Run-Anwendung herstellen können, prüfen Sie Folgendes:

1. Überprüfen Sie, ob die gcloud-Bereitstellungsbefehle erfolgreich ausgeführt wurden und keine Fehler ausgegeben haben. Wenn Fehler aufgetreten sind (z.–B. message=Build failed), beheben Sie diese und versuchen Sie noch einmal, die Cloud Run-Anwendung bereitzustellen.

2. Rufen Sie in der Cloud Console die Seite Log-Explorer auf.

   Zur Seite „Log-Explorer“

   1. Klicken Sie in der Drop-down-Liste Zuletzt ausgewählte Ressourcen auf Cloud Run-Anwendung und dann auf Alle Werte für module_id. Es wird eine Liste der Anfragen abgerufen, die Sie beim Besuch Ihrer Anwendung gestellt haben. Wenn keine Anfragenliste angezeigt wird, bestätigen Sie, dass Sie Alle Werte für module_id aus der Drop-down-Liste ausgewählt haben. Wenn Fehlermeldungen in der Cloud Console angezeigt werden, prüfen Sie, ob der Code Ihrer App dem Code im Abschnitt zum Erstellen einer Webanwendung entspricht.

   2. Prüfen Sie, ob die Firestore API aktiviert ist.

Bereinigen

Projekt löschen

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

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.

Cloud Run-Instanz löschen

Löschen Sie den Dienst aus Cloud Run.

• Rufen Sie in der Cloud Console die Seite Dienste für Cloud Run auf.

  Weiter zur Seite "Dienste"

• Wählen Sie den Dienst aus, den Sie löschen möchten.
• Klicken Sie auf Löschen, um den Dienst zu löschen.

Weitere Informationen

• Weitere Cloud Functions-Anleitungen testen
• Cloud Run testen, um zustandslose Container in einer vollständig verwalteten Umgebung oder im eigenen Google Kubernetes Engine-Cluster auszuführen