Conéctate a Cloud SQL para SQL Server desde Compute Engine

Conéctate a Cloud SQL para SQL Server desde Compute Engine

MySQL   |  PostgreSQL   |  SQL Server

Aprende a implementar una app de ejemplo en tu instancia de VM de Compute Engine basada en Linux o Windows conectada 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

Nota: El nombre que uses para el proyecto debe tener entre 4 y 30 caracteres. Cuando escribes el nombre, el formulario sugiere un ID del proyecto que puedes editar. El ID del proyecto debe tener entre 6 y 30 caracteres y debe comenzar con una letra minúscula. Puedes usar un guion, una letra minúscula o un número para los caracteres restantes, pero el último carácter no puede ser un guion.

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. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

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

4. En la página del selector de proyectos de la consola de Google Cloud, selecciona o crea un proyecto de Google Cloud.

   Nota: Si no planeas conservar los recursos que creaste durante este procedimiento, crea un proyecto en lugar de seleccionar uno existente. Cuando termines, puedes borrar el proyecto y quitar todos los recursos asociados con él.

   Ir al selector de proyectos

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

6. Habilita las API de Cloud necesarias para ejecutar una app de ejemplo de Cloud SQL en una instancia de VM de Compute Engine.

   Console

   Haz clic en el botón Habilitar las API para habilitar las APIs necesarias para esta guía de inicio rápido.

   Habilita las API

   Esto habilita la siguiente API:

   • API de Cloud SQL Admin

   gcloud

   Instala la CLI de gcloud, que proporciona acceso de la línea de comandos a los recursos de Google Cloud. La CLI de gcloud se usa para ejecutar los comandos gcloud CLI que se presentan en esta guía de inicio rápido. Se le da formato a todos los comandos para que se ejecuten en una terminal o en una ventana de PowerShell.

   Ejecuta el siguiente comando gcloud:

   gcloud services enable sqladmin.googleapis.com

   Este comando habilita la siguiente API:

   • API de Cloud SQL Admin

Configura Cloud SQL

Crea una instancia de Cloud SQL

IP pública

Consola

Crea una instancia con una dirección IP pública

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 SQL Server.
4. En el campo ID de instancia, ingresa quickstart-instance.
5. En el campo Contraseña, ingresa una contraseña para el usuario de sqlserver. Guarda esta contraseña para usarla más adelante.
6. En la sección Elige una región y una disponibilidad zonal, selecciona Zona única.
7. Expande la sección Mostrar configuración.
8. En la lista desplegable Tipo de máquina, selecciona Mantenimiento ligero.
9. Haz clic en Crear instancia y espera hasta que la instancia se inicialice y comience.

gcloud

Crea una instancia con una dirección IP pública

Antes de ejecutar el comando gcloud sql instances create 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 actualmente disponibles.
• --cpu: Es la cantidad de núcleos deseados en la máquina.
• --memory: valor de número entero que indica la cantidad de memoria que se desea en la máquina. Se debe 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: ubicación regional de la instancia (por ejemplo, asia-east1, us-east1). Si no se especifica, el valor predeterminado es us-central. Consulta la lista completa de regiones.

Ejecuta el comando gcloud sql instances create para crear una instancia de Cloud SQL.

gcloud sql instances create quickstart-instance --database-version=SQLSERVER_2019_STANDARD --cpu=1 --memory=4GB --region=us-central --root-password=DB_ROOT_PASSWORD

IP privada

Consola

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 SQL Server.
4. Ingresa quickstart-instance en ID de la instancia.
5. Ingresa una contraseña para el usuario de sqlserver. Guarda esta contraseña para usarla más adelante.
6. Haz clic en la opción Zona única para elegir la región y la disponibilidad zonal.
7. Haz clic y expande Mostrar opciones de configuración.
8. En Tipo de máquina, selecciona Ligera.
9. En Conexiones, selecciona IP privada.
10. Selecciona configuración predeterminada en el menú desplegable Red.
11. Desmarca la casilla de verificación IP pública para crear una instancia solo con una IP privada.
12. Haz clic en Crear instancia y espera a que la instancia se inicialice y se inicie.
13. Haz clic en Conexiones.
14. En la sección Seguridad, selecciona Solo permitir conexiones SSL para habilitar las conexiones SSL.
15. 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 actualmente disponibles.
• --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 beta 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

Crea una base de datos

Consola

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

   Ir a Instancias de Cloud SQL

2. Selecciona quickstart-instance.
3. Abre la pestaña Bases de datos.
4. Haga clic en Crear base de datos.
1. En el cuadro de diálogo Nueva base de datos, ingresa quickstart_db como nombre de la base de datos.
   
2. 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 Compute Engine

