Conéctate a Cloud SQL para SQL Server desde las funciones de Cloud Run
Obtén información para implementar una app de muestra en las funciones de Cloud Run que estén conectadas a una instancia de SQL Server mediante la consola de Google Cloud y una aplicación cliente.
Si suponemos que completas todos los pasos de manera oportuna, los recursos creados en esta guía de inicio rápido suelen costar menos de un dólar (USD).
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.
-
Make sure 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.
-
Make sure that billing is enabled for your Google Cloud project.
-
Habilita las API de Cloud necesarias para ejecutar una app de muestra de Cloud SQL en funciones de Cloud Run.
Console
Haz clic en Habilitar las API para habilitar las API necesarias en esta guía de inicio rápido.
Esto habilita las siguientes API:
- API de funciones de Cloud Run
- API de Cloud SQL Admin
- API de Cloud Run Admin
- API de Cloud Build
- API de Artifact Registry
- API de Eventarc
- API de Compute Engine
- API de Service Networking
- API de Cloud Logging
gcloud
Haz clic en el siguiente botón para abrir Cloud Shell, que proporciona acceso de línea de comandos a tus recursos de Google Cloud directamente desde el navegador. Cloud Shell se puede usar para ejecutar los comandos de
gcloud
que se presentan en esta guía de inicio rápido.Ejecuta el siguiente comando de
gcloud
con Cloud Shell:gcloud services enable cloudfunctions.googleapis.com sqladmin.googleapis.com run.googleapis.com cloudbuild.googleapis.com artifactregistry.googleapis.com eventarc.googleapis.com compute.googleapis.com servicenetworking.googleapis.com pubsub.googleapis.com logging.googleapis.com
Este comando habilita las siguientes API:
- API de funciones de Cloud Run
- API de Cloud SQL Admin
- API de Cloud Run
- API de Cloud Build
- API de Artifact Registry
- API de Eventarc
- API de Compute Engine
- API de Service Networking
- API de Cloud Logging
Agrega el rol de IAM Invocador de funciones de Cloud Run a tu usuario.
Configura Cloud SQL
Crea una instancia de Cloud SQL
Crea una base de datos
Console
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Selecciona
quickstart-instance
. - En el menú de navegación de SQL, selecciona Bases de datos.
- Haga clic en Crear base de datos.
- En el campo Nombre de la base de datos del cuadro de diálogo Base de datos nueva, ingresa
quickstart-db
. - Haz clic en Crear.
gcloud
Ejecuta el comando gcloud
sql databases create
para crear una base de datos.
gcloud sql databases create quickstart-db --instance=quickstart-instance
Configura una cuenta de servicio de funciones de Cloud Run
Console
-
En la consola de Google Cloud, ve a la página IAM.
- En la cuenta de servicio llamada Cuenta de servicio predeterminada de Compute Engine, haz clic en el ícono de lápiz.
- Haz clic en AGREGAR OTRA FUNCIÓN.
- Agrega la Función llamada Cliente de Cloud SQL.
- Haz clic en Guardar.
gcloud
-
Ejecuta el siguiente comando de
gcloud
para obtener una lista de las cuentas de servicio del proyecto:gcloud iam service-accounts list
- Copia el CORREO ELECTRÓNICO de la cuenta de servicio de Compute Engine.
- Ejecuta el siguiente comando para agregar la función de cliente de Cloud SQL a la cuenta de servicio de Compute Engine:
gcloud projects add-iam-policy-binding YOUR_PROJECT_ID \ --member="serviceAccount:SERVICE_ACCOUNT_EMAIL" \ --role="roles/cloudsql.client"
Crea una función
-
En la consola de Google Cloud, ve a la página Funciones de Cloud Run.
- Haz clic en Crear función.
- En Entorno, selecciona 2ª gen..
- En el campo Nombre de la función, ingresa
quickstart-function
. - En la sección Autenticación, selecciona Permitir invocaciones no autenticadas.
- Haz clic en Siguiente.
- En el menú Entorno de ejecución, selecciona uno de los siguientes idiomas:
- En el menú Código fuente, verifica que esté seleccionado el Editor directo. En este paso, usarás la función predeterminada proporcionada en el editor.
Idioma | Número de versión |
---|---|
Go | 1.20 |
Python | 3.10 |
Implementa la función
- En la parte inferior de la página de funciones de Cloud Run, haz clic en Implementar. La consola de Google Cloud te redirecciona a la página de detalles de la función.
- Cuando se complete la implementación de la función, haz clic en el vínculo URL para ver un navegador web que muestra el mensaje
Hello, World!
.
Implementa la app de muestra de Cloud SQL como una función
Configuras y, luego, implementas la app de muestra de Cloud SQL como una función de Cloud Run. Primero, usa Cloud Shell para configurar y compilar la app de muestra. Luego, usa funciones de Cloud Run para implementar la app de muestra.
Configura una app de ejemplo de Cloud SQL
Implementa la app de ejemplo
Los pasos para implementar la muestra en funciones de Cloud Run dependen del tipo de dirección IP que asignaste a tu instancia de Cloud SQL.
Realiza una limpieza
Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Selecciona la instancia
quickstart-instance
para abrir la página de detalles de la instancia. - En la barra de íconos en la parte superior de la página, haz clic en Borrar.
- En el cuadro de diálogo Borrar instancia, escribe
quickstart-instance
y, luego, haz clic en Borrar. -
En la consola de Google Cloud, ve a la página Funciones de Cloud Run.
- Selecciona la casilla de verificación junto al nombre del servicio
quickstart-function
. - Haz clic en Borrar en la parte superior de la página de funciones de Cloud Run.
Pasos opcionales de limpieza
Si no usas la función de cliente de Cloud SQL que asignaste a la cuenta de servicio de Compute Engine, puedes quitarla.
-
En la consola de Google Cloud, ve a la página IAM.
- Haz clic en el ícono de edición (que tiene forma de lápiz) en la cuenta de IAM llamada Cuenta de servicio predeterminada de Compute Engine.
- Borra la función cliente de Cloud SQL.
- Haz clic en Guardar.
Si no usas las API que se habilitaron como parte de esta guía de inicio rápido, puedes inhabilitarlas.
- API que se habilitaron en esta guía de inicio rápido:
- API de Compute Engine
- API de Cloud SQL Admin
- API de Cloud Run
- API de Container Registry
- API de Cloud Build
En la consola de Google Cloud, ve a la página API.
Selecciona la API que quieras inhabilitar y, luego, haz clic en el botón Inhabilitar API.
¿Qué sigue?
En función de tus necesidades, puedes obtener más información para crear instancias de Cloud SQL.También puedes aprender a crear usuarios de SQL Server y bases de datos para la instancia de Cloud SQL.
Si deseas obtener más información sobre los precios, consulta Precios de Cloud SQL para SQL Server.
Conoce más sobre:
- La configuración de la instancia de Cloud SQL con una dirección IP pública
- La configuración de la instancia de Cloud SQL con una dirección IP privada
Además, puedes obtener información sobre la conexión a una instancia de Cloud SQL desde otras aplicaciones de Google Cloud: