App Engine-Anforderung

Bisher waren alle Firestore-Datenbanken im Datastore-Modus mit einer App Engine-Anwendung verknüpft. Wenn Ihre Datenbank verknüpft ist, ist eine aktive App Engine-Anwendung im selben Projekt erforderlich. Ohne die aktive App Engine-Anwendung ist der Lese- und Schreibzugriff auf die Datenbank deaktiviert.

Datenbanken im Datastore-Modus werden jetzt standardmäßig ohne Verknüpfung mit App Engine bereitgestellt.

Wenn Ihre Datenbank mit einer App Engine-Anwendung verknüpft ist, können Sie die Verknüpfung aufheben.

Aktive App Engine-Instanz

Eine aktive App Engine-App bedeutet, dass im selben Projekt eine App vorhanden ist und diese App nicht deaktiviert ist. Die App muss nicht verwendet werden. Die verknüpfte App und Datenbank müssen sich in derselben Region befinden.

Wenn Sie Ihre App Engine-Anwendung deaktivieren, wird auch der Zugriff auf die mit dieser Anwendung verknüpfte Datenbank im Datastore-Modus deaktiviert.

Sie können den Status der Verknüpfungsaufhebung von App Engine mit der REST API prüfen:

curl  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
--header "Content-type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/(default)"

Sehen Sie sich in der Antwort den Wert von appEngineIntegrationMode an. Wenn der Wert DISABLED ist, ist Ihre Datenbank nicht mit einer App Engine-Anwendung verknüpft.

Sie können die Verknüpfung Ihrer Datenbank im Datastore-Modus mit der App Engine-Anwendung aufheben, um die Anforderung einer aktiven App Engine-Anwendung zu entfernen. Wenn Sie die Verknüpfung Ihrer Datenbank aufheben, können Sie App Engine deaktivieren, ohne den Zugriff auf Ihre Datenbank zu beeinträchtigen.

Das Aufheben der Verknüpfung ist ein dauerhafter Vorgang.

Wenn Sie die Verknüpfung Ihrer Datenbank aufheben, können Sie das Feature Schreibvorgänge deaktivieren auf der Seite Datastore Admin nicht mehr verwenden. Wenn Schreibvorgänge derzeit deaktiviert sind, werden sie durch das Aufheben der Verknüpfung aktiviert.

Bevor Sie die Verknüpfung Ihrer Datenbank mit App Engine aufheben, müssen Sie die Firestore API aktivieren und Ihre IAM-Berechtigungen aktualisieren.

Wenn Sie die Verknüpfung Ihrer Datenbank aufheben möchten, rufen Sie die Seite Datastore Admin auf und klicken Sie auf Verknüpfung der Datenbank mit der App aufheben. Es kann bis zu fünf Minuten dauern, bis die Aufhebung der Verknüpfung wirksam wird.

Datastore Admin aufrufen

Terraform-App Engine-Ressourcen migrieren

Wenn Sie Datastore-Modus-Datenbanken zuvor über die Terraform-Ressource google_app_engine_application verwaltet haben, können Sie stattdessen die Terraform-Ressource google_firestore_database verwenden.

Eine allgemeine Anleitung zum Verwalten von Datenbanken im Datastore-Modus über Terraform finden Sie unter Datenbankerstellung automatisieren.

google_firestore_database-Ressource erstellen

Erstellen Sie in Ihrer Terraform-Konfigurationsdatei eine neue google_firestore_database-Ressource:

datastore.tf

resource "google_firestore_database" "database" {
  project     = "project"
  name        = "(default)"
  location_id = "location"
  
  type = "DATASTORE_MODE"
  
  app_engine_integration_mode = "DISABLED"

  // Optional, but recommended for safety
  delete_protection_state = "DELETE_PROTECTION_ENABLED"
}

Eine Liste der verfügbaren Standorte finden Sie unter Datastore-Standorte. Wählen Sie den Speicherort aus, der dem Ihrer vorhandenen Datenbank entspricht.

Vorhandene Datenbank im Datastore-Modus importieren

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

Als Nächstes importieren Sie die vorhandene Datenbank im Datastore-Modus in Ihren Terraform-Zustand:

terraform import google_firestore_database.database "(default)"

Führen Sie als Nächstes diesen Befehl aus:

terraform plan

Prüfen Sie die Ausgabe, um sicherzustellen, dass der Import erfolgreich abgeschlossen wurde. Wenn in der Ausgabe Änderungen an Feldern angezeigt werden, prüfen Sie, ob diese Änderungen beabsichtigt sind. Wenn die Ausgabe eine Zeile wie die folgende enthält:

