Partilhar via


Início rápido: Use um modelo Bicep para criar um cluster elástico com o Azure Database para PostgreSQL

Azure Database for PostgreSQL com clusters elásticos é um serviço gerido que se utiliza para executar, gerir e escalar bases de dados PostgreSQL altamente disponíveis na cloud, com capacidade de escalabilidade horizontal. Pode usar um modelo Bicep para provisionar a sua base de dados Azure para a instância de clusters elásticos de servidor flexível PostgreSQL.

Bicep é uma linguagem de domínio específico (DSL) que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece uma sintaxe concisa, segurança de tipos confiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para suas soluções de infraestrutura como código no Azure.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie um gratuitamente.

Revise o modelo Bicep

Uma instância de cluster elástico de servidor flexível Azure Database for PostgreSQL é o recurso principal para uma base de dados distribuída dentro de uma região. Ele fornece o escopo para políticas de gerenciamento que se aplicam ao cluster: firewall, usuários, funções e configurações.

Crie um elastic-cluster-template.bicep ficheiro e copie o script seguinte para ele.

param administratorLogin string

@secure()
param administratorLoginPassword string

param clusterName string

param location string = 'canadacentral'

param clusterSize int = 2

param skuName string = 'Standard_D4ds_v5'
param serverEdition string = 'GeneralPurpose'

param storageSizeGB int = 64

param availabilityZone string = '1'

param backupRetentionDays int = 7

resource server 'Microsoft.DBforPostgreSQL/flexibleServers@2025-08-01' = {
  location: location
  name: clusterName
  properties: {
    createMode: 'Default'
    version: '17'
    administratorLogin: administratorLogin
    administratorLoginPassword: administratorLoginPassword
    availabilityZone: availabilityZone
    Storage: {
      StorageSizeGB: storageSizeGB
      Autogrow: 'Disabled'
    }
    Network: {
      publicNetworkAccess: 'Enabled'
    }
    Backup: {
      backupRetentionDays: backupRetentionDays
      geoRedundantBackup: 'Disabled'
    }
    highAvailability: {
      mode: 'Disabled'
    }
    cluster: {
      clusterSize: clusterSize
    }
  }
  sku: {
    name: skuName
    tier: serverEdition
  }
}

param firewallRules object = {
  rules: [
    {
      name: 'AllowAll'
      startIPAddress: '0.0.0.0'
      endIPAddress: '255.255.255.255'
    }
  ]
}

// Create one child firewall rule per entry in firewallRules.rules
resource serverFirewallRules 'Microsoft.DBforPostgreSQL/flexibleServers/firewallRules@2025-08-01' = [
  for rule in firewallRules.rules: {
    name: rule.name
    parent: server
    properties: {
      startIpAddress: rule.startIPAddress
      endIpAddress: rule.endIPAddress
    }
  }
]

Esses recursos são definidos no arquivo Bicep:

Desdobrar o arquivo Bicep

Use a CLI do Azure ou o Azure PowerShell para implantar o arquivo Bicep.

az login

$resourceGroupName = Read-Host -Prompt "Enter a name for the resource group where the server will exist"

az deployment group create `
  --resource-group $resourceGroupName `
  --template-file ./elastic-cluster-template.bicep

Você será solicitado a inserir estes valores:

  • clusterName: introduza um nome único que identifique a sua base de dados Azure para a instância de cluster elástico de servidor flexível PostgreSQL. O nome de domínio postgres.database.azure.com é acrescentado ao nome do cluster que você fornecer. O nome do cluster pode conter apenas letras minúsculas, números e o hífen (-). Tem de conter, pelo menos, 3 a 63 carateres.
  • administratorLogin: introduza a sua própria conta de autenticação para usar quando se ligar ao servidor. Por exemplo, clusterAdmin. O nome de autenticação de administrador não pode ser azure_superuser, azure_pg_admin, admin, administrator, root, guest, ou public. Não pode começar com pg_.
  • administratorLoginPassword: insira uma nova senha para a conta de administrador do servidor. Tem de conter entre 8 e 128 carateres. Além disso, tem de conter carateres de três das categorias seguintes: letras em maiúscula inglesas, letras em minúscula inglesas, números (0 a 9) e carateres não alfanuméricos (!, $, #, %, etc.).

Analisar os recursos implementados

Siga estes passos para verificar se o seu cluster elástico de servidores flexíveis Azure Database for PostgreSQL foi criado.

  1. No portal do Azure, procure e selecione o Banco de Dados do Azure para servidores flexíveis PostgreSQL.
  2. Na lista da base de dados, selecione o seu novo servidor para visualizar a página de Visão Geral e gerir o seu cluster elástico.

Observação

Mantenha esse grupo de recursos e o cluster elástico se quiser usá-lo para continuar com as próximas etapas sugeridas listadas na seção Conteúdo relacionado . As próximas etapas mostram como usar clusters elásticos com diferentes modelos e designs de fragmentação de aplicativos.

Limpeza de recursos

Após terminar o uso do ambiente de cluster elástico, elimina o recurso associado ao cluster elástico.

Para eliminar o aglomerado elástico, siga estes passos:

No portal, seleciona o cluster elástico que quiseres eliminar.

  1. Na página Descrição geral, selecione Eliminar.
  2. Revise os detalhes do seu recurso e confirme o pedido de eliminação para confirmar a operação de eliminação assinalando a caixa.
  3. Selecione Eliminar.