Compartilhar via

Início Rápido: Usar um modelo Bicep para criar um cluster elástico com o Banco de Dados do Azure para PostgreSQL

O Banco de Dados do Azure para PostgreSQL com clusters elásticos é um serviço gerenciado que você usa para executar, gerenciar e dimensionar bancos de dados PostgreSQL altamente disponíveis na nuvem com uma funcionalidade horizontal de expansão. Você pode usar um modelo Bicep para provisionar a instância de clusters elásticos do servidor flexível do Banco de Dados do Azure para PostgreSQL.

O Bicep é um DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece 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 do servidor flexível do Banco de Dados do Azure para PostgreSQL é o recurso pai de um banco de dados distribuído em uma região. Ele fornece o escopo das políticas de gerenciamento aplicáveis ao cluster, como firewall, usuários, funções e configurações.

Crie um elastic-cluster-template.bicep arquivo e copie o script a seguir nele.

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:

Implantar 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ê precisará inserir estes valores:

  • clusterName: insira um nome exclusivo que identifique a instância de cluster elástico do servidor de banco de dados flexível do Azure para PostgreSQL. O nome postgres.database.azure.com de domínio é acrescentado ao nome do cluster que você fornece. O nome do cluster pode conter apenas letras minúsculas, números e o caractere hífen (-). Ele deve conter, pelo menos, 3 até 63 caracteres.
  • administratorLogin: insira sua própria conta de autenticação a ser usada quando você se conectar ao servidor. Por exemplo, clusterAdmin. O nome da autenticação do administrador não pode ser azure_superuser, , azure_pg_admin, admin, administrator, , root, guestou public. Ele não pode começar com pg_.
  • administratorLoginPassword: insira uma nova senha para a conta do administrador do servidor. Ele deve conter entre 8 e 128 caracteres. A senha deve conter caracteres das três seguintes categorias: letras maiúsculas, letras minúsculas, números (0 a 9) e caracteres não alfanuméricos (!, $, #, %, etc.).

Examinar os recursos implantados

Siga estas etapas para verificar se o cluster elástico do servidor flexível do Banco de Dados do Azure para PostgreSQL foi criado.

  1. No portal do Azure, pesquise e selecione servidores flexíveis do Banco de Dados do Azure para PostgreSQL.
  2. Na lista de banco de dados, selecione seu novo servidor para exibir a página Visão geral para gerenciar seu cluster elástico.

Observação

Mantenha esse grupo de recursos e o cluster elástico se você 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.

Limpar os recursos

Quando terminar de usar o ambiente de cluster Elastic, exclua o recurso de cluster Elastic.

Para excluir o cluster elástico, siga estas etapas:

No portal, selecione o cluster elástico que você deseja excluir.

  1. Na página Visão Geral, selecione Excluir.
  2. Revise os detalhes do recurso e reconheça a solicitação de exclusão para confirmar a operação de exclusão marcando a caixa de seleção.
  3. Selecione Excluir.

Conteúdo relacionado

  • Last updated on