Creare un cluster di database

Questa pagina descrive come utilizzare il servizio di database per creare e gestire i database in Google Distributed Cloud (GDC) air-gapped.

Autorizzazione e ruoli

Gli utenti devono essere autorizzati ad accedere al servizio di database. L'autorizzazione è necessaria per accedere al servizio di database sia con la console GDC sia con Distributed Cloud CLI.

Nota: l'autorizzazione per accedere al servizio di database è diversa da ll'autorizzazione per accedere ai database gestiti dal servizio di database. Per indicazioni sul controllo dell'accesso ai database, consulta la documentazione del sistema di gestione di database (DBMS).

I seguenti ruoli concedono autorizzazioni agli utenti:

Visualizzatore progetto (project-viewer)

Gli utenti con questo ruolo possono accedere alla console GDC e a Distributed Cloud CLI.

Visualizzatore DB progetto(project-db-viewer)

Gli utenti con questo ruolo possono visualizzare i cluster di database.

Editor DB progetto (project-db-editor)

Gli utenti con questo ruolo hanno le funzionalità conferite da project-db-viewer e possono anche modificare i cluster di database.

Amministratore DB progetto (project-db-admin)

Gli utenti con questo ruolo hanno le funzionalità conferite da project-db-editor e possono anche creare ed eliminare i cluster di database.

Visualizzatore oggetti bucket progetto (project-bucket-object-viewer)

Gli utenti con questo ruolo possono utilizzare il browser di archiviazione nell'interfaccia del servizio di database nella console GDC. Questa interfaccia viene utilizzata per specificare i file per le importazioni di database e per specificare le destinazioni dei file generati dalle esportazioni di database.

Visualizzatore monitoraggio progetto (project-monitoring-viewer)

Gli utenti con questo ruolo possono accedere all'istanza di monitoraggio. Per ulteriori informazioni sull'osservazione delle metriche del servizio di database, consulta la sezione Osservare le metriche per Concedi questo ruolo solo agli utenti che devono accedere all'istanza di monitoraggio.

Amministratore policy di manutenzione progetto (project-mp-admin)

Gli utenti con questo ruolo hanno le funzionalità conferite dai ruoli project_mp_editor e project_mpb_editor, quindi possono creare, modificare ed eliminare sia le policy di manutenzione sia i binding delle policy di manutenzione.

Visualizzatore policy di manutenzione progetto (project-mp-viewer)

Gli utenti con questo ruolo possono visualizzare le policy di manutenzione.

Editor policy di manutenzione progetto (project-mp-editor)

Gli utenti con questo ruolo hanno le funzionalità conferite dal ruolo project_mp_viewer e possono anche creare, modificare ed eliminare le policy di manutenzione.

Visualizzatore binding policy di manutenzione progetto (project-mpb-viewer)

Gli utenti con questo ruolo possono visualizzare i binding delle policy di manutenzione.

Editor binding policy di manutenzione progetto (project-mpb-editor)

Gli utenti con questo ruolo hanno le funzionalità conferite dal ruolo project_mpb_viewer e possono anche creare, modificare ed eliminare i binding delle policy di manutenzione.

Motori di database disponibili

I seguenti motori di database sono disponibili per l'utilizzo in un ambiente GDC:

| Database | Versioni | |-----------------------------|----------| | PostgreSQL | 13, 14, 15 |

Crea un cluster di database

Importante: ti consigliamo di chiedere all'amministratore della piattaforma di creare un repository di backup denominato dbs-backup-repository prima di creare il primo database. Verifica con l'amministratore l'esistenza di un repository di backup appropriato e che abbia seguito i passaggi per convalidare un backup. Una volta confermato, puoi abilitare il backup durante la creazione del cluster di database.

Un utente con il ruolo di amministratore DB progetto deve eseguire i seguenti passaggi. Utilizza la console GDC o Distributed Cloud CLI per creare i cluster di database.

Nota: per impostazione predefinita, i volumi del disco utilizzano la classe di archiviazione standard standard-rwo.

Console

1. Dal menu principale, scegli Servizio di database.
2. Fai clic su Crea cluster di database.

3. Nella finestra di dialogo Scegli un motore del database, scegli un motore del database.

4. Nella finestra di dialogo Configura il cluster , specifica l'ID cluster, la password e la versione del database. Puoi abilitare i backup e configurare il periodo di conservazione dei backup.

5. Puoi abilitare l'alta disponibilità per il cluster di database. Se abilitato, il servizio di database esegue il provisioning di un'istanza in standby nella stessa zona dell'istanza principale per proteggere da eventuali guasti. Per ulteriori informazioni, consulta la sezione Alta affidabilità.

6. Nella finestra di dialogo Configura l'istanza principale , specifica la CPU, la memoria e la capacità di archiviazione dell'istanza principale del cluster di database. Ti consigliamo di scegliere una memoria sufficiente per contenere la tabella più grande.

7. Fai clic su Crea. La creazione del cluster di database può richiedere alcuni minuti. Controlla lo stato del cluster dalla pagina Panoramica cluster. Quando il cluster è pronto, lo stato passa da Creazione a Pronto.

gdcloud

1. Prima di utilizzare Distributed Cloud CLI, installala e inizializzala. Poi, esegui l'autenticazione con la tua organizzazione.

2. Esegui il comando seguente per creare un cluster di database:

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

   Sostituisci le seguenti variabili:

   • CLUSTER_NAME con il nome del nuovo cluster.
   • DB_VERSION con la stringa della versione del nuovo cluster. Ad esempio, POSTGRESQL_13, POSTGRESQL_14 o POSTGRESQL_15
   • ADMIN_PASSWORD con la password dell'amministratore per il nuovo cluster.

3. Per ulteriori informazioni sulla configurazione delle risorse CPU, memoria e archiviazione per il cluster di database, sulla configurazione del backup, sull'abilitazione dell'alta disponibilità e su altre opzioni disponibili, esegui:

   gdcloud database clusters create --help
   

API

  apiVersion: v1
  kind: Secret
  metadata:
    name: db-pw-DBCLUSTER_NAME
    namespace: USER_PROJECT
  type: Opaque
  data:
    DBCLUSTER_NAME: "BASE64_PASSWORD"
  ---
  apiVersion: postgresql.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

1. Sostituisci le seguenti variabili:

   • DBCLUSTER_NAME, il nome del cluster di database.
   • USER_PROJECT, il nome del progetto utente in cui verrà creato il cluster di database.
   • BASE64_PASSWORD, la codifica base64 della password dell'amministratore del database.
   • DB_VERSION, la versione del motore del database.
   • DB_MEMORY, la quantità di memoria allocata al cluster di database, ad esempio 5Gi.
   • DB_CPU, la quantità di CPU allocata al cluster di database, ad esempio 2.
   • DB_DATA_DISK, la quantità di spazio allocata al cluster di database, ad esempio 10 Gi.

2. Crea una risorsa BackupPlan DBS nello stesso spazio dei nomi per abilitare i backup.