Crea y configura una cuenta de servicio de Google Cloud que tenga el rol de cliente de Cloud SQL con permisos para conectarse a Cloud SQL. Después de crear una cuenta de servicio, es posible que debas esperar 60 segundos o más antes de poder usarla.

Consola

Crea una cuenta de servicio

1. En la consola de Google Cloud, ve a la página Crear cuenta de servicio.

Ve a Crear cuenta de servicio

2. Selecciona un proyecto de Google Cloud.
3. Ingresa quickstart-service-account como el nombre de la cuenta de servicio.
4. Opcional: Ingresa una descripción de la cuenta de servicio.
5. Haz clic en Crear y continuar y continúa con el paso siguiente.
6. Elige el rol Cliente de Cloud SQL para otorgárselo a la cuenta de servicio en el proyecto.
7. Haz clic en Agregar otro rol y elige el rol Visualizador de objetos de almacenamiento para otorgar a la cuenta de servicio del proyecto.
8. Haga clic en Continue.
9. Haz clic en Listo para terminar de crear la cuenta de servicio.

gcloud

Crea una cuenta de servicio

1. Para crear la cuenta de servicio, ejecuta el comando gcloud iam service-accounts create:

gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"

Reemplaza el siguiente valor:

• DESCRIPTION: una descripción opcional de la cuenta de servicio
2. Para otorgar a tu cuenta de servicio el rol Cliente de Cloud SQL y el rol Visualizador de objetos de almacenamiento en tu proyecto, ejecuta el comando gcloud projects add-iam-policy-binding. Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud:

   gcloud projects add-iam-policy-binding PROJECT_ID --member="serviceAccount:quickstart-service-account@PROJECT_ID.iam.gserviceaccount.com" --role="roles/cloudsql.client" --role="roles/storage.objectViewer"

Crea una instancia de VM de Compute Engine

Crea una instancia de VM de Compute Engine para alojar una aplicación web de ejemplo que se conecte a Cloud SQL

Cree una instancia de VM de Linux

Console

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

   Ir a Instancias de VM

2. Haz clic en el botón Crear instancia.
3. En Nombre de la instancia de VM, ingresa quickstart-vm-instance.
4. En Cuentas de servicio, selecciona quickstart-service-account.
5. En Firewall, selecciona la opción Permitir tráfico HTTP.
6. Haz clic en Crear para crear la instancia de VM.

gcloud

Antes de ejecutar el siguiente comando, reemplaza YOUR_PROJECT_ID por el ID de tu proyecto.

Ejecuta el siguiente comando gcloud compute instances create.

gcloud compute instances create quickstart-vm-instance --image-family=debian-10 --image-project=debian-cloud  --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Crea una instancia de VM de Windows

Console

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

   Ir a Instancias de VM

2. Haz clic en el botón Crear instancia.
3. En Nombre de la instancia de VM, ingresa quickstart-vm-instance.
4. En Disco de arranque, haz clic en el botón Cambiar.
1. En Sistema operativo, selecciona Windows Server.
2. En Versión, selecciona Windows Server 2022 Datacenter.
3. Haz clic en el botón Seleccionar.
5. En Cuentas de servicio, selecciona quickstart-service-account.
6. En Firewall, selecciona la opción Permitir tráfico HTTP.
7. Haz clic en Crear para crear la instancia de VM.
8. Luego de 2 o 3 minutos después de que se inicia la instancia de VM, haz clic en el botón Configurar contraseña de Windows en la página de detalles de la instancia de VM.
9. Copia y guarda esta contraseña en una ubicación segura, ya que la usarás para acceder a tu instancia de VM en el siguiente paso de esta guía de inicio rápido.

gcloud

Antes de ejecutar el siguiente comando, reemplaza YOUR_PROJECT_ID por el ID de tu proyecto.

En una ventana de terminal, ejecuta el siguiente comando gcloud compute instances create.

gcloud compute instances create quickstart-vm-instance --image-project=windows-cloud --image-family=windows-2022 --machine-type=e2-medium --service-account=quickstart-service-account@YOUR_PROJECT_ID.iam.gserviceaccount.com --scopes=https://www.googleapis.com/auth/cloud-platform --tags=http-server --zone=us-central1-a

Luego de 2 o 3 minutos después de que se inicia la instancia de VM, ejecuta el siguiente comando para establecer la contraseña de Windows en la instancia de VM.

gcloud compute reset-windows-password quickstart-vm-instance

Copia y guarda esta contraseña en una ubicación segura, ya que la usarás para acceder a tu instancia de VM en el siguiente paso de esta guía de inicio rápido.

Accede a una instancia de VM de Compute Engine

Accede a una instancia de VM de Linux

