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

Nota: Una instancia de prueba gratuita de Spanner admite funciones de la edición estándar y de la edición empresarial, como las funciones de distancia vectorial de KNN, la búsqueda en el texto completo y Spanner Graph. Para obtener más información, consulta la descripción general de las ediciones 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 la descripción general de las instancias de prueba gratuita de Spanner.

Comienza con una instancia de prueba gratuita

Una instancia de prueba gratuita de Spanner de 90 días está disponible para cualquier persona con una Cuenta de Google que 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.

Nota: Solo puedes crear una instancia de prueba gratuita por ciclo de vida del proyecto y un máximo de cinco instancias de prueba gratuita por cuenta de Facturación de Cloud.

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 console 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 hiciste.

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

   

4. Si la Facturación de Cloud ya está habilitada para tu proyecto, ve a 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 cobramos por tu instancia de Spanner, a menos que actualices tu cuenta de Facturación de Cloud a una cuenta pagada y actualices tu instancia de prueba gratuita de Spanner a una instancia pagada.

   a. Haz clic en Ir a facturación.

   

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

   

   Nota: Si eres un Google Cloud cliente nuevo, es posible que también cumplas con los requisitos para la Google Cloud prueba gratuita de 90 días por un valor de USD 300, que ofrece USD 300 en créditos gratuitos de Facturación de Cloud para pagar cualquier Google Cloud recurso. La instancia de prueba gratuita de Spanner se suma a los créditos de prueba gratuita de USD 300 que ofrece la Google Cloud prueba gratuita, y no necesitas usar ningún crédito gratuito de Facturación de Cloud para crear una instancia de prueba gratuita.

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

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

   Ir a Spanner

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

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

   Haz clic en Iniciar una prueba 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 para la instancia, como Trial instance.

2. El ID de instancia se propaga automáticamente según el nombre de la instancia, por ejemplo, como trial-instance. Cambia la dirección si es necesario.

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 donde se almacena y se replica tu instancia. Ten en cuenta que esta lista de configuraciones es mucho más pequeña que la lista disponible para las instancias pagadas. Para obtener una lista de las configuraciones regionales disponibles para las instancias de prueba gratuitas, consulta Configuraciones de instancias disponibles. Para obtener una lista completa de todas las configuraciones de instancias disponibles, consulta Configuraciones regionales, birregionales y multirregionales.

4. Haz clic en Crear instancia de prueba gratuita.

   Después de crear tu instancia de prueba gratuita, se te pedirá que continúes aprendiendo y explorando Spanner a través de un instructivo paso a paso que te enseñará a crear una base de datos con una aplicación de ejemplo. Para obtener más información, consulta Cómo comenzar a usar una aplicación de ejemplo.

Crea una instancia de prueba gratuita con la CLI de gcloud

Antes de comenzar

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. Install the Google Cloud CLI.

3. To initialize the gcloud CLI, run the following command:

   gcloud init

4. Create or select 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.

   • 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. Make sure that billing is enabled for your Google Cloud project.

6. If you're using a local shell, then create local authentication credentials for your user account:

   gcloud auth application-default login

   You don't need to do this if you're using Cloud Shell.

7. Install the Google Cloud CLI.

8. To initialize the gcloud CLI, run the following command:

   gcloud init

9. Create or select 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.

   • 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. Make sure that billing is enabled for your Google Cloud project.

11. If you're using a local shell, then create local authentication credentials for your user account:

    gcloud auth application-default login

    You don't need to do this if you're using Cloud Shell.

Crea una instancia de prueba gratuita

Para crear una instancia de prueba gratuita, usa el comando gcloud spanner instances create.

gcloud spanner instances create INSTANCE_ID \
   --instance-type=free-instance --config=INSTANCE_CONFIG \
   --description=INSTANCE_DESCRIPTION

Reemplaza lo siguiente:

• INSTANCE_ID: Un identificador permanente que es único dentro de tu proyecto de Google Cloud . No puedes cambiar el ID de la instancia más adelante.

• INSTANCE_CONFIG: Es un identificador permanente de la configuración de tu instancia, que define la ubicación geográfica de la instancia. Puedes crear una instancia de prueba gratuita en una de las siguientes configuraciones de instancias regionales:

  • América: regional-us-central1 (Iowa), regional-us-east1 (Carolina del Sur), regional-us-east4 (Virginia del Norte) y regional-us-east5 (Colombia)
  • Europa: regional-europe-west1 (Bélgica), regional-europe-west3 (Fráncfort)
  • Asia: regional-asia-northeast1 (Tokio), regional-asia-south2 (Delhi), regional-asia-southeast2 (Yakarta)

• INSTANCE_DESCRIPTION: Es el nombre que se mostrará para la instancia en la consola de Google Cloud. El nombre de la instancia debe ser único en tu proyecto deGoogle Cloud .

Por ejemplo, para crear una instancia de prueba gratuita llamada trial-instance con el nombre comercial Trial Instance con la configuración de instancia regional regional-us-east5, sigue estos pasos:

gcloud spanner instances create trial-instance --config=regional-us-east5 \
    --instance-type=free-instance --description="Trial Instance"

Nota: Usa el ID de la instancia, no el nombre comercial, cuando hagas referencia a una instancia en los comandos gcloud CLI.

Comienza con una aplicación de ejemplo

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

Puedes acceder a la aplicación de ejemplo con 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 la prueba gratuita.

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

4. En el panel Learn: Instructivo, haz clic en Create a sample Cloud SQL database o Create a sample PostgreSQL database, según el dialecto con el que quieras comenzar.

5. Después de completar el instructivo, regresa al panel Learn: Tutorial para seguir el segundo instructivo, Consulta una base de datos de muestra.

gcloud CLI

1. Completa los pasos que se describen 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 para 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 spanner samples run para descargar la aplicación de ejemplo y, luego, inicia el generador de cargas de trabajo y el servicio de gRPC de backend para la aplicación de ejemplo determinada:

   gcloud spanner samples run APPNAME --instance-id INSTANCE_ID
   

3. Para obtener más información y una lista de otros comandos disponibles para la aplicación de ejemplo, 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 la prueba gratuita.

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

   

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

5. Selecciona la opción de actualización. Puedes seleccionar una de las siguientes opciones:

   • Actualizar ahora
   • Actualizar automáticamente a la versión completa de la edición empresarial después de que finalice la prueba
   • Recordarme más tarde

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

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

Usa gcloud CLI

Para actualizar tu instancia de prueba gratuita a una instancia paga de la edición Enterprise con la misma configuración, ejecuta el siguiente comando gcloud spanner instances update:

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

Borra la instancia

Advertencia: Si borras una instancia, se quitará de forma permanente junto con todas sus bases de datos. Esta acción no se puede deshacer. Además, no puedes crear otra instancia de prueba gratuita después de borrar la primera. Puedes crear una instancia de prueba gratuita por ciclo de vida del proyecto.

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, usa el siguiente comando gcloud spanner instances delete:

gcloud spanner instances delete INSTANCE_ID

¿Qué sigue?

• Obtén más información sobre las instancias de prueba gratuita de Spanner.
• Obtén más información sobre las instancias y las bases de datos de Spanner.
• Para obtener detalles sobre los precios de Spanner después del período de prueba gratuita, consulta la página de precios.