Conectarse a un clúster de bases de datos

De forma predeterminada, un clúster de bases de datos solo permite la conexión desde el clúster de usuarios y el mismo proyecto.

Para habilitar las conexiones a todos los clústeres de bases de datos de tu proyecto desde otro proyecto, consulta Habilitar conexiones entre proyectos.

Para habilitar las conexiones a un clúster de bases de datos desde direcciones IP que no pertenezcan a tu organización de GDC, consulta Habilitar conexiones externas.

Inicia sesión en la consola de GDC con una cuenta vinculada al rol de administrador de proyectos de bases de datos para encontrar la siguiente información y conectarte a tu clúster de bases de datos. Esta información se encuentra en la sección Conectividad de la página Servicio de base de datos.

Estos pasos incluyen un ejemplo para conectarse a la base de datos mediante psql. Los pasos exactos variarán en función del software de cliente que elijas.

Consola

  1. Ve a la sección Conectividad de la página Servicio de base de datos del clúster de bases de datos. Esta página incluye lo siguiente:

    • La contraseña de la cuenta de administrador (el nombre de usuario es dbsadmin)
    • Nombre de host y número de puerto del endpoint principal del clúster de bases de datos
    • Si el clúster de bases de datos permite la conexión externa desde fuera de la organización.
    • Un comando psql para conectarse al clúster
    • Un enlace para descargar el certificado de la autoridad de certificación (AC) del clúster de bases de datos
  2. Descarga el certificado AC de la consola de GDC en la sección Conectividad de la página Servicio de base de datos de tu clúster de bases de datos.

  3. Configura tu cliente para que use el certificado AC para verificar la base de datos. En el caso de los clientes de psql, asigna a la variable de entorno PGSSLROOTCERT la ruta del archivo de certificado y a la variable de entorno PGSSLMODE el valor que prefieras:

    export PGSSLROOTCERT=path/to/accounts_cert.pem
    export PGSSLMODE="verify-full"
    
  4. Conéctate a la base de datos desde tu software de cliente. Si usas psql, ejecuta el siguiente comando:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p PORT -U USERNAME -d postgres
    

Sustituye las siguientes variables:

  • path/to/: la ruta al certificado accounts_cert.pem.
  • DB_PASSWORD: la contraseña de la consola.
  • DB_HOSTNAME: el nombre de host de la base de datos de la consola.
  • DB_PORT: el número de puerto de la base de datos de la consola.
  • DB_USERNAME: el nombre de usuario de la base de datos de la consola.

API

  1. Obtén el endpoint de la base de datos a partir del estado del clúster de bases de datos:

    kubectl get dbcluster.postgresql.dbadmin.gdc.goog DBCLUSTER_NAME -n USER_PROJECT -o=jsonpath='{.status.primary.url}'
    
  2. Descarga el certificado AC del secreto de Kubernetes:

    kubectl get secret dbs-certificates -n USER_PROJECT -o json | jq -r '.data."dbs-pg-cert-DBCLUSTER_NAME"' | base64 -d > path/to/ca.crt
    
  3. Configura tu cliente para que use el certificado AC para verificar la base de datos. En el caso de los clientes de psql, puedes definir la variable de entorno PGSSLROOTCERT como la ruta del archivo de certificado y la variable de entorno PGSSLMODE según tus preferencias:

    export PGSSLROOTCERT=path/to/ca.crt
    export PGSSLMODE="verify-full"
    
  4. Conéctate a la base de datos desde tu software de cliente. Si usas psql, ejecuta el siguiente comando:

    PGPASSWORD=DB_PASSWORD psql -h DB_HOSTNAME -p DB_PORT -U DB_USERNAME -d postgres
    

Sustituye las siguientes variables:

  • USER_PROJECT: el nombre del proyecto de usuario en el que se ha creado el clúster de bases de datos.
  • DBCLUSTER_NAME: el nombre del clúster de bases de datos.
  • path/to/: la ruta al certificado AC de la base de datos.
  • DB_PASSWORD: contraseña de la base de datos del usuario administrador.
  • DB_HOSTNAME: el nombre de host del estado del clúster de la base de datos.
  • DB_PORT: el número de puerto de la base de datos del estado del clúster de bases de datos.
  • DB_USERNAME: con el nombre de usuario de la base de datos (el valor predeterminado es dbsadmin).