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
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
psqlpara conectarse al clúster - Un enlace para descargar el certificado de la autoridad de certificación (AC) del clúster de bases de datos
- La contraseña de la cuenta de administrador (el nombre de usuario es
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.
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 entornoPGSSLROOTCERTla ruta del archivo de certificado y a la variable de entornoPGSSLMODEel valor que prefieras:export PGSSLROOTCERT=path/to/accounts_cert.pem export PGSSLMODE="verify-full"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 certificadoaccounts_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
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}'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.crtConfigura 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 entornoPGSSLROOTCERTcomo la ruta del archivo de certificado y la variable de entornoPGSSLMODEsegún tus preferencias:export PGSSLROOTCERT=path/to/ca.crt export PGSSLMODE="verify-full"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 esdbsadmin).