Las bases de datos en modo Datastore ahora se aprovisionan desvinculadas de App Engine de forma predeterminada.
Si tu base de datos está vinculada a App Engine, puedes desvincularla.
App Engine activa
Una aplicación de App Engine activa significa que existe una aplicación en el mismo proyecto y que esta aplicación no está inhabilitada. No requiere que la app tenga usos. La app y la base de datos vinculadas deben existir en la misma región.
Si inhabilitas la app de App Engine, también inhabilitas el acceso a la base de datos en modo Datastore vinculada a esa app.
Visualiza el estado de vinculación de App Engine
Puedes verificar el estado de desvinculación de App Engine con la API de REST:
curl --header "Authorization: Bearer $(gcloud auth print-access-token)" \
--header "Content-type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/(default)"
En la respuesta, observa el valor de appEngineIntegrationMode
. Si el valor es DISABLED
, tu base de datos no está vinculada a una aplicación de App Engine.
Desvincula tu base de datos de App Engine
Puedes desvincular tu base de datos en modo Datastore de la aplicación de App Engine para quitar el requisito activo de App Engine. Cuando desvinculas tu base de datos, puedes inhabilitar App Engine sin afectar el acceso a tu base de datos.La desvinculación es una operación permanente.
Si desvinculas la base de datos, no puedes usar la función Inhabilitar escrituras en la página Administrador de Datastore. Si las operaciones de escritura están inhabilitadas, la desvinculación de la base de datos habilitará las operaciones de escritura.
Antes de desvincular la base de datos de App Engine, asegúrate de habilitar la API de Firestore y actualizar los permisos de IAM.
Para desvincular tu base de datos, ve a la página Administrador de Datastore y haz clic en Desvincular base de datos de la app. La operación de desvinculación puede tardar hasta cinco minutos en aplicarse.
Ir al administrador de Datastore
Migra recursos de Terraform para App Engine
Si ya administraste bases de datos en modo Datastore a través del recurso google_app_engine_application
de Terraform, puedes usar el recurso google_firestore_database
de Terraform en su lugar.
Si deseas obtener instrucciones generales para administrar bases de datos en modo Datastore a través de Terraform, consulta Automatiza la creación de bases de datos.
Crea un recurso google_firestore_database.
En el archivo de configuración de Terraform, crea un recurso
google_firestore_database
nuevo:
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" }
Consulta Ubicaciones de Datastore para obtener una lista de las ubicaciones disponibles. Elige la ubicación correspondiente a la de tu base de datos existente.
Importa la base de datos existente en modo Datastore
Primero, asegúrate de que la API de Firestore esté habilitada.
Luego, importa la base de datos existente en modo Datastore a tu estado de Terraform:
terraform import google_firestore_database.database "(default)"
Luego, ejecute el siguiente comando:
terraform plan
Inspecciona el resultado para asegurarte de que la importación se haya completado correctamente. Si el resultado muestra algún campo que cambia, asegúrate de que estos cambios sean los previstos. Si el resultado incluye una línea similar a la siguiente:
google_firestore_database.database must be replaced
Luego, inspecciona tu archivo de configuración de Terraform para ver si hubo algún
error, en particular en los campos project, location o
name, y vuelve a ejecutar terraform plan
. Cualquier campo que requiera
que Terraform reemplace tu base de datos se marcará con
# forces replacement
en el resultado del plan.
Cuando estés conforme con el resultado del plan de Terraform, ejecuta lo siguiente:
terraform apply
Quita el recurso google_app_engine_application
Si tienes un recurso google_app_engine_application
existente en tu archivo de configuración de Terraform, quítalo de ese archivo ahora.
Luego, vuelve a ejecutar:
terraform plan
Deberías ver un resultado similar al siguiente:
Terraform will perform the following actions: # google_app_engine_application.app will be destroyed # (because google_app_engine_application.app is not in configuration)
Cuando estés satisfecho con el resultado del plan, ejecuta
terraform apply
Actualmente, Terraform no admite la eliminación de recursos de App Engine. Aunque Terraform mostrará que el recurso está destruido, en realidad no borrará la aplicación de App Engine. Sin embargo, Terraform ya no administrará la aplicación de App Engine.
Requisito de la API de Firestore
Antes, todas las bases de datos de Firestore en modo Datastore estaban vinculadas a una app de App Engine. Las bases de datos en modo Datastore ahora se aprovisionan desvinculadas de App Engine de forma predeterminada. Además, todas las bases de datos, tanto las existentes como las nuevas, ahora tienen los siguientes requisitos:
- Para administrar tu base de datos desde la consola de Google Cloud y la gcloud CLI, la API de Firestore debe estar habilitada en el proyecto. Esto es obligatorio para Firestore en modo nativo y Firestore en modo Datastore.
Cuando se ejecutan desde la consola de Google Cloud o gcloud CLI, las operaciones administrativas a continuación requerirán los siguientes permisos de IAM:
- Crear base de datos:
datastore.databases.create
- Ver metadatos de la base de datos:
datastore.databases.getMetadata
- Editar los metadatos de la base de datos:
datastore.databases.update
- Crear base de datos:
Si no habilitaste la API de Firestore, verás un error en las páginas de Datastore de la consola de Google Cloud que incluye el siguiente aviso:
La API de Firestore es necesaria para administrar tu base de datos.
Este error también incluye un botón para habilitar la API de Firestore. Haz clic en el botón para habilitar la API.
También debes verificar tus permisos de IAM para asegurarte de que tu acceso a la base de datos no se vea afectado.
Verifica que las cuentas que acceden a la base de datos a través de la consola de Google Cloud tengan los permisos necesarios que se mencionaron antes.
Las funciones predefinidas, como Usuario de Datastore y Visualizador de Datastore, incluyen los permisos necesarios. Si creaste funciones personalizadas de IAM, es posible que debas actualizarlas para que incluyan los permisos anteriores.
Si ya definiste una función personalizada para Datastore, es posible que no tenga el permiso datastore.databases.getMetadata
. Para garantizar el acceso continuo, actualiza tus funciones personalizadas con datastore.databases.getMetadata
o mediante una función predefinida.
Habilita la API mediante Terraform
Si lo deseas, también puedes habilitar la API de Firestore a través de Terraform:
resource "google_project_service" "firestore" { project = "project" service = "firestore.googleapis.com" }
Si tienes un recurso google_firestore_database
, puedes agregar una dependencia al recurso google_project_service
para asegurarte de que la API esté habilitada antes de que Terraform intente crear la base de datos:
resource "google_firestore_database" "database" { // ... depends_on = [google_project_service.firestore] }