Console

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

Ir a Instancias de VM

En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia a la que deseas conectarte.

Nota: Cuando te conectas a las VMs mediante la consola de Google Cloud, Compute Engine crea una clave SSH efímera para ti. Para obtener más información sobre las claves SSH, consulta Conexiones SSH a las VMs de Linux.

gcloud

Usa el comando gcloud compute ssh para conectarte a una instancia de VM de Linux. Reemplaza YOUR_PROJECT_ID por el ID del proyecto:

gcloud compute ssh --project=YOUR_PROJECT_ID --zone=us-central1-a quickstart-vm-instance

Accede a una instancia de VM de Windows

Complemento Chrome RDP

Chrome RDP para Google Cloud es un complemento de terceros que te permite conectarte a instancias de Windows mediante el navegador Chrome. El complemento está integrado en la consola de Google Cloud. Después de instalar el complemento, conéctate a cualquier instancia de Windows Server mediante el botón RDP en la consola de Google Cloud.

Para conectarte mediante el complemento Chrome RDP, haz lo siguiente:

1. Instala la extensión Chrome RDP para Google Cloud.
2. En la consola de Google Cloud, ve a la página Instancias de VM y busca la instancia de Windows a la que deseas conectarte.

Ir a la página Instancias de VM

3. Haz clic en el botón RDP de la instancia a la que deseas conectarte. Se abrirá la extensión Chrome RDP.
4. Dado que tu instancia de VM no tiene un dominio configurado, puedes dejar el campo Dominio en blanco.
5. Ingresa tu nombre de usuario y contraseña, y haz clic en Aceptar para conectarte.

6. Si se te solicita, presiona Continuar para aceptar el certificado.

Otro

Consulta Conéctate a las VMs de Windows mediante RDP para conocer más opciones de acceso a una instancia de VM de Windows de Compute Engine.

Configura el entorno de desarrollo para el lenguaje de programación

Configura el entorno de desarrollo de la instancia de VM de Compute Engine para tu lenguaje de programación preferido.

Configura el entorno de desarrollo de la instancia de VM de Linux

Go

Completa los siguientes pasos a fin de configurar el entorno de desarrollo de la instancia de VM de Compute Engine para ejecutar la app de ejemplo de Go.

1. Ve a la guía de configuración para un entorno de desarrollo de Go.
2. Completa las instrucciones de la sección Instala Go.

Java

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Java.

1. Ve a la guía de configuración para un entorno de desarrollo de Java.
2. Completa las instrucciones de la sección Instala un JDK (Java Development Kit).
3. Completa las instrucciones de la sección Instala una herramienta de automatización de compilación para configurar Apache Maven.

Node.js

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Node.js.

1. Ve a la guía de configuración para un entorno de desarrollo de Node.js.
2. Completa las instrucciones en la sección Instala Node.js y npm.

Python

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Python.

1. Ve a la guía de configuración para un entorno de desarrollo de Python.
2. Completa las instrucciones en la sección Instala Python.

Configura el entorno de desarrollo de la instancia de VM de Windows

Go

Completa los siguientes pasos a fin de configurar el entorno de desarrollo de la instancia de VM de Compute Engine para ejecutar la app de ejemplo de Go.

1. Ve a la guía de configuración para un entorno de desarrollo de Go.
2. Completa las instrucciones de la sección Instala Go.

Java

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Java.

1. Ve a la guía de configuración para un entorno de desarrollo de Java.
2. Completa las instrucciones de la sección Instala un JDK (Java Development Kit).
3. Completa las instrucciones de la sección Instala una herramienta de automatización de compilación para configurar Apache Maven.

Node.js

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Node.js.

1. Ve a la guía de configuración para un entorno de desarrollo de Node.js.
2. Completa las instrucciones en la sección Instala Node.js y npm.

Python

Completa los siguientes pasos para configurar el entorno de desarrollo de la instancia de VM de Compute Engine a fin de ejecutar la app de ejemplo de Python.

1. Instala Python y el administrador de paquetes de PIP para Python.
1. Ve a la guía de configuración para un entorno de desarrollo de Python.
2. Completa las instrucciones en la sección Instala Python.
1. Las instrucciones anteriores te permitirán visitar la página de descargas de las Versiones de Python para Windows. En esa página, haz clic en el vínculo Versión más reciente de Python 3.
2. En la página de Python 3.XX, haz clic en el vínculo Instalador de Windows de 64 bits para descargar el archivo del instalador en tu instancia de VM de Windows Compute Engine.
3. Una vez que hayas descargado el instalador de Python en la instancia de VM, abre la carpeta que contiene el archivo descargado. Luego, haz clic con el botón derecho en el archivo del instalador y selecciona Ejecutar como administrador.
4. En el cuadro de diálogo Instalar Python que aparece, selecciona la opción Agregar Python 3.XX a PATH y haz clic en → Instalar ahora.
2. Usa PIP para instalar virtualenv.
1. Abre PowerShell en la instancia de VM de Compute Engine de Windows y ejecuta el siguiente comando de pip install.

