Conéctate a Cloud SQL para MySQL desde Compute Engine
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 MySQL 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
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Asegúrate de que la facturación esté habilitada para tu proyecto de Google Cloud.
-
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.
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
Crea una base de datos
Console
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Selecciona
quickstart-instance
. - Abre la pestaña Bases de datos.
- Haga clic en Crear base de datos.
- En el cuadro de diálogo Crear una base de datos, ingresa
quickstart_db
como nombre de la base de datos y, de forma opcional, el grupo de caracteres y la intercalación. - 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
Crea un usuario
Console
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Para abrir la página de Descripción general de una instancia, haz clic en su nombre.
- Selecciona Usuarios en el menú de navegación de SQL.
- Haz clic en Agregar cuenta de usuario.
- En la página Agrega una cuenta de usuario a la instancia instance_name, agrega la siguiente información:
- Nombre de usuario: Configurado como
quickstart-user
- Contraseña: especifica una contraseña para tu usuario de la base de datos. Toma nota de esto para usarlo en un paso posterior de esta guía de inicio rápido.
- En la sección Nombre de host, el valor predeterminado es Permitir cualquier host, lo que significa que el usuario puede conectarse desde cualquier dirección IP.
De manera opcional, selecciona Restringir host por dirección IP o rango de direcciones y, luego, ingresa una dirección IP o un rango de direcciones en la sección Host. Luego, el usuario solo podrá conectarse desde la dirección IP o las direcciones especificadas.
- Nombre de usuario: Configurado como
- Haz clic en Agregar.
gcloud
Antes de ejecutar el siguiente comando, realiza los siguientes reemplazos:
- PASSWORD por una contraseña para el usuario de tu base de datos. Toma nota de esto para usarlo en un paso posterior de esta guía de inicio rápido.
Ejecuta el comando gcloud sql users create
para crear el usuario.
gcloud sql users create quickstart-user --instance=quickstart-instance --password=PASSWORD
Los límites de longitud de los nombres de usuario son los mismos para Cloud SQL que para MySQL local: 32 caracteres en MySQL 8.0 y 16 caracteres en las versiones anteriores.
Configura una cuenta de servicio de Compute Engine
Console
Crea una cuenta de servicio
- En la consola de Google Cloud, ve a la página Crear cuenta de servicio.
- Selecciona un proyecto de Google Cloud.
- Ingresa
quickstart-service-account
como el nombre de la cuenta de servicio. - Opcional: Ingresa una descripción de la cuenta de servicio.
- Haz clic en Crear y continuar y continúa con el paso siguiente.
- Elige el rol Cliente de Cloud SQL para otorgárselo a la cuenta de servicio en el proyecto.
- Haz clic en Agregar otro rol y elige el rol Visualizador de objetos de almacenamiento para otorgar a la cuenta de servicio del proyecto.
- Haga clic en Continuar.
- Haz clic en Listo para terminar de crear la cuenta de servicio.
gcloud
Crea una cuenta de servicio
- Para crear la cuenta de servicio, ejecuta el comando
gcloud iam service-accounts create
: DESCRIPTION
: una descripción opcional de la cuenta de servicio- 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"
gcloud iam service-accounts create quickstart-service-account --description="DESCRIPTION" --display-name="quickstart-service-account"
Reemplaza el siguiente valor:
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
Accede a una instancia de VM 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.
Instalar Git
Instala Git, un sistema de control de versiones de código abierto, en tu instancia de VM de Compute Engine.
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.
-
Clona la app de ejemplo
git clone https://github.com/GoogleCloudPlatform/golang-samples
-
Cambia el directorio al que contiene la app de ejemplo.
cd golang-samples/cloudsql/mysql/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.
-
Clona la app de ejemplo
git clone https://github.com/GoogleCloudPlatform/java-docs-samples
-
Cambia el directorio al que contiene la app de ejemplo.
cd java-docs-samples/cloud-sql/mysql/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.
-
Clona la app de ejemplo
git clone https://github.com/GoogleCloudPlatform/nodejs-docs-samples
-
Cambia el directorio al que contiene la app de ejemplo.
cd nodejs-docs-samples/cloud-sql/mysql/mysql
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.
-
Clona la app de ejemplo
git clone https://github.com/GoogleCloudPlatform/python-docs-samples
-
Cambia el directorio al que contiene la app de ejemplo.
cd python-docs-samples/cloud-sql/mysql/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.
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.
Borra una instancia de Cloud SQL
-
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.
Borra una instancia de VM de Compute Engine
-
En la consola de Google Cloud, ve a la página Instancias de VM.
- Selecciona la instancia
quickstart-vm-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.
- 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.
-
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 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
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 obtener información sobre cómo crear usuarios de MySQL y bases de datos para tu instancia de Cloud SQL.
Si deseas obtener más información sobre los precios, consulta Precios de Cloud SQL para MySQL.
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: