Conectar un cliente psql a una instancia

En esta página se describe cómo conectar la herramienta de cliente psql a una instancia de AlloyDB.

Para conectar psql a una instancia de AlloyDB, debes realizar las siguientes tareas:

  1. Crea una VM de Compute Engine que pueda conectarse a instancias de AlloyDB mediante el acceso a servicios privados.
  2. Instala el cliente psql en la VM de Compute Engine.
  3. Obtén la dirección IP de la instancia de AlloyDB a la que quieras conectarte.
  4. Ejecuta el cliente psql.

Las dos primeras tareas son operaciones que se realizan una sola vez. Después de crear una VM de Compute Engine e instalar el cliente psql en ella, puedes seguir usando la VM para conectar psql a instancias de AlloyDB realizando las tareas restantes.

Antes de empezar

  • El Google Cloud proyecto que estés usando debe tener habilitado el acceso a AlloyDB.
  • Una red de VPC del proyecto Google Cloud que estés usando ya debe estar configurada para el acceso a servicios privados de AlloyDB.
  • Debes tener uno de estos roles de gestión de identidades y accesos en el Google Cloud proyecto que estés usando:
    • roles/alloydb.admin (el rol de gestión de identidades y accesos predefinido de AlloyDB)
    • roles/owner (el rol básico de propietario de gestión de identidades y accesos)
    • roles/editor (el rol básico de gestión de identidades y accesos Editor)

    Si no tienes ninguno de estos roles, ponte en contacto con el administrador de tu organización para solicitar acceso.

  • Si el host del cliente tiene un cortafuegos, debe permitir las conexiones de salida al puerto 5432 en las direcciones IP de tus instancias de AlloyDB.

Crear 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. Selecciona el proyecto que contiene la instancia de AlloyDB a la que quieras conectarte.
  3. Haz clic en Crear instancia.
  4. Haga clic en la sección Configuración del equipo.
  5. Introduce un nombre para la instancia.
  6. Configura la región y la zona en las que quieras crear la instancia.
  7. Selecciona una serie de máquinas y el tipo de máquina correspondiente.
  8. Mantén los valores predeterminados en la sección SO y almacenamiento.
  9. Haz clic en la sección Redes y, en Interfaces de red, selecciona la red de VPC configurada para el acceso a servicios privados de AlloyDB.
    Si Interfaces de red no está configurado en la red de VPC configurada para el acceso a servicios privados, expándelo y, a continuación, configura Red en la red de VPC.
  10. Mantén los valores predeterminados en la sección Observabilidad.
  11. Haz clic en la sección Seguridad.
  12. En Identidad y acceso de APIs, define Permisos de acceso como Permitir el acceso completo a todas las APIs de Cloud.
  13. Mantén los valores predeterminados en la sección Avanzado.
  14. Haz clic en Crear.

Una vez creada la VM, conéctate a ella mediante SSH.

Instalar la herramienta de cliente psql

  1. Conéctate a la máquina virtual de Compute Engine que has creado mediante SSH.

    Consola

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

      Ir a instancias de VM

    2. En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia que has creado.

    gcloud

    Usa el comando gcloud compute ssh para conectarte a la instancia que has creado.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto que contiene la instancia
    • ZONE: nombre de la zona en la que se encuentra la instancia
    • VM_NAME: el nombre de la instancia
  2. Instala el cliente psql desde el administrador de paquetes: 
    sudo apt-get update
sudo apt-get install postgresql-client

Obtener la dirección IP de la instancia de AlloyDB

Para obtener la dirección IP de la instancia de AlloyDB a la que quieras conectarte, consulta los ajustes de esa instancia.

Ejecutar el cliente psql

  1. Conéctate a la VM que has creado mediante SSH.

    Consola

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

      Ir a instancias de VM

    2. En la lista de instancias de máquinas virtuales, haz clic en SSH en la fila de la instancia que has creado.

    gcloud

    Usa el comando gcloud compute ssh para conectarte a la instancia que has creado.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Haz los cambios siguientes:

    • PROJECT_ID: el ID del proyecto que contiene la instancia.
    • ZONE: el nombre de la zona en la que se encuentra la instancia.
    • VM_NAME: el nombre de la instancia.
  2. Ejecuta la herramienta de cliente psql: 
    psql -h IP_ADDRESS -U USERNAME -d postgres

    Se te pedirá que introduzcas la contraseña del usuario USERNAME.

    Si es la primera vez que te conectas, especifica postgres tanto para USERNAME como para la base de datos. El comando tendrá el siguiente aspecto:

    psql -h IP_ADDRESS -U postgres -d postgres

    Usa la contraseña que definiste al crear el clúster.