pip install virtualenv

Instalar Git

Instala Git, un sistema de control de versiones de código abierto, en tu instancia de VM de Compute Engine.

Instancia de VM de Linux de Compute Engine

En tu instancia de VM de Linux de Compute Engine, sigue la documentación oficial de instalación de Git para Linux.

• Ejecuta el comando sugerido de Debian/Ubuntu install git con el prefijo de comando sudo para ejecutar el comando como administrador. El comando de instalación completo que se ejecutará en la terminal debe tener el siguiente formato:

sudo apt-get install git

Instancia de VM de Windows de Compute Engine

En tu instancia de VM de Windows de Compute Engine, sigue la documentación oficial de instalación de Git para Windows a fin de descargar el instalador independiente de 64 bits y ejecutarlo para instalar Git.

Clona una app de ejemplo

Clona una app de ejemplo en tu instancia de VM de Compute Engine con el comando git clone.

Go

En tu instancia de VM de Compute Engine, abre una terminal nueva o una ventana de PowerShell. Ejecuta los siguientes comandos para clonar la app de ejemplo de Go y cambia el directorio al que contiene la app de ejemplo.

1. Clona la app de ejemplo.

   git clone https://github.com/GoogleCloudPlatform/golang-samples

2. Cambia el directorio al que contiene la aplicación de ejemplo.

   cd golang-samples/cloudsql/sqlserver/database-sql

Java

En tu instancia de VM de Compute Engine, abre una terminal nueva o una ventana de PowerShell. Ejecuta los siguientes comandos para clonar la app de ejemplo de Java y cambia el directorio al que contiene la app de ejemplo.

1. Clona la app de ejemplo.

   git clone https://github.com/GoogleCloudPlatform/java-docs-samples

2. Cambia el directorio al que contiene la aplicación de ejemplo.

   cd java-docs-samples/cloud-sql/sqlserver/servlet

Node.js

En tu instancia de VM de Compute Engine, abre una terminal nueva o una ventana de PowerShell. Ejecuta los siguientes comandos para clonar la app de ejemplo de Node.js y cambia el directorio al que contiene la app de ejemplo.

1. Clona la app de ejemplo.

   git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples

2. Cambia el directorio al que contiene la aplicación de ejemplo.

   cd nodejs-docs-samples/cloud-sql/sqlserver/mssql

Python

En tu instancia de VM de Compute Engine, abre una terminal nueva o una ventana de PowerShell. Ejecuta los siguientes comandos para clonar la app de ejemplo de Python y cambia el directorio al que contiene la app de ejemplo.

1. Clona la app de ejemplo.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples

2. Cambia el directorio al que contiene la aplicación de ejemplo.

   cd python-docs-samples/cloud-sql/sql-server/sqlalchemy

Configura y ejecuta una app de ejemplo de Cloud SQL

Con una instancia de Cloud SQL, una base de datos y una cuenta de servicio con permisos de cliente, ahora puedes configurar una aplicación de ejemplo que se ejecute en tu instancia de VM de Compute Engine para conectarte a tu instancia de Cloud SQL.

Instancia de Cloud SQL de IP pública y VM de Compute Engine basada en Linux

Go

En la instancia de VM de Compute Engine, en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para obtener las dependencias de la app de ejemplo de Go en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Obtén las dependencias necesarias para ejecutar la app de ejemplo.

   go get ./...
   

2. Ejecuta la app de ejemplo.

   go run cmd/app/main.go
   

En tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine donde se ejecuta la aplicación de ejemplo y visualízala en un navegador.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine mediante la ejecución del siguiente comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en tu computadora local y ve a la dirección IP externa y al puerto 8080 de la instancia de VM de Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Java

En la instancia de VM de Compute Engine, en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta el siguiente comando para obtener las dependencias de la app de ejemplo de Java en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

mvn jetty:run

En tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine donde se ejecuta la aplicación de ejemplo y visualízala en un navegador.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine mediante la ejecución del siguiente comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en tu computadora local y ve a la dirección IP externa y al puerto 8080 de la instancia de VM de Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Node.js

1. En la instancia de VM de Compute Engine, en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza el siguiente reemplazo:

   • YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

   export INSTANCE_HOST='127.0.0.1'
   export DB_PORT='1433'
   export DB_NAME='quickstart_db'
   export DB_USER='sqlserver'
   export DB_PASS='YOUR_DB_PASSWORD'
   

