Conecta un cliente psql a una instancia

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

El procedimiento para conectar psql a una instancia de AlloyDB implique las siguientes tareas:

  1. Crea una VM de Compute Engine que pueda conectarse a instancias de AlloyDB con 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 deseas conectarte.
  4. Ejecuta el cliente psql

Las dos primeras de estas tareas son operaciones únicas. 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 comenzar

  • El proyecto de Google Cloud que usas debe estar habilitado para acceder a AlloyDB.
  • Una red de VPC en el proyecto de Google Cloud que usas ya debe estar configurada para el acceso privado a servicios a AlloyDB.
  • Debes tener uno de estos roles de IAM en el proyecto de Google Cloud que usas:
    • roles/alloydb.admin (el rol de IAM predefinido de administrador de AlloyDB)
    • roles/owner (el rol de IAM básico de propietario)
    • roles/editor (el rol de IAM básico de editor)

    Si no tienes ninguno de estos roles, comunícate con el administrador de tu organización para solicitar acceso.

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

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. Selecciona el proyecto que contiene la instancia de AlloyDB a la que deseas conectarte.
  3. Haz clic en Crear instancia.
  4. Haz clic en la sección Configuración de la máquina.
  5. Ingresa un Nombre para la instancia.
  6. Configura la región y la zona en la que deseas crear la instancia.
  7. Selecciona una serie de máquinas y el tipo de máquina correspondiente.
  8. Conserva los valores predeterminados en la sección SO y almacenamiento.
  9. Haz clic en la sección Red y establece Interfaces de red en la red de VPC configurada para el acceso de servicios privados a AlloyDB.
    Si Interfaces de red no está configurada en la red de VPC configurada para el acceso a servicios privados, expándela y, luego, establece Red en la red de VPC.
  10. Conserva los valores predeterminados en la sección Observabilidad.
  11. Haz clic en la sección Seguridad.
  12. En Identidad y acceso a la API, configura Permisos de acceso como Permitir el acceso total a todas las APIs de Cloud.
  13. Conserva los valores predeterminados en la sección Advanced.
  14. Haz clic en Crear.

Después de crear la VM, conéctate a la VM de Compute Engine que creaste con SSH.

Instala la herramienta cliente psql

  1. Conéctate a la VM de Compute Engine que creaste con SSH.

    Console

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

    gcloud

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

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

    Reemplaza lo siguiente:

    • 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: Es 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

Obtén la dirección IP de la instancia de AlloyDB

Para obtener la dirección IP de la instancia de AlloyDB a la que deseas conectarte, consulta la configuración de esa instancia.

Ejecuta el cliente psql

  1. Conéctate a la VM que creaste con SSH.

    Console

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

    gcloud

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

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

    Reemplaza lo siguiente:

    • 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: Es el nombre de la instancia.
  2. Ejecuta la herramienta cliente psql: 
    psql -h IP_ADDRESS -U USERNAME

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

    Si te conectas por primera vez, usa el valor predeterminado postgres para USERNAME y la contraseña que usaste cuando creaste el clúster para PASSWORD.