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

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

1. Crea una VM de Compute Engine que se pueda conectar a instancias de AlloyDB con acceso privado a los servicios.
2. Instala el cliente de 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 tareas son operaciones únicas. Después de crear una VM de Compute Engine y, luego, instalar el cliente de psql en ella, puedes seguir usando la VM para conectar psql a las instancias de AlloyDB realizando las tareas restantes.

Crea una VM de Compute Engine

1. En la Google Cloud consola, 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 las 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 Redes y establece Interfaces de red en la red de VPC configurada para el acceso privado a servicios de AlloyDB.
   Si Interfaces de red no está configurado en la red de VPC configurada para el acceso a servicios privados, expándelo 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 Avanzado.
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 Google Cloud consola, ve a la página Instancias de VM.

      Ir a Instancias de VM

   2. En la lista de instancias de máquina virtual, 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 Google Cloud consola, ve a la página Instancias de VM.

      Ir a Instancias de VM

   2. En la lista de instancias de máquina virtual, 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: Es 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 cliente psql:

   psql -h IP_ADDRESS -U USERNAME -d postgres

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

   Si es la primera vez que te conectas, especifica postgres para USERNAME y la base de datos. Tu comando se verá de la siguiente manera:

   psql -h IP_ADDRESS -U postgres -d postgres

   Usa la contraseña que configuraste cuando creaste el clúster.