2. Descarga el proxy de Cloud SQL Auth.

   curl -o cloud-sql-proxy \
   https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.linux.amd64

3. Configura los permisos para que el archivo de proxy de Cloud SQL Auth sea ejecutable.

   chmod +x cloud-sql-proxy

4. Ejecuta el proxy de autenticación de Cloud SQL como proceso en segundo plano. Reemplaza 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.

   ./cloud-sql-proxy INSTANCE_CONNECTION_NAME &

Nota: El proceso que ejecuta el proxy de autenticación de Cloud SQL en segundo plano puede detenerse con el comando fg en la ventana de terminal en la que iniciaste la app de ejemplo. Esto debería llevar el trabajo del proxy de autenticación de Cloud SQL en ejecución al primer plano de la terminal. Luego, presiona las teclas Ctrl + C para detener el trabajo de proxy.

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para obtener los paquetes de Node.js necesarios en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Instala los paquetes de Node.js necesarios para ejecutar la app de forma local.

   npm install
   

2. Ejecuta la app de ejemplo.

   npm start
   

En tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine donde se ejecuta la aplicación de ejemplo y visualízala en un navegador.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine mediante la ejecución del siguiente comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en tu computadora local y ve a la dirección IP externa y al puerto 8080 de la instancia de VM de Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Python

En la instancia de VM de Compute Engine, en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_CONNECTION_NAME='INSTANCE_CONNECTION_NAME'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para llevar los requisitos de la app de ejemplo de Python a la instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Inicializa un entorno virtual y, luego, instala los requisitos para ejecutar la app de ejemplo.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. Ejecuta la app de ejemplo.

   python app.py
   

En tu computadora local, configura la redirección de puertos mediante SSH con las instrucciones del siguiente paso de la guía de inicio rápido. Esto te permite usar un navegador en tu computadora local para ver la aplicación que se ejecuta en tu instancia de VM de Compute Engine.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, ejecuta el siguiente comando gcloud compute ssh para configurar la redirección de puertos a través de SSH. Antes de ejecutar el comando, reemplaza YOUR_PROJECT_ID por el ID del proyecto.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Visualiza la app de ejemplo en ejecución. Con la redirección de puertos activa, abre un navegador en tu computadora local y, luego, ingresa http://127.0.0.1:8000 en la barra de direcciones de tu navegador.

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Instancia de Cloud SQL de IP pública y VM de Compute Engine basada en Windows

Go

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para obtener las dependencias de la app de ejemplo de Go en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Obtén las dependencias necesarias para ejecutar la app de ejemplo.

   go get ./...
   

2. Ejecuta la app de ejemplo.

   go run cmd\app\main.go
   

3. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Java

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

1. En la instancia de VM de Compute Engine, en la ventana abierta de PowerShell, ejecuta el siguiente comando para obtener las dependencias de la app de ejemplo de Java en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

   mvn jetty:run
   

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Node.js

1. En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza el siguiente reemplazo:

   • YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

   $env:INSTANCE_HOST="127.0.0.1"
   $env:DB_PORT="1433"
   $env:DB_NAME="quickstart_db"
   $env:DB_USER="sqlserver"
   $env:DB_PASS="YOUR_DB_PASSWORD"
   
   

2. Descarga el proxy de Cloud SQL Auth.

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.0.0/cloud-sql-proxy.x64.exe `
   -O cloud-sql-proxy.exe

3. Ejecuta el proxy de autenticación de Cloud SQL como proceso en segundo plano. Reemplaza 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.

   Start-Process -filepath  ".\cloud-sql-proxy.exe" -ArgumentList `
   "INSTANCE_CONNECTION_NAME"

Nota: El proceso que ejecuta el proxy de autenticación de Cloud SQL en segundo plano se puede detener si seleccionas la ventana cmd.exe que generó el comando Start-Process. Luego cierra la ventana para detener el trabajo de proxy.

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para obtener los paquetes de Node.js necesarios en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Instala los paquetes de Node.js necesarios para ejecutar la app de forma local.

   npm install
   

2. Ejecuta la app de ejemplo.

   npm start
   

3. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Python

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• 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.
• YOUR_DB_PASSWORD por la contraseña del quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

$env:INSTANCE_CONNECTION_NAME="INSTANCE_CONNECTION_NAME"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para implementar los requisitos de la app de ejemplo de Python en tu instancia de VM de Compute Engine y ejecutar la aplicación de ejemplo.

1. Inicializa un entorno virtual y, luego, instala los requisitos para ejecutar la app de ejemplo.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   
   

2. Ejecuta la app de ejemplo.

   python app.py
   

3. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Instancia de Cloud SQL de IP privada y VM de Compute Engine basada en Linux

Crea y descarga un certificado de servidor SSL en tu computadora local

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.

Sube un certificado SSL al bucket de Cloud Storage

Console

En un navegador de tu computadora local, crea un bucket de Cloud Storage y sube el certificado SSL al bucket en el que se pueda acceder a este desde la instancia de VM de Compute Engine.

1. Crea depósitos de almacenamiento.
1. En Nombre de tu bucket, ingresa el siguiente nombre. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   YOUR_PROJECT_ID-quickstart-certs

2. Haz clic en el botón Crear para crear el bucket.
2. Haz clic en el botón Subir archivos para subir archivos al bucket de Cloud Storage recién creado.
3. Selecciona el siguiente archivo para subirlo desde tu computadora local a Cloud Storage:
• server-ca.pem

gcloud

En tu computadora local, en una terminal o en una ventana de PowerShell abierta al directorio donde descargaste el certificado SSL, ahora puedes crear un bucket de Cloud Storage y subir el certificado SSL al bucket en el que se pueda acceder a este desde la instancia de VM de Compute Engine. La utilidad de línea de comandos de Cloud Storage gsutil, que se incluye con la CLI de gcloud, se usará para subir el archivo.

1. Ejecuta el siguiente comando gsutil mb para crear un nuevo bucket de Cloud Storage:

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. Desde el directorio en el que descargaste el certificado en tu computadora local, ejecuta el siguiente comando gsutil cp para copiar los certificados SSL en el bucket de Cloud Storage recién creado:

gsutil cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una terminal abierta al directorio golang-samples/cloudsql/sqlserver/database-sql, ejecuta el siguiente comando gsutil cp para descargar los certificados SSL de Cloud Storage al directorio certs.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para obtener las dependencias de la app de ejemplo de Go en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Obtén las dependencias necesarias para ejecutar la app de ejemplo.

   go get ./...
   

2. Ejecuta la app de ejemplo.

   go run cmd/app/main.go
   

En tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine donde se ejecuta la aplicación de ejemplo y visualízala en un navegador.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine mediante la ejecución del siguiente comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en tu computadora local y ve a la dirección IP externa y al puerto 8080 de la instancia de VM de Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Java

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una terminal abierta al directorio java-docs-samples/cloud-sql/sqlserver/servlet/, ejecuta el siguiente comando gsutil cp para descargar los certificados SSL de Cloud Storage al directorio actual.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Configura los certificados SSL para usarlos en Java en la instancia de VM de Compute Engine

En la terminal de la instancia de VM de Compute Engine, ejecuta el siguiente comando para importar el certificado de servidor a un almacén de confianza personalizado de Java con keytool. Antes de ejecutar el siguiente comando, reemplaza TRUST_CERT_KEYSTORE_PASSWD por tu propia contraseña de almacén de claves personalizada que se usará para crear el almacén de confianza de Java.

keytool -importcert -alias MySQLCACert -file server-ca.pem \
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export TRUST_CERT_KEYSTORE_PATH='quickstart-truststore'
export TRUST_CERT_KEYSTORE_PASSWD='TRUST_CERT_KEYSTORE_PASSWD'
export PRIVATE_IP='TRUE'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta el siguiente comando para obtener las dependencias de la app de ejemplo de Java en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

mvn jetty:run

En tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine donde se ejecuta la aplicación de ejemplo y visualízala en un navegador.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, obtén la dirección IP externa de la instancia de VM de Compute Engine mediante la ejecución del siguiente comando gcloud compute instances describe:

gcloud compute instances describe quickstart-vm-instance --format="value(networkInterfaces[0].accessConfigs[].natIP)"

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en tu computadora local y ve a la dirección IP externa y al puerto 8080 de la instancia de VM de Compute Engine.

   http://COMPUTE_ENGINE_VM_EXTERNAL_IP_ADDRESS:8080
   

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Python

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una terminal abierta al directorio python-docs-samples/cloud-sql/sql-server/sqlalchemy, ejecuta el siguiente comando gsutil cp para descargar los certificados SSL de Cloud Storage al directorio certs.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

export INSTANCE_HOST='INSTANCE_HOST'
export DB_PORT='1433'
export DB_NAME='quickstart_db'
export DB_USER='sqlserver'
export DB_PASS='YOUR_DB_PASSWORD'
export DB_ROOT_CERT='certs/server-ca.pem'
export PRIVATE_IP='TRUE'

En la instancia de VM de Compute Engine en la terminal abierta, ejecuta los siguientes comandos para llevar los requisitos de la app de ejemplo de Python a la instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Inicializa un entorno virtual y, luego, instala los requisitos para ejecutar la app de ejemplo.

   python3 -m venv env
   source env/bin/activate
   pip install -r requirements.txt
   

