Conéctate a una instancia de Cloud SQL para PostgreSQL con IP privada

Conéctate a una instancia de Cloud SQL para PostgreSQL con IP privada

MySQL   |  PostgreSQL   |  SQL Server

En esta página se muestra cómo crear y conectarse a una instancia de PostgreSQL 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.

---

Para seguir la guía paso a paso en esta tarea directamente en la consola de Google Cloud, haz clic en Guía:

GUIARME

---

Antes de comenzar

Nota: El nombre que uses para el proyecto debe tener entre 4 y 30 caracteres. Cuando escribes el nombre, el formulario sugiere un ID del proyecto que puedes editar. El ID del proyecto debe tener entre 6 y 30 caracteres y debe comenzar con una letra minúscula. Puedes usar un guion, una letra minúscula o un número para los caracteres restantes, pero el último carácter no puede ser un guion.

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. Habilita las APIs de Google Cloud necesarias.

   Console

   En la consola de Google Cloud, ve a la página API.

   Ir a las API

   Habilita la API de Cloud SQL Admin Cuando habilitas esta API, puedes ejecutar el proxy de Cloud SQL Auth.

   gcloud

   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.

   Abra Cloud Shell

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

   • API de Cloud SQL Admin Cuando habilitas esta API, puedes ejecutar el proxy de Cloud SQL Auth.

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. Abre dos conexiones SSH a la VM de Compute Engine

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

4. En la ventana de SSH 1, haz lo siguiente:
   1. Instala el cliente psql.
   2. Instala el proxy de Cloud SQL Auth.

      El proxy de Cloud SQL Auth actúa como un conector entre el cliente psql y la instancia de Cloud SQL.

   3. Inicia el proxy de Cloud SQL Auth.

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

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

   Si se ejecuta de forma correcta, verás el mensaje de psql 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 Cloud SQL Auth.

6. Realiza una limpieza.

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

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

   Ir a Instancias de Cloud SQL

2. Haga clic en Crear instancia.
3. Haz clic en Elegir PostgreSQL.
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. Ingresa una contraseña para el usuario de postgres. 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 automáticamente.
4. Haz 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 Cloud SQL Auth.

Crea una base de datos

Regresa a la página Descripción general de la instancia y selecciona el elemento de menú Bases de datos.

• Selecciona Crear base de datos.
• Ingresa un DB_NAME en el campo Nombre de la base de datos.
• Haz clic en Crear.

Usarás este db_name más adelante cuando te conectes mediante el proxy de Cloud SQL Auth.

Crea una VM de Compute Engine

1. En la consola de Google Cloud, 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 psql y el proxy de Cloud SQL Auth, 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 psql y el proxy de Cloud SQL Auth y, luego, iniciarás el proxy de Cloud SQL Auth, 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.

Instalar el cliente psql

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

Instala el cliente psql desde el administrador de paquetes:

sudo apt-get update
sudo apt-get install postgresql-client
  

Instala el proxy de Cloud SQL Auth

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

1. Instala wget:

   sudo apt-get install wget
       

2. Descarga el proxy de Cloud SQL Auth:

   wget https://storage.googleapis.com/cloud-sql-connectors/cloud-sql-proxy/v2.8.2/cloud-sql-proxy.linux.amd64 \
   -O cloud-sql-proxy
     

3. Haz que el proxy de Cloud SQL Auth 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 Cloud SQL Auth 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 --private-ip INSTANCE_CONNECTION_NAME

Nota: De forma predeterminada, el proxy de Cloud SQL Auth intenta conectarse a tu instancia de Cloud SQL mediante una dirección IPv4 pública. Si la instancia tiene solo una IP privada, o si la instancia tiene configuradas una IP pública y una IP privada, y quieres que el proxy de Cloud SQL Auth use la dirección IP privada, debes proporcionar la opción --private-ip cuando inicias el proxy de Cloud SQL Auth.

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 psql y, luego, ejecuta el siguiente comando:

sudo service SERVICE_NAME stop
  

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

Listening on 127.0.0.1:5432 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 después de reemplazar DB_NAME por el nombre de la base de datos de Cloud SQL:

psql "host=127.0.0.1 port=5432 sslmode=disable dbname=DB_NAME user=postgres"

En el cuadro de contraseña Intro: ingresa la contraseña de tu cuenta de PostgreSQL.

Verifica que aparezca el cuadro de PostgreSQL. Te conectaste a tu base de datos con el cliente psql.

Regresa a la ventana de terminal en la que iniciaste el proxy de Cloud SQL Auth. Deberías ver un mensaje similar al siguiente:

New connection for myInstance

Limpia

Sigue estos pasos para evitar que se apliquen cargos a tu cuenta de Google Cloud por los recursos que usaste en esta página.

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

   Ir a 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 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.

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

1. En la consola de Google Cloud, ve a la página API.

   Ir a las API

2. Selecciona la API de Administrador de Cloud SQL y, luego, haz clic en el botón Inhabilitar API.

3. En la consola de Google Cloud, ve a la página Instancias de VM.

   Ir a Instancias de VM

4. Selecciona el nombre de tu instancia.

5. Selecciona Borrar en el menú Más acciones.

¿Qué sigue?

En función de tus necesidades, puedes obtener más información para crear instancias de Cloud SQL.

También puedes obtener información sobre cómo crear usuarios de PostgreSQL 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 funciones de Cloud Run
• Desde Cloud Run