Guía de inicio rápido para usar el proxy de Cloud SQL Auth

En esta página, se muestra cómo conectarse a Cloud SQL desde un entorno de prueba local con el proxy de autenticación de Cloud SQL. El proxy de autenticación de Cloud SQL 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 autenticación de Cloud SQL, puedes conectarte a tu instancia de Cloud SQL de forma segura.

No uses estas instrucciones para configurar el proxy de autenticación de Cloud SQL en un entorno de producción. Además, si deseas ver más opciones de conexión para autenticar y usar el proxy, consulta Conéctate mediante el proxy de autenticación de Cloud SQL.

Configure su proyecto

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

  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 Google Cloud Console, selecciona o crea un proyecto de Google Cloud.

    Ir al selector de proyectos

  3. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

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

    Ir al selector de proyectos

  5. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Descubre cómo confirmar que tienes habilitada la facturación en un proyecto.

  6. Asegúrate de tener la función de cliente de Cloud SQL en tu cuenta de usuario.

    Ir a la página IAM

  7. Habilita la API Cloud SQL Admin.

    Habilita la API

Cree una instancia de Cloud SQL

En este procedimiento, usas Google Cloud Console. Para usar la herramienta de línea de comandos de gcloud, cURL o PowerShell, consulta Crea instancias.

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

    Ir a Instancias de Cloud SQL

  2. Haz clic en Crear instancia.
  3. Haz clic en MySQL.
  4. Si se te solicita que habilites la API de Compute, haz clic en el botón Habilitar API.
  5. Ingresa myinstance en ID de la instancia.
  6. Ingresa una contraseña para el usuario raíz.
  7. Usa los valores predeterminados en los otros campos.
  8. Haz clic en Crear (Create).

    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 hasta que se inicialice.

    Nota: En este ejemplo, la instancia se crea con la configuración predeterminada, incluida una dirección IP pública.

Instala un cliente mysql.

  1. 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.
  2. 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 name -a para Linux o macOS. Para Windows, consulta la documentación de Windows.

Linux de 64 bits

  1. Descarga el proxy de autenticación de Cloud SQL:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
    
  2. Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
    chmod +x cloud_sql_proxy
    

Linux de 32 bits

  1. Descarga el proxy de autenticación de Cloud SQL:
    wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.386 -O cloud_sql_proxy
    
  2. Si no se encuentra el comando wget, ejecuta sudo apt-get install wget y repite el comando de descarga.
  3. Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
    chmod +x cloud_sql_proxy
    

macOS de 64 bits

  1. Descarga el proxy de autenticación de Cloud SQL:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.amd64
    
  2. Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
    chmod +x cloud_sql_proxy
    

macOS de 32 bits

  1. Descarga el proxy de autenticación de Cloud SQL:
    curl -o cloud_sql_proxy https://dl.google.com/cloudsql/cloud_sql_proxy.darwin.386
    
  2. Haz que el proxy de autenticación de Cloud SQL sea ejecutable:
    chmod +x cloud_sql_proxy
    

Windows de 64 bits

Para descargar el proxy de autenticación de Cloud SQL, 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 de autenticación de Cloud SQL, 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.

Imagen de Docker del proxy de Cloud SQL Auth

Para mayor comodidad, varias imágenes de contenedor que contienen el proxy de autenticación de Cloud SQL están disponibles en GitHub en el repositorio del proxy de autenticación de Cloud SQL. Puedes extraer la última imagen a tu máquina local usando Docker mediante el siguiente comando:
docker pull gcr.io/cloudsql-docker/gce-proxy:1.19.1

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

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

    Ir a Instancias de Cloud SQL

  2. Haz clic en el nombre de la instancia para abrir la página Descripción general de esa instancia.
  3. 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 autenticación de Cloud SQL 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 autenticación de Cloud SQL:

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306

En PowerShell de Windows, usa este comando para iniciar el proxy de autenticación de Cloud SQL:

.\cloud_sql_proxy.exe -instances=INSTANCE_CONNECTION_NAME=tcp:3306

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 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

Limpieza

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

    Ir a Instancias de Cloud SQL

  2. Selecciona el nombre de tu instancia para abrir la página Descripción general.
  3. En la barra de íconos ubicada en la parte superior de la página, haz clic en borrar.
  4. En la ventana Borrar instancia, escribe el nombre de tu instancia y, luego, haz clic en Borrar para borrarla.

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

¿Qué sigue?