Criar um cluster de banco de dados

Nesta página, descrevemos como usar o serviço de banco de dados para criar e gerenciar bancos de dados no Google Distributed Cloud (GDC) com isolamento físico.

Autorização e papéis

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

Os seguintes papéis 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 projetos de banco de dados (project-db-viewer)
Os usuários com esse papel podem visualizar clusters de banco de dados.
Editor de projetos de banco de dados (project-db-editor)
Os usuários com esse papel têm os recursos conferidos por project-db-viewer e também podem editar clusters de banco de dados.
Administrador de projetos de banco de dados (project-db-admin)
Os usuários com esse papel têm a capacidade conferida por project-db-editor e também podem criar e excluir clusters de banco de dados.
Leitor de projetos de objetos de bucket (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 de projetos (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 as métricas do Database Service. Conceda esse papel apenas aos usuários que precisam acessar a instância de monitoramento.
Administrador de projeto da política de manutenção (project-mp-admin)
Os usuários com esse papel têm os recursos conferidos 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 projetos da política de manutenção (project-mp-viewer)
Os usuários com esse papel podem ver as políticas de manutenção.
Editor de projetos de política de manutenção (project-mp-editor)
Os usuários com esse papel têm os recursos conferidos pelo papel project_mp_viewer e também podem criar, editar e excluir políticas de manutenção.
Leitor de projetos de vinculação de políticas de manutenção (project-mpb-viewer)
Os usuários com esse papel podem ver as vinculações da política de manutenção.
Editor de projetos de vinculação de políticas de manutenção (project-mpb-editor)
Os usuários com esse papel têm os recursos conferidos pelo papel project_mpb_viewer e também podem criar, editar e excluir vinculações de política 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 do projeto de banco de dados 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 da instância principal para proteção contra falhas. Consulte Alta disponibilidade para mais informações.

  6. Na caixa de diálogo Configurar a instância principal, especifique a CPU, a memória e a capacidade de armazenamento da instância principal do cluster de banco de dados. Recomendamos que você escolha memória suficiente para armazenar sua 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 inicialize-a. Em seguida, faça a autenticação com 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 de usuário em que o cluster de banco de dados será criado.
    • BASE64_PASSWORD, a codificação base64 da senha do administrador do banco de dados.
    • DB_VERSION, a versão do mecanismo de banco de dados.
    • DB_MEMORY, a quantidade de alocação 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, quantidade de espaço alocada para o cluster de banco de dados, por exemplo, 10 Gi.

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