2. Ejecuta la app de ejemplo.

   python app.py
   

En tu computadora local, configura la redirección de puertos mediante SSH con las instrucciones del siguiente paso de la guía de inicio rápido. Esto te permite usar un navegador en tu computadora local para ver la aplicación que se ejecuta en tu instancia de VM de Compute Engine.

Nota: En este paso de la guía de inicio rápido, se requiere la CLI de gcloud, que proporciona acceso de línea de comandos a tus recursos de Google Cloud con los comandos gcloud CLI. Si no tienes la CLI de gcloud instalada en tu computadora local, instala la CLI de gcloud para continuar.

1. En una terminal o en PowerShell en tu computadora local, ejecuta el siguiente comando gcloud compute ssh para configurar la redirección de puertos a través de SSH. Antes de ejecutar el comando, reemplaza YOUR_PROJECT_ID por el ID del proyecto.

gcloud compute ssh quickstart-vm-instance --project=YOUR_PROJECT_ID --zone=us-central1-a --ssh-flag='-L 8000:127.0.0.1:8080'

2. Visualiza la app de ejemplo en ejecución. Con la redirección de puertos activa, abre un navegador en tu computadora local y, luego, ingresa http://127.0.0.1:8000 en la barra de direcciones de tu navegador.

   

Para detener la app de ejemplo, presiona Control+C en la terminal de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Instancia de Cloud SQL de IP privada y VM de Compute Engine basada en Windows

Crea y descarga un certificado de servidor SSL en tu computadora local

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.

Sube un certificado SSL al bucket de Cloud Storage

Console

En un navegador de tu computadora local, crea un bucket de Cloud Storage y sube el certificado SSL al bucket en el que se pueda acceder a este desde la instancia de VM de Compute Engine.

1. Crea depósitos de almacenamiento.
1. En Nombre de tu bucket, ingresa el siguiente nombre. Reemplaza YOUR_PROJECT_ID por el ID del proyecto.

   YOUR_PROJECT_ID-quickstart-certs

2. Haz clic en el botón Crear para crear el bucket.
2. Haz clic en el botón Subir archivos para subir archivos al bucket de Cloud Storage recién creado.
3. Selecciona el siguiente archivo para subirlo desde tu computadora local a Cloud Storage:
• server-ca.pem

gcloud

En tu computadora local, en una terminal o en una ventana de PowerShell abierta al directorio donde descargaste el certificado SSL, ahora puedes crear un bucket de Cloud Storage y subir el certificado SSL al bucket en el que se pueda acceder a este desde la instancia de VM de Compute Engine. La utilidad de línea de comandos de Cloud Storage gsutil, que se incluye con la CLI de gcloud, se usará para subir el archivo.

1. Ejecuta el siguiente comando gsutil mb para crear un nuevo bucket de Cloud Storage:

gsutil mb -l us-central1 gs://YOUR_PROJECT_ID-quickstart-certs

2. Desde el directorio en el que descargaste el certificado en tu computadora local, ejecuta el siguiente comando gsutil cp para copiar los certificados SSL en el bucket de Cloud Storage recién creado:

gsutil cp server-ca.pem gs://YOUR_PROJECT_ID-quickstart-certs/

Go

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una ventana de PowerShell abierta al directorio golang-samples/cloudsql/sqlserver/database-sql, ejecuta el siguiente comando gsutil cp para descargar el certificado SSL de Cloud Storage al directorio certs.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la ventana de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para obtener las dependencias de la app de ejemplo de Go en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

1. Obtén las dependencias necesarias para ejecutar la app de ejemplo.

   go get ./...
   

2. Ejecuta la app de ejemplo.

   go run cmd\app\main.go
   

3. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Java

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una ventana de PowerShell abierta al directorio java-docs-samples/cloud-sql/sqlserver/servlet/, ejecuta el siguiente comando gsutil cp para descargar el certificado SSL de Cloud Storage al directorio actual.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem .

Configura los certificados SSL para usarlos en Java en la instancia de VM de Compute Engine

En la terminal de la instancia de VM de Compute Engine, ejecuta el siguiente comando para importar el certificado de servidor a un almacén de confianza personalizado de Java con keytool. Antes de ejecutar el siguiente comando, reemplaza TRUST_CERT_KEYSTORE_PASSWD por tu propia contraseña de almacén de claves personalizada que se usará para crear el almacén de confianza de Java.

