Conectarse desde Cloud Run
En esta página, se explica el proceso para implementar una aplicación de ejemplo en un servicio de Cloud Run con la consola de Google Cloud y una aplicación cliente. Esta aplicación de ejemplo conecta Cloud Run a AlloyDB para PostgreSQL.
Antes de comenzar
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Verify that billing is enabled for your Google Cloud project.
-
Habilita las API de Cloud necesarias para ejecutar una aplicación de ejemplo de AlloyDB para PostgreSQL en Cloud Run.
En el paso Confirmar proyecto, haz clic en Siguiente para confirmar el nombre del proyecto en el que realizarás cambios.
En el paso Habilitar APIs, haz clic en Habilitar para habilitar lo siguiente:
- API de AlloyDB
- API de Cloud Run Admin
- API de Compute Engine
- API de Cloud Build
- API de Container Registry
- API de Service Networking
- API de Cloud Resource Manager
En la consola de Google Cloud , ve a la página Clústeres.
Haga clic en Crear clúster.
La consola de Google Cloud te presenta una variedad de tipos de clústeres. Selecciona Alta disponibilidad.
Haz clic en Continuar.
Se expande la sección Configura tu clúster.
En Información básica, en el campo ID del clúster, ingresa
my-cluster
.En el campo Contraseña, ingresa la contraseña que desees. Toma nota de esta contraseña. La volverás a usar más adelante en esta guía de inicio rápido.
En el campo Región, selecciona
us-central1 (Iowa)
.En Conectividad, en el menú desplegable Red, selecciona
default
.Si aún no configuraste el acceso privado a los servicios, aparecerá un diálogo etiquetado como Se requiere una conexión de acceso a servicios privados.
En el diálogo Se requiere una conexión de acceso a servicios privados, para crear una conexión de acceso a servicios privados, completa los siguientes pasos:
Haz clic en Configurar conexión.
Aparecerá un panel nuevo etiquetado como Habilita la API de Service Networking.
En el panel, selecciona Usar un rango de IP asignado automáticamente.
Haz clic en Continuar.
Haz clic en Crear conexión y espera a que finalice la configuración de la conexión.
Se quitará el panel.
Haz clic en Continuar.
Se expandirá la sección Configura tu instancia principal.
En Información básica, en el campo ID de instancia, ingresa
my-primary
.Para un valor de Máquina, selecciona
2 vCPU, 16 GB
.Haga clic en Crear clúster.
Espera a que se cree el clúster.
Si no estás en la página Descripción general del clúster que acabas de crear, ve a la página Clústeres en la consola de Google Cloud .
Para mostrar la página Descripción general del clúster, haz clic en el nombre del clúster
my-cluster
.En el menú de navegación, haz clic en AlloyDB Studio.
En la lista Base de datos de la página Accede a AlloyDB Studio, selecciona
postgres
.En la lista desplegable Usuario, selecciona
postgres
.En el campo Contraseña, ingresa la contraseña que creaste en Crea un clúster y su instancia principal.
Haz clic en Autenticar. En el panel Explorador, se muestra una lista de los objetos de tu base de datos.
En la pestaña Editor 1, crea una base de datos:
CREATE DATABASE quickstart_db;
Haz clic en Ejecutar. Espera a que aparezca el mensaje
Statement executed successfully
en el panel Resultados.Ve a la página Panel en la consola de Google Cloud .
Busca el ID del proyecto en la tarjeta Project info.
Toma nota del ID de tu proyecto. La necesitarás para el siguiente paso de esta guía de inicio rápido.
En la consola de Google Cloud , abre Cloud Shell.
En el editor de Cloud Shell, usa el siguiente comando para clonar el repositorio con el código de la aplicación de ejemplo de GitHub:
cloudshell_open --repo_url \ "https://github.com/GoogleCloudPlatform/alloydb-auth-proxy" \ --dir \ "examples/go" \ --force_new_clone
Crea un repositorio en Artifact Registry para las imágenes de Docker:
gcloud artifacts repositories create cloud-run-source-deploy --location us-central1 --repository-format=docker --project PROJECT_ID
Reemplaza
PROJECT_ID
por el ID de tu proyecto.En el diálogo Autorizar Cloud Shell, haz clic en Autorizar. Este mensaje no aparece si ya realizaste este paso.
Para compilar un contenedor de Docker y publicarlo en Artifact Registry, usa el siguiente comando:
gcloud builds submit --tag us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy/run-sql --project PROJECT_ID
Reemplaza
PROJECT_ID
por el ID de tu proyecto.En la consola de Google Cloud , ve a la página Clústeres.
Busca en la tabla la fila cuyo Nombre del recurso sea
my-primary
.Anota la dirección IP privada de esa fila. La necesitarás para el siguiente paso de esta guía de inicio rápido.
El formato de ejemplo de la dirección IP es
172.19.209.2:5432
.En la consola de Google Cloud , ve a la página Cloud Run.
En la pestaña Servicios, haz clic en Implementar contenedor.
En la página Crear servicio, selecciona la opción Implementar una revisión desde una imagen de contenedor existente.
En el campo URL de la imagen del contenedor, haz clic en Seleccionar.
En el panel Selecciona una imagen de contenedor, completa los siguientes pasos:
- Selecciona la pestaña Artifact Registry.
- Expande
us-central1-docker.pkg.dev/PROJECT_ID/cloud-run-source-deploy
. - Expande
run-sql
. - Selecciona la imagen más reciente.
- Haz clic en Seleccionar.
En el campo Nombre del servicio, ingresa
quickstart-service
.Asegúrate de que
us-central1 (Iowa)
esté seleccionado de forma predeterminada en la lista Región.En la sección Autenticación, selecciona Permitir invocaciones no autenticadas.
Asegúrate de que la opción La CPU solo se asigna durante el procesamiento de solicitudes esté seleccionada en la sección Asignación de CPU y precios.
Expande la sección Contenedores, volúmenes, Herramientas de redes y seguridad.
En la pestaña Contenedores, selecciona la pestaña Variables y secretos y completa los siguientes pasos:
En la sección Variables de entorno, haz clic en Agregar variable.
Ingresa lo siguiente en los campos
Name
yValue
:DB_NAME
:quickstart_db
DB_USER
:postgres
DB_PASS
: Es la contraseña que ingresaste cuando creaste el clúster en Crea un clúster y su instancia principal.DB_PORT
:5432
INSTANCE_HOST
: La dirección IP de la instancia principal de tu clúster, que encontraste en Cómo encontrar la dirección IP de tu instancia nueva. No incluyas el número de puerto; por ejemplo, establece172.19.209.2
y no172.19.209.2:5432
.
Cambia de la pestaña Contenedores a la pestaña Herramientas de redes y completa los siguientes pasos:
Selecciona la casilla de verificación Conéctate a una VPC para el tráfico saliente.
Selecciona la opción Enviar tráfico directamente a una VPC.
En la lista desplegable Red, elige el valor
default
.En la lista desplegable Subred, asegúrate de que esté seleccionado el valor
default
.
Haz clic en Crear para crear el servicio de Cloud Run.
Después de implementar el servicio de Cloud Run, la página quickstart-service muestra la URL de la aplicación de ejemplo en el campo URL.
La aplicación usa AlloyDB como su almacén de datos.
En la consola de Google Cloud , ve a la página Cloud Run.
En la página quickstart-service, haz clic en content_copy Copiar al portapapeles para copiar la URL de la aplicación.
En una nueva pestaña del navegador, pega la URL de la aplicación que copiaste y haz clic en Intro.
La aplicación web de recopilación de votos de muestra que aparece es similar a la siguiente:
En la consola de Google Cloud , ve a la página Clústeres.
Junto al clúster
my-cluster
que deseas borrar, haz clic en more_vert Acciones y, luego, en delete Borrar.En el cuadro de diálogo Borrar clúster que aparece, escribe
my-cluster
en el campo my-cluster para confirmar que deseas borrarlo.Haz clic en Borrar.
En la consola de Google Cloud , ve a la página Cloud Run.
Selecciona la casilla de verificación junto al nombre del servicio
quickstart-service
.Haz clic en delete Borrar en la parte superior de la página de Cloud Run.
En el cuadro de diálogo Borrar quickstart-service que aparece, haz clic en Borrar para confirmar.
Crea un clúster y su instancia principal
Conéctate a tu instancia y crea una base de datos
Encuentra el ID del proyecto
Propaga Artifact Registry con una imagen de la aplicación de ejemplo
Busca la dirección IP de tu instancia nueva
Crea un servicio para Cloud Run
Consulta la aplicación de ejemplo
Limpia
Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.