Criar um cluster de banco de dados

Esta página descreve como usar o Serviço de banco de dados para criar e gerenciar bancos de dados no Google Distributed Cloud (GDC) isolado.

Autorização e papéis

Os usuários precisam de autorização para acessar o Serviço de banco de dados. A autorização é necessária para acessar o Serviço de banco de dados com o console do GDC e a CLI do Distributed Cloud.

Os papéis a seguir concedem permissões aos usuários:

Leitor do projeto (project-viewer)
Os usuários com esse papel podem acessar o console do GDC e a CLI do Distributed Cloud.
Leitor de banco de dados do projeto(project-db-viewer)
Os usuários com esse papel podem visualizar clusters de banco de dados.
Editor de banco de dados do projeto (project-db-editor)
Os usuários com esse papel têm os recursos concedidos pelo project-db-viewer e também podem editar clusters de banco de dados.
Administrador de banco de dados do projeto (project-db-admin)
Os usuários com esse papel têm o recurso concedido pelo project-db-editor e também podem criar e excluir clusters de banco de dados.
Leitor de objetos de bucket do projeto (project-bucket-object-viewer)
Os usuários com esse papel podem usar o navegador de armazenamento na interface do Serviço de banco de dados no console do GDC. Essa interface é usada para especificar arquivos para importações de banco de dados e destinos para arquivos gerados por exportações de banco de dados.
Leitor de monitoramento do projeto (project-monitoring-viewer)
Os usuários com esse papel podem acessar a instância de monitoramento. Consulte Observar métricas para mais informações sobre como observar métricas do Serviço de banco de dados. Conceda esse papel apenas aos usuários que precisam acessar a instância de monitoramento.
Administrador de política de manutenção do projeto (project-mp-admin)
Os usuários com esse papel têm os recursos concedidos pelos papéis project_mp_editor e project_mpb_editor. Assim, eles podem criar, editar e excluir políticas de manutenção e vinculações de políticas de manutenção.
Leitor de política de manutenção do projeto (project-mp-viewer)
Os usuários com esse papel podem visualizar políticas de manutenção.
Editor de política de manutenção do projeto (project-mp-editor)
Os usuários com esse papel têm os recursos concedidos pelo papel project_mp_viewer e também podem criar, editar e excluir políticas de manutenção.
Leitor de vinculação de política de manutenção do projeto (project-mpb-viewer)
Os usuários com esse papel podem visualizar vinculações de políticas de manutenção.
Editor de vinculação de política de manutenção do projeto (project-mpb-editor)
Os usuários com esse papel têm os recursos concedidos pelo papel project_mpb_viewer e também podem criar, editar e excluir vinculações de políticas de manutenção.

Mecanismos de banco de dados disponíveis

Os seguintes mecanismos de banco de dados estão disponíveis para uso em um ambiente do GDC:

| Banco de dados | Versões | |-----------------------------|----------| | PostgreSQL | 13, 14, 15 |

Criar um cluster de banco de dados

Um usuário com o papel de administrador de banco de dados do projeto precisa realizar as etapas a seguir. Use o console do GDC ou a CLI do Distributed Cloud para criar clusters de banco de dados.

Console

  1. No menu principal, escolha Serviço de banco de dados.
  2. Clique em Criar cluster de banco de dados.

  3. Na caixa de diálogo Escolher um mecanismo de banco de dados, escolha um mecanismo de banco de dados.

  4. Na caixa de diálogo Configurar o cluster , especifique o ID do cluster, a senha e a versão do banco de dados. É possível ativar backups e configurar o período de armazenamento de backup.

  5. É possível ativar a alta disponibilidade para o cluster de banco de dados. Se ativado, o Serviço de banco de dados provisiona uma instância em espera na mesma zona que a instância principal para proteger contra falhas. Consulte Alta disponibilidade para mais informações.

  6. Na caixa de diálogo Configurar a instância principal , especifique a capacidade de CPU, memória e armazenamento da instância principal do cluster de banco de dados. Recomendamos que você escolha memória suficiente para armazenar a maior tabela.

  7. Clique em Criar. A criação do cluster de banco de dados pode levar alguns minutos. Verifique o status do cluster na página Visão geral do cluster. O status muda de Criando para Pronto quando o cluster está pronto.

gdcloud

  1. Antes de usar a CLI do Distributed Cloud, instale e inicializea. Em seguida, autentique-se na sua organização.

  2. Execute o comando a seguir para criar um cluster de banco de dados:

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

    Substitua as seguintes variáveis:

    • CLUSTER_NAME pelo nome do novo cluster.
    • DB_VERSION pela string de versão do novo cluster. Por exemplo, POSTGRESQL_13, POSTGRESQL_14 ou POSTGRESQL_15
    • ADMIN_PASSWORD pela senha de administrador do novo cluster.

  3. Para mais informações sobre como configurar os recursos de CPU, memória e armazenamento para o cluster de banco de dados, configurar o backup, ativar a alta disponibilidade e outras opções disponíveis, execute:

    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. Substitua as seguintes variáveis:

    • DBCLUSTER_NAME, o nome do cluster de banco de dados.
    • USER_PROJECT, o nome do projeto do usuário em que o cluster de banco de dados será criado.
    • BASE64_PASSWORD, a codificação base64 da senha de administrador do banco de dados.
    • DB_VERSION, a versão do mecanismo de banco de dados.
    • DB_MEMORY, a quantidade de memória alocada para o cluster de banco de dados, por exemplo, 5Gi.
    • DB_CPU, a quantidade de CPUs alocadas para o cluster de banco de dados, por exemplo, 2.
    • DB_DATA_DISK, a quantidade de espaço alocado para o cluster de banco de dados, por exemplo, 10 Gi.

  2. Crie um recurso BackupPlan do DBS no mesmo namespace para ativar os backups.