Crear una instancia de prueba gratuita y una aplicación de ejemplo de Spanner

En esta guía de inicio rápido, se muestra cómo usar una instancia de prueba gratuita de Spanner y una aplicación de ejemplo.

Para obtener más información, consulta Descripción general de las instancias de prueba gratuita de Spanner.

Comenzar con una instancia de prueba gratuita

Una instancia de Spanner mediante una prueba gratuita de 90 días está disponible para cualquier persona que tenga una Cuenta de Google y tenga habilitada la Facturación de Cloud en su proyecto. No se te cobrará a menos que elijas actualizar tu instancia de prueba gratuita a una instancia pagada.

Puedes crear una instancia de prueba gratuita con la consola de Google Cloud o Google Cloud CLI.

Crea una instancia de prueba gratuita con la consola de Google Cloud

En los siguientes pasos, se explica cómo crear una instancia de prueba gratuita con la consola de Google Cloud.

Antes de comenzar

  1. En la consola de Google Cloud, ve a la página Spanner.

    Ir a Spanner

  2. Selecciona o crea un proyecto de Google Cloud si aún no lo has hecho.

  3. En la página de Spanner, haz clic en Iniciar una prueba gratuita.

    Captura de pantalla de la página de destino de Spanner en la consola de Google Cloud, en la que se destaca el botón Iniciar una prueba gratuita.

  4. Si la Facturación de Cloud ya está habilitada para tu proyecto, continúa con Crea una instancia de prueba gratuita en la siguiente sección.

    Si la Facturación de Cloud no está habilitada para tu proyecto, vincula una cuenta de Facturación de Cloud existente o crea una nueva. Google usa esta información de pago para verificar tu identidad. No se te cobrará la instancia de Spanner, a menos que actualices la cuenta de Facturación de Cloud a una cuenta pagada de forma explícita y actualices la instancia de prueba gratuita de Spanner a una instancia pagada.

    a. Haz clic en Ir a facturación.

    Captura de pantalla del diálogo Habilitar la facturación para seguir usando Spanner, en la que se destaca el botón Ir a la facturación.

    b. Luego, haz clic en Vincular una cuenta de facturación.

    Captura de pantalla de una página en la que se muestra que este proyecto no tiene una cuenta de facturación. Se destaca el botón Vincular una cuenta de facturación.

    c. Sigue los pasos para crear una cuenta de facturación y, luego, vincúlala al proyecto.

    d. Después de habilitar la Facturación de Cloud para el proyecto, ve a la página Spanner.

    Ir a Spanner

    e. Haz clic en Iniciar una prueba gratuita y continúa con Crear instancia de prueba gratuita en la siguiente sección.

  5. Opcional: Si creaste una instancia de Spanner en el proyecto antes, verás la siguiente página Instancias de Spanner.

    Haz clic en Iniciar una prueba gratuita.

    Captura de pantalla de la página Instancias de Spanner, en la que se destaca Crear instancia gratuita.

Crea una instancia de prueba gratuita

En la página Crea tu instancia de prueba gratuita, sigue estos pasos:

  1. En el campo Asigna un nombre a tu instancia, ingresa un nombre de instancia, como Trial instance.

  2. El ID de la instancia se propaga de forma automática según el nombre de la instancia, por ejemplo, como trial-instance. Si es necesario, cámbialo.

  3. En la sección Elige una configuración, selecciona una configuración del menú desplegable.

    La configuración de tu instancia determina la ubicación geográfica en la que se almacena y replica. Ten en cuenta que esta lista de configuraciones es mucho más pequeña que la lista disponible para las instancias pagadas. Si deseas obtener una lista de las configuraciones regionales disponibles para las instancias de prueba gratuita, consulta Opciones de configuración de instancias disponibles. Para obtener una lista completa de todas las opciones de configuración de instancias disponibles, consulta Configuración regional, birregional y multirregional.

  4. Haz clic en Crear instancia de prueba gratuita.

    Captura de pantalla de la página Crear una instancia de prueba gratuita, en la que se destaca Crear instancia de prueba gratuita.

    Después de crear la instancia de prueba gratuita, se te solicitará que sigas aprendiendo y explorando Spanner mediante el inicio de un instructivo paso a paso que te enseña a crear una base de datos mediante una aplicación de muestra. Para obtener más información, consulta Comienza a usar una aplicación de muestra.

Crea una instancia de prueba gratuita con gcloud CLI

Antes de comenzar

  1. Accede a tu cuenta de Google Cloud. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.
  2. Instala Google Cloud CLI.
  3. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init
  4. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  6. Crea credenciales de autenticación locales para tu Cuenta de Google:

    gcloud auth application-default login
  7. Instala Google Cloud CLI.
  8. Para inicializar la CLI de gcloud, ejecuta el siguiente comando:

    gcloud init
  9. Create or select a Google Cloud project.

    • Create a Google Cloud project:

      gcloud projects create PROJECT_ID

      Replace PROJECT_ID with a name for the Google Cloud project you are creating.

    • Select the Google Cloud project that you created:

      gcloud config set project PROJECT_ID

      Replace PROJECT_ID with your Google Cloud project name.

  10. Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.

  11. Crea credenciales de autenticación locales para tu Cuenta de Google:

    gcloud auth application-default login

Crea una instancia de prueba gratuita

  1. Crea una instancia llamada trial-instance con el nombre visible Trial Instance mediante la configuración de instancia regional regional-us-east5:
gcloud spanner instances create trial-instance --config=regional-us-east5 \
    --instance-type=free-instance --description="Trial Instance"

Comienza a usar una aplicación de ejemplo

Spanner ofrece una aplicación de muestra de código abierto para ayudarte a comenzar a usar la instancia de prueba gratuita de Spanner. Una aplicación de muestra consta de un servicio gRPC de backend respaldado por una base de datos de Spanner y un generador de carga de trabajo que dirige el tráfico al servicio.

Puedes acceder a la aplicación de ejemplo mediante la consola de Google Cloud o Google Cloud CLI.

Console

  1. Ve a la página Instancias de Spanner en la consola de Google Cloud.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia de prueba gratuita.

  3. En la página Descripción general de la instancia, haz clic en Aprender.

  4. En el panel Aprender: Instructivo, haz clic en Crear una base de datos de Cloud SQL de muestra o Crear una base de datos de PostgreSQL de muestra, según el dialecto con el que desees comenzar.

  5. Después de completar el instructivo, regresa al panel Aprender: Instructivo para seguir el segundo instructivo, Consultar una base de datos de muestra.

gcloud CLI

  1. Completa los pasos descritos en la configuración de la CLI de gcloud, que incluye cómo crear y configurar un proyecto predeterminado de Google Cloud, habilitar la API de Cloud Spanner y configurar OAuth 2.0 para obtener credenciales de autenticación y usar la API de Cloud Spanner.

    Asegúrate de ejecutar gcloud auth application-default login para configurar tu entorno de desarrollo local con credenciales de autenticación.

  2. Ejecuta el comando gcloud alpha spanner samples run para descargar la aplicación de ejemplo y, luego, iniciar el servicio de gRPC de backend y el generador de carga de trabajo para la aplicación de ejemplo determinada:

    gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
    
  3. Si deseas obtener más información y una lista de otros comandos disponibles para la aplicación de muestra, consulta la documentación de la CLI de gcloud.

Actualiza una instancia de prueba gratuita

En los siguientes pasos, se explica cómo actualizar tu instancia de prueba gratuita.

Usa la consola de Google Cloud

  1. En la consola de Google Cloud, ve a la página Instancias de Spanner.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia de prueba gratuita.

  3. En la página Descripción general de la instancia, haz clic en Editar instancia o Editar para actualizar.

    Captura de pantalla de la página Resumen de la instancia y el botón Editar para actualizar

  4. En el campo Actualizar nombre, ingresa un nombre más aplicable para tu instancia pagada, si corresponde.

  5. Selecciona una opción de actualización.

    En la sección Resumen, se proporciona una descripción de los costos de procesamiento y almacenamiento para la instancia pagada actualizada que seleccionaste.

    Captura de pantalla de la página Editar instancia, en la que se destaca el botón Guardar.

  6. Haz clic en Guardar para actualizar tu instancia de prueba gratuita.

Usa gcloud CLI

Para actualizar tu instancia de prueba gratuita trial-instance a una instancia pagada con la misma configuración de instancias, ejecuta el siguiente comando:

gcloud spanner instances update trial-instance --instance-type=provisioned

Borra la instancia

Console

  1. Ve a la página Instancias de Spanner en la consola de Google Cloud.

    Ir a la página Instancias

  2. Haz clic en el nombre de la instancia que deseas borrar.

  3. En la página Descripción general de la instancia, haz clic en Borrar instancia.

  4. Sigue las instrucciones para confirmar que deseas borrar la instancia.

  5. Haz clic en Borrar.

gcloud CLI

Para borrar la instancia de prueba gratuita trial-instance, usa el siguiente comando:

gcloud spanner instances delete trial-instance

¿Qué sigue?