keytool -importcert -alias SQLServerCACert -file server-ca.pem `
-keystore quickstart-truststore -storepass TRUST_CERT_KEYSTORE_PASSWD

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la ventana de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.
• TRUST_CERT_KEYSTORE_PASSWD por la contraseña que especificaste para --storepass en el paso anterior.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:TRUST_CERT_KEYSTORE_PATH="quickstart-truststore"
$env:TRUST_CERT_KEYSTORE_PASSWD="TRUST_CERT_KEYSTORE_PASSWD"
$env:PRIVATE_IP="TRUE"

1. En la instancia de VM de Compute Engine, en la ventana abierta de PowerShell, ejecuta el siguiente comando para obtener las dependencias de la app de ejemplo de Java en tu instancia de VM de Compute Engine y ejecutar la app de ejemplo.

   mvn jetty:run
   

2. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

Python

Descarga un certificado SSL con gsutil en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine, en una ventana de PowerShell abierta al directorio python-docs-samples/cloud-sql/sql-server/sqlalchemy, ejecuta el siguiente comando gsutil cp para descargar el certificado SSL de Cloud Storage al directorio certs.

gsutil cp gs://YOUR_PROJECT_ID-quickstart-certs/server-ca.pem certs/.

Configura variables de entorno en la instancia de VM de Compute Engine

En la instancia de VM de Compute Engine en la ventana de PowerShell, ejecuta los siguientes comandos para inicializar las variables de entorno necesarias a fin de ejecutar la app de ejemplo. Antes de ejecutar los comandos, realiza los siguientes reemplazos:

• INSTANCE_HOST configurado como la dirección IP privada de tu instancia que se muestra en la página Instancias de Cloud SQL en la consola de Google Cloud.
Nota: Las conexiones a una instancia de Cloud SQL mediante una dirección IP privada se autorizan de forma automática para los rangos de direcciones RFC 1918. Para los rangos de direcciones que no son RFC 1918, consulta Obtén información sobre el uso de IP privadas.
• YOUR_DB_PASSWORD por la contraseña de la quickstart-user que creaste en el paso anterior de la guía de inicio rápido Crea un usuario.

$env:INSTANCE_HOST="INSTANCE_HOST"
$env:DB_PORT="1433"
$env:DB_NAME="quickstart_db"
$env:DB_USER="sqlserver"
$env:DB_PASS="YOUR_DB_PASSWORD"
$env:DB_ROOT_CERT="certs/server-ca.pem"
$env:PRIVATE_IP="TRUE"

En la instancia de VM de Compute Engine en la ventana abierta de PowerShell, ejecuta los siguientes comandos para implementar los requisitos de la app de ejemplo de Python en tu instancia de VM de Compute Engine y ejecutar la aplicación de ejemplo.

1. Inicializa un entorno virtual y, luego, instala los requisitos para ejecutar la app de ejemplo.

   virtualenv --python python3 env
   .\env\Scripts\activate
   pip install -r requirements.txt
   

2. Ejecuta la app de ejemplo.

   python app.py
   

3. Visualiza la app de ejemplo en ejecución. Abre un navegador en la instancia de VM de Compute Engine y ve a http://127.0.0.1:8080.

   

Para detener la app de ejemplo, presiona Control+C en la ventana de PowerShell de la instancia de VM de Compute Engine en la que iniciaste la app de ejemplo.

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.

Borra una instancia de Cloud SQL

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

   Ir a Instancias de Cloud SQL

2. Selecciona la instancia quickstart-instance para abrir la página de detalles de la instancia.
3. En la barra de íconos en la parte superior de la página, haz clic en Borrar.
4. En el cuadro de diálogo Borrar instancia, escribe quickstart-instance y, luego, haz clic en Borrar.

Borra una instancia de VM de Compute Engine

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

   Ir a Instancias de VM

2. Selecciona la instancia quickstart-vm-instance para abrir la página de detalles de la instancia.
3. En la barra de íconos en la parte superior de la página, haz clic en Borrar.
4. Haz clic en Borrar para borrar la instancia.

Pasos opcionales de limpieza

Si no usas el rol de cliente de Cloud SQL que asignaste a la cuenta de servicio Compute Engine default, puedes quitarlo.

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

   Ir a IAM

2. 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.
3. Borra la función cliente de Cloud SQL.
4. Haz clic en Guardar.

Si no usas la API que se habilitó como parte de esta guía de inicio rápido, puedes inhabilitarla.

• API que se habilitó en esta guía de inicio rápido:
  • API de Cloud SQL Admin

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

   Ir a las API

2. 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:

• Desde una aplicación que se ejecuta en el entorno estándar de App Engine
• Desde una aplicación que se ejecuta en Compute Engine
• Desde una aplicación que se ejecuta en GKE
• Desde Cloud Functions
• Desde Cloud Run