Guía de inicio rápido del uso del proxy para realizar pruebas locales

En esta página, se muestra cómo conectarse a Cloud SQL desde un entorno de prueba local con el proxy de Cloud SQL. La conexión con el proxy permite probar una aplicación de App Engine en tu entorno local o establecer una conexión segura para administrar bases de datos.

No uses estas instrucciones para configurar el proxy en un entorno de producción. Si deseas ver más opciones de conexión, consulta Opciones de conexión para aplicaciones externas.

Antes de comenzar

Antes de realizar los pasos de esta guía de inicio rápido, completa las siguientes tareas:

  • Crea un proyecto de Google Cloud y una instancia de Cloud SQL.
  • Si usas un proyecto preexistente, asegúrate de que tu usuario de Google Cloud sea propietario del proyecto o tenga una función de Cloud SQL que no sea Cloud SQL Viewer. De lo contrario, configura el proxy según las instrucciones descritas en la página Conecta un cliente psql mediante el proxy de Cloud SQL.
  • De manera opcional, instala el cliente mysql.

    El cliente permite probar tu conexión a la instancia. El cliente mysql se puede instalar con el paquete del servidor. Algunos sistemas operativos son compatibles con un paquete solo para clientes. Consulta las instrucciones de instalación de MySQL.

Habilita la API de Administrador de Cloud SQL

Habilita la API

Instala y autentica la herramienta de línea de comandos de gcloud

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

    Consulta las instrucciones de instalación de gcloud.

  2. Inicializa la herramienta de gcloud:

    gcloud init
    
  3. Autentica la herramienta de gcloud:

    gcloud auth login
    

Instala el cliente del proxy de Cloud SQL en tu máquina local

El binario del proxy 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 que tu máquina ejecuta un kernel de 64 bits, usa el comando uname -a para Linux o macOS, o haz clic en Equipo > Propiedades en el menú Inicio de Windows.

Linux de 64 bits

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

Linux de 32 bits

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

macOS de 64 bits

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

macOS de 32 bits

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

Windows de 64 bits

Para descargar el proxy, haz clic con el botón derecho en https://dl.google.com/cloudsql/cloud_sql_proxy_x64.exe y selecciona Guardar vínculo como. Cambia el nombre del archivo por cloud_sql_proxy.exe.

Windows de 32 bits

Para descargar el proxy, haz clic derecho en https://dl.google.com/cloudsql/cloud_sql_proxy_x86.exe y selecciona Guardar vínculo como. Cambia el nombre del archivo por cloud_sql_proxy.exe.
Si no se incluye aquí tu sistema operativo, también puedes compilar el proxy desde la fuente.

Obtén el nombre de conexión de la instancia

  1. Ve a la página Instancias de Cloud SQL en Google Cloud Console.

    Ir a la página Instancias de Cloud SQL

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

  3. En Conectar a esta instancia, busca y anota el Nombre de conexión de la instancia.

Inicia el proxy

Inicia el proxy en su propia terminal para poder supervisar su resultado. Reemplaza <INSTANCE_CONNECTION_NAME> por el nombre de la conexión de instancia que copiaste en el paso anterior.

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

Aparecerá un mensaje similar al que figura a continuación:

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

Conéctate a tu base de datos con el cliente MySQL

Llevar a cabo lo que se aborda en esta sección es opcional, pero se recomienda para probar la conexión. Ver las instrucciones de instalación de MySQL.

En una ventana de terminal diferente desde donde iniciaste el proxy, ejecuta el siguiente comando y reemplaza <USERNAME> con tu nombre de usuario de MySQL.

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

Aparecerá el cuadro de MySQL y aparecerá un mensaje similar al siguiente en la terminal del proxy:

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

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta guía de inicio rápido.

  1. Ve a la página Instancias de Cloud SQL en Google Cloud Console.
    Ir a la página Instancias de Cloud SQL
  2. Selecciona la instancia myinstance para abrir la página de detalles de la instancia.
  3. En la barra de íconos que se encuentra en la parte superior de la página, haz clic en Borrar.
  4. En la ventana Borrar instancia, ingresa myinstance y, luego, haz clic en Borrar para eliminar la instancia.

    No puedes usar de nuevo el nombre de una instancia durante alrededor de 7 días después de haberla borrado.

¿Qué sigue?