Guía de inicio rápido de Cloud SQL con IP privadas

MySQL   |  PostgreSQL   |  SQL Server

En esta página, se muestra cómo crear una instancia de MySQL y conectarse a ella mediante una IP privada. Los recursos creados en esta guía de inicio rápido suelen costar menos de un dólar, bajo la suposición de que completas los pasos, incluida la limpieza, de manera correcta.

Configure su proyecto

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

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

5. Make sure that billing is enabled for your Google Cloud project.

6. Asegúrate de tener la función de administrador de Cloud SQL en tu cuenta de usuario.
   1. Ve a la página IAM.
      Ir a la página IAM
   2. Haga clic en Agregar.
   3. En Nuevas principales, agrega el nombre de tu cuenta de usuario.
   4. En Selecciona una función, filtra por Administrador de Cloud SQL y selecciónalo de la lista.
   5. Haz clic en Guardar.

7. Habilita la API de Administrador de Cloud SQL y la API de Compute Engine.
   Habilita las API

Descripción general

Hay muchas formas de conectarte a una instancia de Cloud SQL con una dirección IP privada según la ubicación de la fuente. El factor clave es que la máquina de origen debe estar en la misma red de VPC que la instancia de Cloud SQL. Si la fuente no está en Google Cloud ni en el mismo proyecto de Google Cloud, debes configurar la conectividad de manera diferente a la que se muestra aquí.

En esta guía de inicio rápido, configuraremos la conectividad a través de la ruta más directa. La fuente y el destino están en el mismo proyecto de Google Cloud y en la misma red de VPC. Creamos una instancia de Cloud SQL con una dirección IP privada (el destino) y una VM de Compute Engine (el origen). Usamos la VM para instalar las herramientas necesarias para conectarnos desde la VM hasta la instancia de Cloud SQL.

Realiza las siguientes acciones:

1. Crear una base de datos de Cloud SQL con una dirección IP privada.

   Busca y guarda el connection name de la instancia para un uso posterior.

2. Crea una VM de Compute Engine.
3. Abrir dos ventanas de SSH en la VM.

   Usarás la primera ventana para instalar psql además de instalar y, luego, iniciar el proxy de autenticación de Cloud SQL. Luego, usarás la segunda ventana para conectarte a la instancia de Cloud SQL mediante la conexión al proxy de autenticación de Cloud SQL.

4. Instala un cliente mysql en la ventana de SSH n.° 1.
5. Instala el proxy de autenticación de Cloud SQL en la ventana de SSH n.° 1.

   El proxy de autenticación de Cloud SQL actúa como un conector entre el cliente mysql y la instancia de Cloud SQL.

6. Inicia el proxy de autenticación de Cloud SQL en la ventana de SSH n.° 1.

   Si se ejecuta de forma correcta, el proxy de autenticación de Cloud SQL escucha las solicitudes de conexión.

7. En la ventana SSH n.° 2, conéctate a la instancia de Cloud SQL mediante la conexión del cliente mysql al proxy de autenticación de Cloud SQL.

   Si se ejecuta de forma correcta, verás el mensaje de mysql en esta ventana y un mensaje de conexión correcta en la ventana de SSH n.° 1, en la que se ejecuta el proxy de autenticación de Cloud SQL.

8. Realiza una limpieza.

   Borra la instancia de Cloud SQL y la VM de Compute Engine.

Crea una instancia de Cloud SQL con una dirección IP privada

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

   Ir a Instancias de Cloud SQL

2. Haga clic en Crear instancia.
3. Haga clic en Elegir MySQL.
4. Si se te solicita que habilites la API de Compute, haz clic en el botón Habilitar API.
5. En la sección Información de la instancia, ingresa un nombre para el ID de instancia.
6. Ingrese una contraseña para el usuario raíz. Toma nota de la contraseña que crees, ya que la necesitarás más tarde.
7. En la sección Elige la región y la disponibilidad zonal, selecciona la opción Zona única.
8. Expanda Mostrar opciones de configuración.
9. Expande Conexiones.
10. Borra la IP pública.
11. Seleccione IP privada.
12. En el menú desplegable Red, selecciona la configuración predeterminada.
13. Si usas un proyecto nuevo, el mensaje te pedirá lo siguiente: Se requiere una conexión privada a servicio. Luego, sigue estos pasos:
1. Haz clic en Configurar conexión.
2. Haz clic en Habilitar API de Service Networking.
3. En la sección Asigna un rango de IP, selecciona Usar un rango de IP asignado de manera automática.
4. Haga clic en Continuar.
5. Haz clic en Crear conexión y espera a que se complete la creación de la conexión.

