Inicio rápido para usar el proxy para pruebas locales

En esta página se explica cómo conectarse a Cloud SQL desde un entorno de prueba local mediante Cloud SQL Proxy. La conexión a través del proxy te permite probar una aplicación de App Engine en el entorno local o establecer una conexión segura para administrar la base de datos.

No uses estas instrucciones con el fin de configurar el proxy para un entorno de producción. Para obtener más opciones de conexión, consulta el apartado sobre opciones de conexión para aplicaciones externas.

Antes de empezar

Antes de realizar los pasos de este inicio rápido, debes completar las siguientes tareas:

  • Crea un proyecto de GCP y una instancia de segunda generación.
  • Si estás usando un proyecto ya existente, asegúrate de que el usuario de GCP sea el propietario del proyecto o de que tenga la función de Cloud SQL Client. De lo contrario, debes configurar el proxy usando las instrucciones que se describen en el apartado sobre conexión mediante Cloud SQL Proxy.
  • Instala el cliente mysql (opcional).

    El cliente te permite probar la conexión a la instancia. El cliente mysql está instalado con el paquete del servidor. Algunos sistemas operativos admiten un paquete solo para el cliente. Más información.

Habilitar la API Cloud SQL

Habilita la API Cloud SQL Admin.

Habilita la API

Instalar y autenticar la herramienta de línea de comandos gcloud

  1. Si aún no lo has hecho, instala la herramienta de línea de comandos gcloud.

    Para obtener más información, consulta la documentación de Cloud SDK.

    No necesitas ningún componente adicional, pero asegúrate de ejecutar gcloud init para inicializar la herramienta gcloud.

  2. Autentica la herramienta de línea de comandos gcloud:

    gcloud auth login
    

Instalar el cliente Cloud SQL Proxy en la máquina local

El binario proxy que descargues dependerá del sistema operativo y de si usas un kernel de 32 bits o de 64 bits. El hardware más reciente suele usar un kernel de 64 bits. Si no estás seguro de si la máquina está ejecutando un kernel de 64 bits, usa el comando uname -a en Linux o macOS, o haga clic en Equipo > Propiedades en el menú Inicio en Windows.

Linux de 64 bits

  1. Descarga el proxy:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Haz el proxy ejecutable:
    chmod +x cloud_sql_proxy
    

Linux de 32 bits

  1. Descarga el proxy:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Haz el proxy ejecutable:
    chmod +x cloud_sql_proxy
    

macOS de 64 bits

  1. Descarga el proxy:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. Haz el proxy ejecutable:
    chmod +x cloud_sql_proxy
    

macOS de 32 bits

  1. Descarga el proxy:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Haz el proxy ejecutable:
    chmod +x cloud_sql_proxy
    

Windows de 64 bits

Haz clic con el botón derecho en https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe y selecciona "Guardar vínculo como..." para descargar el proxy con el nombre nuevo cloud_sql_proxy.exe.

Windows de 32 bits

Haz clic con el botón derecho en https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe y selecciona "Guardar vínculo como..." para descargar el proxy con el nombre nuevo cloud_sql_proxy.exe.
Si el sistema operativo no se incluye aquí, también puedes compilar el proxy desde la fuente.

Obtener el nombre de conexión de instancia

  1. Ve a la página de instancias de Cloud SQL de la consola de Google Cloud Platform.

    Ir a la página de instancias de Cloud SQL

  2. Haz clic en el nombre de la instancia para abrir la página de detalles de instancia.

  3. En el apartado para conectarse a esta instancia, puedes copiar el nombre de conexión de instancia.

    Usa este valor en el siguiente paso.

Iniciar el proxy

Inicia el proxy en su propia terminal para que puedas supervisar su salida. Sustituye <INSTANCE_CONNECTION_NAME> por el nombre de conexión de instancia que has copiado en el paso anterior.

 ./cloud_sql_proxy -instances=<INSTANCE_CONNECTION_NAME>=tcp:3306

Deberías ver un mensaje similar a este:

Listening on 127.0.0.1:3306 for myproject:us-central1:myinstance".
Ready for new connections

Conectarse a la base de datos mediante el cliente psql

Este paso es opcional, pero se recomienda realizarlo para poder probar la conexión.

Ejecuta el siguiente comando, sustituyendo <USERNAME> por tu nombre de usuario de MySQL.

  mysql -u <USERNAME> -p --host 127.0.0.1

Deberías ver el indicador mysql y debe aparecer un mensaje similar al siguiente ejemplo en el terminal proxy:

New connection for "myproject:us-central1:myinstance"

Siguientes pasos