Conéctate a Cloud SQL para SQL Server desde Cloud Run

Console

Asigna un rango de direcciones IP y crea una conexión privada a fin de configurar el acceso privado a servicios para Cloud SQL.

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

   Ir a las redes de VPC

2. Selecciona la red de VPC default.
3. Selecciona la pestaña Conexión privada a servicios.
4. Selecciona la pestaña Rangos de IP asignados para los servicios.
5. Haz clic en Asigna rangos de IP.
6. Para el Nombre del rango asignado, especifica google-managed-services-default.
7. Selecciona la opción Automático para el rango de IP y especifica la longitud del prefijo como 16.
8. Haz clic en Asignar para crear un rango asignado.
9. Selecciona la pestaña Conexiones privadas a servicios para la red de VPC default.
10. Haz clic en Crear una conexión para crear una conexión privada entre tu red y un productor de servicios.
11. En Asignación designada, selecciona google-managed-services-default.
12. Haz clic en Conectar para crear la conexión.

Crea una instancia con una dirección IP privada y SSL habilitado

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

   Ir a Instancias de Cloud SQL

2. Haga clic en Crear instancia.
3. Haz clic en Elegir SQL Server.
4. Asegúrate de que Enterprise Plus esté seleccionada como la edición de Cloud SQL de tu instancia.
5. En el campo ID de instancia, ingresa quickstart-instance.
6. En el campo Contraseña, ingresa una contraseña para el usuario de sqlserver. Guarda esta contraseña para usarla más adelante.
7. En la sección Elige una región y una disponibilidad zonal, selecciona Zona única.
8. Haz clic en el menú Mostrar opciones de configuración.
9. Expande el nodo Configuración de la máquina.
10. En la región Formas de máquinas, selecciona la forma 4 CPU virtuales, 32 GB.
11. Expande el nodo Conexiones.
12. Desmarca la casilla de verificación IP pública para crear una instancia solo con una dirección IP privada.
13. Selecciona la casilla de verificación IP privada.
14. En el menú Red, selecciona configuración predeterminada.
15. Haz clic en Crear instancia y espera a que la instancia se inicialice y se inicie.
16. Haz clic en Conexiones.
17. En la sección Seguridad, selecciona Solo permitir conexiones SSL para habilitar las conexiones SSL.
18. En el cuadro de diálogo Solo permitir conexiones SSL, haz clic en Guardar y reiniciar y, luego, espera a que la instancia se reinicie.

gcloud

Asigna un rango de direcciones IP y crea una conexión privada a fin de configurar el acceso privado a servicios para Cloud SQL.

1. Ejecuta el comando gcloud compute addresses create para asignar un rango de direcciones IP.

   gcloud compute addresses create google-managed-services-default \
   --global --purpose=VPC_PEERING --prefix-length=16 \
   --description="peering range for Google" --network=default

2. Ejecuta el comando gcloud services vpc-peerings connect para crear una conexión privada al rango de direcciones IP asignado. Reemplaza YOUR_PROJECT_ID por el ID de tu proyecto.

   gcloud services vpc-peerings connect --service=servicenetworking.googleapis.com \
   --ranges=google-managed-services-default --network=default \
   --project=YOUR_PROJECT_ID

Crea una instancia con una dirección IP privada y SSL habilitado

1. Antes de ejecutar el comando de la siguiente manera, reemplaza DB_ROOT_PASSWORD por la contraseña del usuario de la base de datos.

De manera opcional, modifica los valores para los siguientes parámetros:

• --database-version: El tipo de motor de la base de datos y la versión. Si no se especifica, se usa la configuración predeterminada de API. Consulta la documentación de las versiones de la base de datos de gcloud para ver las versiones disponibles actuales.
• --cpu: Es la cantidad de núcleos en la máquina.
• --memory: Es un número de número entero que indica cuánta memoria se debe incluir en la máquina. Se puede proporcionar una unidad de tamaño (por ejemplo, 3,072 MB o 9 GB). Si no se especifican unidades, se supone que es GB.
• --region: Es la ubicación regional de la instancia (por ejemplo, asia-east1, us-east1). Si no se especifica, el valor predeterminado es us-central1. Consulta la lista completa de regiones.

Ejecuta el comando gcloud sql instances create para crear una instancia de Cloud SQL con una dirección IP privada.

gcloud sql instances create quickstart-instance \
--database-version=SQLSERVER_2017_STANDARD \
 --cpu=1 \
 --memory=4GB \
 --region=us-central \
 --root-password=DB_ROOT_PASSWORD \
 --no-assign-ip \
--network=default

2. Ejecuta el comando gcloud sql instances patch a fin de habilitar solo permitir conexiones SSL para la instancia.

gcloud sql instances patch quickstart-instance --require-ssl

Go

Crea y descarga certificados del servidor SSL

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

   Ir a Instancias de Cloud SQL

2. Haz clic en quickstart-instance para ver la página Descripción general.
3. Haz clic en la pestaña Conexiones.
4. En la sección Seguridad, haz clic en Descargar certificados para descargar el certificado del servidor SSL.

Crea una conexión de VPC sin servidores para conexiones a la instancia a través de IP privada

1. En la consola de Google Cloud, ve a la página Acceso a VPC sin servidores - Crear conector.

   Crear un conector de VPC sin servidores

2. Ingresa quickstart-connector en el campo Nombre.
3. Selecciona configuración predeterminada en el menú desplegable Red.
4. Selecciona Rango de IP personalizado en el menú desplegable Subred.
5. Ingresa 10.8.0.0 en la casilla de entrada Rango de IP.
6. Haz clic en Crear.

Compila una app de muestra con un certificado de servidor SSL

1. En el editor de Cloud Shell, abre el código fuente de la app de muestra.

   Abrir Cloud Shell Editor
2. En el cuadro de diálogo Abrir en Cloud Shell, haz clic en Confirmar para descargar el código de la aplicación de muestra y abrir el directorio de la aplicación de muestra en el editor de Cloud Shell.
3. Sube el archivo del certificado de servidor SSL a la carpeta certs.
   1. Haz clic con el botón derecho en la carpeta certs en el editor de Cloud Shell y selecciona Subir archivos.
   2. Selecciona el siguiente archivo en tu máquina local: server-ca.pem.
   3. Con el archivo del certificado del servidor SSL seleccionado, haz clic en Abrir para completar el proceso de carga del archivo al editor de Cloud Shell.
4. Ejecuta el siguiente comando en Cloud Shell para compilar un contenedor de Docker y publicarlo en Container Registry. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Java

Crea y descarga certificados del servidor SSL

Para los usuarios de Java, el conector ya proporciona una conexión segura, por lo que no es necesario crear y descargar el certificado del servidor SSL.

Crea una conexión de VPC sin servidores para conexiones a la instancia a través de IP privada

1. En la consola de Google Cloud, ve a la página Acceso a VPC sin servidores - Crear conector.

   Crear un conector de VPC sin servidores

2. Ingresa quickstart-connector en el campo Nombre.
3. Selecciona configuración predeterminada en el menú desplegable Red.
4. Selecciona Rango de IP personalizado en el menú desplegable Subred.
5. Ingresa 10.8.0.0 en la casilla de entrada Rango de IP.
6. Haz clic en Crear.

App de ejemplo de compilación

1. En el editor de Cloud Shell, abre el código fuente de la app de muestra.

   Abrir Cloud Shell Editor
2. En el cuadro de diálogo Abrir en Cloud Shell, haz clic en Confirmar para descargar el código de la aplicación de muestra y abrir el directorio de la aplicación de muestra en el editor de Cloud Shell.
3. Ejecuta el siguiente comando en Cloud Shell para compilar un contenedor de Docker y publicarlo en Container Registry. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   mvn clean package com.google.cloud.tools:jib-maven-plugin:2.8.0:build \
    -Dimage=gcr.io/YOUR_PROJECT_ID/run-sql -DskipTests

Python

Crea y descarga certificados del servidor SSL

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

   Ir a Instancias de Cloud SQL

2. Haz clic en quickstart-instance para ver la página Descripción general.
3. Haz clic en la pestaña Conexiones.
4. En la sección Seguridad, haz clic en Descargar certificados para descargar el certificado del servidor SSL.

Crea una conexión de VPC sin servidores para conexiones a la instancia a través de IP privada

1. En la consola de Google Cloud, ve a la página Acceso a VPC sin servidores - Crear conector.

   Crear un conector de VPC sin servidores

2. Ingresa quickstart-connector en el campo Nombre.
3. Selecciona configuración predeterminada en el menú desplegable Red.
4. Selecciona Rango de IP personalizado en el menú desplegable Subred.
5. Ingresa 10.8.0.0 en la casilla de entrada Rango de IP.
6. Haz clic en Crear.

Compila una app de muestra con un certificado de servidor SSL

1. En el editor de Cloud Shell, abre el código fuente de la app de muestra.

   Abrir Cloud Shell Editor
2. En el cuadro de diálogo Abrir en Cloud Shell, haz clic en Confirmar para descargar el código de la aplicación de muestra y abrir el directorio de la aplicación de muestra en el editor de Cloud Shell.
3. Sube el archivo del certificado de servidor SSL a la carpeta certs.
   1. Haz clic con el botón derecho en la carpeta certs en el editor de Cloud Shell y selecciona Subir archivos
   2. Selecciona el siguiente archivo en tu máquina local: server-ca.pem.
   3. Con el archivo del certificado del servidor SSL seleccionado, haz clic en Abrir para completar el proceso de carga del archivo al editor de Cloud Shell.
4. Ejecuta el siguiente comando en Cloud Shell para compilar un contenedor de Docker y publicarlo en Container Registry. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   gcloud builds submit --tag gcr.io/YOUR_PROJECT_ID/run-sql

Console

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

   Ir a Cloud Run

2. Haz clic en Crear contenedor y selecciona Servicio para mostrar el formulario Crear servicio.

3. Conserva la opción de implementar desde una imagen de contenedor existente y haz clic en Seleccionar para especificar la imagen de contenedor gcr.io/YOUR_PROJECT_ID/run-sql que creaste en el paso anterior.
4. Ingresa quickstart-service en Nombre del servicio.
5. En la sección Autenticación, selecciona la opción Allow unauthenticated invocations. Si no tienes permisos (rol de administrador de Cloud Run) para seleccionar esta opción, el servicio se implementará y requerirá autenticación.
6. Expande la sección Contenedor, variables y secretos, Conexiones, Seguridad.
7. Para crear las siguientes variables de entorno, haz clic en Agregar variable en Variables de entorno. Establece los valores para las variables de entorno de la siguiente manera:
• DB_NAME: Configurado como quickstart-db.
• DB_USER: configurado como sqlserver
• DB_PASS: configurado como la contraseña del usuario de sqlserver que creaste en Crea una instancia de Cloud SQL.
• INSTANCE_CONNECTION_NAME: configurado como el Nombre de conexión de tu instancia que aparece en la página Instancias de Cloud SQL en la consola de Google Cloud.
• DB_PORT: Configurado como 1433.
• INSTANCE_HOST: Establece la dirección IP privada de tu instancia como se menciona en la página Descripción general de la instancia de Cloud SQL.
• DB_ROOT_CERT: configurado como certs/server-ca.pem
• PRIVATE_IP: configurado como TRUE

8. Habilita la conexión a Cloud SQL:

   1. Haz clic en Conexiones.
   2. Haz clic en Agregar conexión en la sección Conexiones de Cloud SQL.
   3. Selecciona la instancia de Cloud SQL quickstart-instance que creaste antes.
   4. Selecciona default: Serverless VPC Access Connector "quickstart-connector" del menú desplegable Red de VPC.
   5. Selecciona la opción Enrutar todo el tráfico por medio del conector de VPC.

9. Haz clic en Crear para terminar de crear el servicio de Cloud Run.

10. Después de implementar el servicio de Cloud Run, la página Detalles del servicio muestra la URL del servicio en ejecución en la parte superior de la página. Haz clic en el vínculo URL para ver la aplicación de muestra implementada en Cloud Run conectada a Cloud SQL.

    

gcloud

1. Antes de ejecutar el siguiente comando, realiza los siguientes reemplazos:

• YOUR_PROJECT_ID por el ID del proyecto

• INSTANCE_CONNECTION_NAME por el Nombre de conexión de tu instancia que aparece en la página Instancias de Cloud SQL en la consola de Google Cloud.

• DB_PASS por la contraseña del usuario de sqlserver que creaste en Crea una instancia de Cloud SQL
• INSTANCE_HOST por la dirección IP privada de la instancia Ve a la página Descripción general de la instancia de Cloud SQL en la que aparece la dirección IP privada de la instancia.

Ejecuta el comando gcloud run deploy de la siguiente manera para crear el servicio de Cloud Run:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433" \
  --set-env-vars INSTANCE_HOST="INSTANCE_HOST" \
  --set-env-vars DB_ROOT_CERT="certs/server-ca.pem" \
  --set-env-vars PRIVATE_IP="TRUE"

Los usuarios de Java deben ejecutar el comando gcloud run deploy sin las marcas INSTANCE_HOST, DB_ROOT_CERT y PRIVATE_IP --set-env-vars, de la siguiente manera, para crear el servicio de Cloud Run debido a que el conector de Java ya proporciona una conexión segura:

gcloud run deploy run-sql --image gcr.io/YOUR_PROJECT_ID/run-sql \
  --add-cloudsql-instances INSTANCE_CONNECTION_NAME \
  --vpc-connector="quickstart-connector" --vpc-egress=all-traffic \
  --set-env-vars DB_NAME="quickstart-db" \
  --set-env-vars DB_USER="sqlserver" \
  --set-env-vars DB_PASS="DB_PASS" \
  --set-env-vars INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME" \
  --set-env-vars DB_PORT="1433"

Ingresa la opción numérica proporcionada para us-central1 cuando se te solicite especificar una región.

2. Cuando aparezca un mensaje de confirmación que indique que el servicio de Cloud Run se implementó, haz clic en el vínculo URL de servicio en el mensaje para ver la app de muestra en Cloud Run conectada a Cloud SQL.