14. Haga clic en Crear instancia.

Se te redireccionará a la página Descripción general de la instancia. Haz clic en la instancia nueva para ver los detalles, incluida su dirección IP privada.

En la sección Conéctate a esta instancia, copia y guarda el Nombre de la conexión de la instancia. connection name tiene el formato projectID:region:instanceID.

Usarás este connection name más adelante cuando inicies el proxy de autenticación de Cloud SQL.

Crea una VM de Compute Engine

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

   Ir a Instancias de VM

2. Haga clic en Crear instancia.
3. Ingresa un Nombre para la instancia.
4. En Permiso de acceso, selecciona Permitir el acceso total a todas las API de Cloud.
5. Haz clic en Crear y espera a que se termine de crear la VM.

Abre dos conexiones SSH a la VM de Compute Engine

Usamos dos ventanas en la VM. La primera ventana se usa para instalar el cliente mysql y el proxy de autenticación de Cloud SQL, obtener el nombre de la conexión de la instancia y usar el nombre para iniciar el proxy. La segunda ventana se usa para conectarse a la instancia de Cloud SQL a través del proxy.

1. Expande el menú SSH en la columna Conectar para la instancia de VM de Compute Engine.
2. Selecciona Abrir en otra ventana del navegador para abrir la ventana SSH 1.

   Es posible que el mensaje tarde unos segundos en estar disponible en la ventana.

3. Cuando aparezca el mensaje, ingresa pwd para verificar que estés en el directorio /home/$USER.

   Instalarás el cliente mysql y el proxy de autenticación de Cloud SQL y, luego, iniciarás el proxy de autenticación de Cloud SQL, en esta ventana.

4. Vuelve a seleccionar Abrir en otra ventana del navegador para abrir la ventana SSH 2.

   Usarás esta ventana para conectarte a tu instancia de Cloud SQL.

Instala el cliente MySQL

Usa la ventana SSH n.° 1 para este paso.

Instala el cliente MySQL desde el administrador de paquetes y detén el servidor mysqld:

sudo apt-get update
sudo apt-get install mariadb-server-10.3
sudo service mysqld stop
  

Instala el proxy de autenticación de Cloud SQL

Usa la ventana SSH n.° 1 para este paso.

1. Instala wget:

   sudo apt-get install wget
       

2. Descarga el proxy de autenticación de Cloud SQL:

   wget https://dl.google.com/cloudsql/cloud_sql_proxy.linux.amd64 -O cloud_sql_proxy
     

3. Haz que el proxy de autenticación de Cloud SQL sea ejecutable:

   chmod +x cloud_sql_proxy
     

Inicia el proxy de Cloud SQL Auth

Usa la ventana SSH n.° 1 para este paso.

Inicia el proxy de autenticación de Cloud SQL para que puedas supervisar el resultado. Reemplaza INSTANCE_CONNECTION_NAME por el connection name que copiaste cuando creaste la instancia de Cloud SQL.

./cloud_sql_proxy -instances=INSTANCE_CONNECTION_NAME=tcp:3306

Nota: Si ves un error que indica que la dirección ya está en uso, significa que una instancia local de la base de datos se está ejecutando y debes detenerla. Encuentra el SERVICE_NAME mediante la ejecución del comando ps -ef | grep mysql y, luego, ejecuta el siguiente comando:

sudo service SERVICE_NAME stop
  

Cuando el proxy de autenticación de Cloud SQL se inicia de forma correcta, aparece un mensaje similar al siguiente en la ventana de SSH:

Listening on 127.0.0.1:3306 for myInstance
Ready for new connections

Conéctate a tu instancia de Cloud SQL

Usa la ventana SSH 2 para este paso.

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

Limpia

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.

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

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

   Ir a Instancias de VM

2. Selecciona el nombre de tu instancia.
3. Selecciona Borrar en el menú Más acciones.

¿Qué sigue?

En función de tus necesidades, puedes obtener más información sobre cómo 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.

Además, puedes obtener información sobre la conexión a una instancia de Cloud SQL desde otras aplicaciones de Google Cloud:

• Desde una aplicación que se ejecuta en el entorno estándar de App Engine
• Desde una aplicación que se ejecuta en GKE
• Desde Cloud Functions
• Desde Cloud Run