google_firestore_database.database must be replaced

Prüfen Sie dann Ihre Terraform-Konfigurationsdatei auf Fehler, insbesondere in den Feldern project, location oder name, und führen Sie terraform plan noch einmal aus. Alle Felder, für die Terraform Ihre Datenbank ersetzen muss, sind in der Planausgabe mit # forces replacement gekennzeichnet.

Wenn Sie mit der Ausgabe des Terraform-Plans zufrieden sind, führen Sie Folgendes aus:

terraform apply

Ressource „google_app_engine_application“ entfernen

Wenn Sie eine vorhandene google_app_engine_application-Ressource in Ihrer Terraform-Konfigurationsdatei haben, entfernen Sie sie jetzt aus dieser Datei.

Führen Sie anschließend noch einmal Folgendes aus:

terraform plan

Die Ausgabe sollte in etwa so aussehen:

Terraform will perform the following actions:

  # google_app_engine_application.app will be destroyed
  # (because google_app_engine_application.app is not in configuration)

Wenn Sie mit der Ausgabe des Plans zufrieden sind, führen Sie

terraform apply

Das Löschen von App Engine-Ressourcen wird von Terraform derzeit nicht unterstützt. Obwohl die Ressource in Terraform als gelöscht angezeigt wird, wird die App Engine-Anwendung nicht tatsächlich gelöscht. Die App Engine-Anwendung wird jedoch nicht mehr von Terraform verwaltet.

Firestore API-Anforderung

Bisher waren alle Firestore-Datenbanken im Datastore-Modus mit einer App Engine-Anwendung verknüpft. Datenbanken im Datastore-Modus werden jetzt standardmäßig ohne Verknüpfung mit App Engine bereitgestellt. Außerdem gelten für alle Datenbanken, sowohl für bestehende als auch für neu erstellte, die folgenden Anforderungen:

  • Wenn Sie Ihre Datenbank über die Google Cloud Console und die gcloud CLI verwalten möchten, muss die Firestore API im Projekt aktiviert sein. Dies ist sowohl für Firestore-Datenbanken im nativen Modus als auch für Firestore-Datenbanken im Datastore-Modus erforderlich.

  • Wenn die folgenden administrativen Vorgänge über die Google Cloud -Konsole oder die gcloud CLI ausgeführt werden, sind die folgenden IAM-Berechtigungen erforderlich:

    • Datenbank erstellen: datastore.databases.create
    • Datenbankmetadaten ansehen: datastore.databases.getMetadata
    • Datenbankmetadaten bearbeiten: datastore.databases.update

Wenn Sie die Firestore API nicht aktiviert haben, wird auf den Datastore-Seiten der Google Cloud Console eine Fehlermeldung mit dem folgenden Hinweis angezeigt:

Die Firestore API ist zum Verwalten der Datenbank erforderlich.

Dieser Fehler enthält auch eine Schaltfläche zum Aktivieren der Firestore API. Klicken Sie auf die Schaltfläche, um die API zu aktivieren.

Sie sollten auch Ihre IAM-Berechtigungen überprüfen, um sicherzustellen, dass Ihr Zugriff auf die Datenbank nicht beeinträchtigt wird.

Prüfen Sie, ob die Konten, die über die Google Cloud Konsole auf die Datenbank zugreifen, die oben aufgeführten erforderlichen Berechtigungen haben.

Vordefinierte Rollen wie Datastore-Nutzer und Datastore-Betrachter enthalten die erforderlichen Berechtigungen. Wenn Sie benutzerdefinierte IAM-Rollen erstellt haben, müssen Sie sie möglicherweise aktualisieren, um die oben genannten Berechtigungen einzuschließen.

Wenn Sie zuvor eine benutzerdefinierte Rolle für Datastore definiert haben, fehlt ihr möglicherweise die Berechtigung datastore.databases.getMetadata. Aktualisieren Sie Ihre benutzerdefinierten Rollen mit datastore.databases.getMetadata oder verwenden Sie eine vordefinierte Rolle, um den Zugriff aufrechtzuerhalten.

API über Terraform aktivieren

Sie können die Firestore API auch über Terraform aktivieren:

resource "google_project_service" "firestore" {
  project = "project"
  service = "firestore.googleapis.com"
}

Wenn Sie eine google_firestore_database-Ressource haben, können Sie eine Abhängigkeit von der google_project_service-Ressource hinzufügen, um sicherzustellen, dass die API aktiviert ist, bevor Terraform versucht, die Datenbank zu erstellen:

resource "google_firestore_database" "database" {
  // ...
  depends_on = [google_project_service.firestore]
}