Conéctate a Cloud SQL para MySQL mediante el proxy de autenticación de Cloud SQL
En esta página, se muestra cómo conectarse a Cloud SQL desde un entorno de prueba local con el proxy de Cloud SQL Auth. El proxy de Cloud SQL Auth proporciona acceso seguro a tu instancia de Cloud SQL sin la necesidad de contar con redes autorizadas ni de configurar SSL. Mediante el proxy de Cloud SQL Aurh, puedes conectarte a tu instancia de Cloud SQL de forma segura.
Las instrucciones de esta página son solo para un entorno de pruebas y no deben usarse con entornos de producción. Para obtener más información sobre la configuración requerida para los entornos de producción, consulta Usa el proxy de autenticación de Cloud SQL en un entorno de producción y Conectarse con el proxy de autenticación de Cloud SQL.
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 APIs de Google Cloud necesarias.
Console
En la consola de Google Cloud, ve a la página API.
Habilita la API de Cloud SQL Admingcloud
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 comando
gcloud services enable
de la siguiente manera con Cloud Shell a fin de habilitar las API necesarias para esta guía de inicio rápido:gcloud services enable sqladmin.googleapis.com
Este comando habilita las siguientes API:
- API de Cloud SQL Admin
Cree una instancia de Cloud SQL
En esta guía de inicio rápido, usas la consola de Google Cloud. Para usar gcloud CLI, cURL o PowerShell, consulta la documentación sobre cómo crear instancias.
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Haga clic en Crear instancia.
- Haga clic en Choose MySQL.
- Ingresa
myinstance
en ID de la instancia. - Ingresa una contraseña para el usuario
root
. Haga clic en Crear.
Volverás a la lista de las instancias. Puedes hacer clic en la instancia nueva de inmediato para ver los detalles, pero no estará disponible para otras operaciones hasta que se inicialice y se inicie.
- Descarga el servidor de la comunidad de MySQL para tu plataforma desde la página de descarga del servidor de la comunidad de MySQL.
El servidor de la comunidad incluye el cliente MySQL. - Instala el servidor de la comunidad con las instrucciones que se muestran en la página de descargas.
Para obtener más información sobre cómo instalar MySQL, consulta la sección sobre cómo instalar y actualizar MySQL.
Instala el cliente del proxy de autenticación de Cloud SQL
El objeto binario del proxy de autenticación de Cloud SQL que descargues depende de tu sistema operativo y de si este usa un kernel de 32 bits o de 64 bits.
La mayoría del hardware más nuevo usa un kernel de 64 bits. Si no estás seguro de si tu máquina
ejecuta un kernel de 32 bits o de 64 bits, usa el comando uname -a
para Linux o macOS. Para Windows, consulta la
documentación de Windows.
Linux de 64 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.linux.amd64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Linux de 32 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.linux.386
- Si no se encuentra el comando
curl
, ejecutasudo apt install curl
y repite el comando de descarga. - Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
macOS de 64 bits
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.darwin.amd64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Mac M1
- Descarga el proxy de autenticación de Cloud SQL:
curl -o cloud-sql-proxy https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.darwin.arm64
- Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
chmod +x cloud-sql-proxy
Windows de 64 bits
Haz clic con el botón derecho en https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.x64.exe y selecciona Guardar vínculo como para descargar el proxy de autenticación de Cloud SQL. Cambia el nombre del archivo porcloud-sql-proxy.exe
.
Windows de 32 bits
Haz clic con el botón derecho en https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.11.2/cloud-sql-proxy.x86.exe y selecciona Guardar vínculo como para descargar el proxy de autenticación de Cloud SQL. Cambia el nombre del archivo porcloud-sql-proxy.exe
.
Imagen de Docker del proxy de Cloud SQL
El proxy de autenticación de Cloud SQL tiene diferentes imágenes de contenedor, como distroless
, alpine
y buster
. La imagen de contenedor del proxy de autenticación de Cloud SQL predeterminada usa
distroless
, que
no contiene shell. Si necesitas una shell o herramientas relacionadas, descarga una imagen basada en
alpine
o buster
.
Para obtener más información, consulta
Imágenes de contenedor del proxy de autenticación de Cloud SQL.
Puedes extraer la última imagen a tu máquina local con Docker a través del siguiente comando:
docker pull gcr.io/cloud-sql-connectors/cloud-sql-proxy:2.11.2
Otro SO
Para otros sistemas operativos que no se incluyen aquí, puedes compilar el proxy de autenticación de Cloud SQL desde la fuente.Obtén el nombre de conexión de la instancia
-
En la consola de Google Cloud, ve a la página Instancias de Cloud SQL.
- Haz clic en el nombre de la instancia para abrir la página Descripción general de esa instancia.
- En la sección Conéctate a esta instancia, copia el Nombre de la conexión. El nombre de la conexión tiene el formato
projectID:region:instanceID
.
Inicia el proxy de Cloud SQL Auth
Inicia el proxy de Cloud SQL Auth en su propia terminal para poder supervisar el resultado. Reemplaza INSTANCE_CONNECTION_NAME
por el nombre de la conexión de instancia que copiaste en el paso anterior.
En entornos de Linux, usa este comando para iniciar el proxy de Cloud SQL Auth:
./cloud-sql-proxy INSTANCE_CONNECTION_NAME
En PowerShell de Windows, usa este comando para iniciar el proxy de Cloud SQL Auth:
.\cloud-sql-proxy.exe INSTANCE_CONNECTION_NAME
Aparecerá un mensaje similar al que figura a continuación:
Listening on 127.0.0.1:3306 for INSTANCE_CONNECTION_NAME Ready for new connections
Ejecuta el siguiente comando:
mysql -u root -p --host 127.0.0.1 --port 3306
Cuando se te solicite Enter password:
, ingresa la contraseña de tu cuenta de usuario raíz de MySQL.
Verifica que aparezca el mensaje de MySQL. Te conectaste a tu base de datos con el cliente MySQL.
Regresa a la ventana de terminal en la que iniciaste el proxy de autenticación de Cloud SQL. Deberías ver un mensaje similar al siguiente:
New connection for myInstance
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
myinstance
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 la ventana Borrar instancia, escribe el nombre de tu instancia y, luego, haz clic en Borrar.
Pasos opcionales de limpieza
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 Cloud SQL Admin
En la consola de Google Cloud, ve a la página API.
Selecciona la API de Cloud SQL Admin y, luego, haz clic en el botón Inhabilitar API.
¿Qué sigue?
Consulta cómo solucionar problemas de información para el proxy de Cloud SQL Auth.
Obtén más información sobre el proxy de autenticación de Cloud SQL.
- Obtén más información sobre otras opciones de conexión.