Administrar bases de datos

La zona de pruebas de GDC proporciona el servicio de base de datos para probar y administrar clústeres de bases de datos.

Crear base de datos

Para crear y administrar un clúster de bases de datos, consulta Crea y administra un clúster de bases de datos.

Motores de bases de datos disponibles

El GDC Sandbox solo admite PostgreSQL y AlloyDB.

Usa la consola de GDC o la CLI de Distributed Cloud para crear clústeres de bases de datos:

Console

  1. En el menú principal, elige Servicio de base de datos.
  2. Haz clic en Crear clúster de base de datos.
  3. En el diálogo Elige un motor para la base de datos, elige un motor de base de datos.

  4. En el cuadro de diálogo Configura tu clúster, especifica el ID, la contraseña y la versión de la base de datos del clúster. Puedes habilitar las copias de seguridad y configurar el período de retención de copias de seguridad.

  5. En el diálogo Configura tu instancia principal, especifica la capacidad de CPU, memoria y almacenamiento de la instancia principal del clúster de bases de datos. Te recomendamos que elijas suficiente memoria para contener tu tabla más grande.

  6. Haz clic en Crear. La creación del clúster de la base de datos puede tardar unos minutos. Verifica el estado del clúster en la página Descripción general del clúster. El estado cambia de Creando a Listo cuando el clúster está listo.

gdcloud

  1. Antes de usar Distributed Cloud CLI, instálala y, luego, inicialízala. Luego, autentícate con tu organización.

  2. Ejecuta el siguiente comando para crear un clúster de base de datos:

    gdcloud database clusters create CLUSTER_NAME \
        --database-version DB_VERSION \
        --admin-password ADMIN_PASSWORD
    

    Reemplaza las siguientes variables:

    • CLUSTER_NAME por el nombre del clúster nuevo.
    • DB_VERSION con la cadena de versión del clúster nuevo. Por ejemplo, POSTGRESQL_13 o ALLOYDBOMNI_15
    • ADMIN_PASSWORD con la contraseña de administrador del clúster nuevo.
  3. Para obtener más información sobre la configuración de los recursos de CPU, memoria y almacenamiento del clúster de base de datos, la configuración de copias de seguridad, la habilitación de la alta disponibilidad y otras opciones disponibles, ejecuta el siguiente comando:

    gdcloud database clusters create --help
    

API

  1. Crea un archivo db-cluster-create.yaml con el siguiente contenido:

    apiVersion: v1
    kind: Secret
    metadata:
      name: db-pw-DBCLUSTER_NAME
      namespace: USER_PROJECT
    type: Opaque
    data:
      DBCLUSTER_NAME: "BASE64_PASSWORD"
    ---
    apiVersion: DBENGINE_NAME.dbadmin.gdc.goog/v1
    kind: DBCluster
    metadata:
      name: DBCLUSTER_NAME
      namespace: USER_PROJECT
    spec:
      primarySpec:
        adminUser:
          passwordRef:
            name: db-pw-DBCLUSTER_NAME
        version: "DB_VERSION"
        resources:
          memory: DB_MEMORY
          cpu: DB_CPU
          disks:
          - name: DataDisk
            size: DB_DATA_DISK
    

    Reemplaza las siguientes variables:

    • DBCLUSTER_NAME, el nombre del clúster de la base de datos
    • USER_PROJECT, el nombre del proyecto del usuario en el que se creará el clúster de base de datos.
    • BASE64_PASSWORD, la codificación en base64 de la contraseña del administrador de la base de datos.
    • DBENGINE_NAME, el nombre del motor de base de datos. Puede ser alloydbomni o postgresql.
    • DB_VERSION, la versión del motor de base de datos
    • DB_MEMORY, la cantidad de memoria asignada al clúster de base de datos, por ejemplo, 5Gi.
    • DB_CPU, la cantidad de CPU asignadas al clúster de base de datos, por ejemplo, 2.
    • DB_DATA_DISK, cantidad de espacio asignado al clúster de base de datos, por ejemplo, 10 Gi.
  2. kubectl --kubeconfig MANAGEMENT_API apply -f db-cluster-create.yaml
    

Conéctate a la base de datos

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

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

Para conectarte a la base de datos desde direcciones IP fuera de tu organización de GDC Sandbox, sigue las instrucciones en Conéctate a un clúster de bases de datos para habilitar las conexiones externas.

Puedes usar sshuttle para conectarte a tu base de datos con un cliente de base de datos local como psql:

  1. Navega a la sección Connectivity de la página Database Service del clúster de bases de datos. En esta página, se 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 extremo principal del clúster de la base de datos
    • Un comando psql para conectarse al clúster (para clústeres de bases de datos de PostgreSQL y AlloyDB Omni)
    • Un vínculo para descargar el certificado de la autoridad certificadora (CA) del clúster de base de datos
  2. Descarga el certificado de CA desde la consola de GDC en la sección Conectividad de la página Servicio de base de datos de tu clúster de base de datos.

  3. Configura tu cliente para que use el certificado de la CA y verifique la base de datos. Para los clientes de psql, configura la variable de entorno PGSSLROOTCERT en la ruta del archivo de certificado y la variable de entorno PGSSLMODE según tus preferencias:

        export PGSSLROOTCERT=path/to/accounts_cert.pem
        export PGSSLMODE="verify-full"
    
  4. Inicia un túnel seguro. Si tienes una instancia de sshuttle en ejecución, como se describe en Cómo conectarse a la instancia, finaliza ese proceso.

        sshuttle -r zone1-org-1-data@GDC_SANDBOX_INSTANCE_NAME --no-latency-control \
        --ssh-cmd 'gcloud compute ssh --project PROJECT_NAME --zone ZONE --tunnel-through-iap' \
        10.200.0.0/16 --dns
    

    Reemplaza lo siguiente por los valores que te proporcionó el equipo del GDC Sandbox:

    • GDC_SANDBOX_INSTANCE_NAME: Es el nombre de tu instancia de GDC Sandbox.
    • PROJECT_NAME: Es el proyecto que contiene tu entorno de zona de pruebas de GDC.
    • ZONE: Es la zona que contiene tu entorno de zona de pruebas de GDC.
  5. Mientras el túnel está activo, ejecuta el comando con psql en otra terminal.

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

    Reemplaza las siguientes variables:

    • DB_PASSWORD: La contraseña de la IU de la consola.
    • DB_HOSTNAME: Es el nombre de host de la base de datos de la consola.
    • DB_PORT: Es el número de puerto de la base de datos que se muestra en la consola.
    • DB_USERNAME: Es el nombre de usuario de la base de datos de la consola.