Compartilhar via


Início Rápido: Usar um arquivo Bicep para criar um Banco de Dados do Azure para PostgreSQL

Neste início rápido, você aprenderá a usar um arquivo Bicep para criar uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL.

O Banco de Dados do Azure para PostgreSQL é um serviço gerenciado que você usa para executar, gerenciar e dimensionar bancos de dados PostgreSQL altamente disponíveis na nuvem. Você pode usar o Bicep para provisionar uma instância de servidor flexível do Banco de Dados do Azure para PostgreSQL para implantar vários servidores ou vários bancos de dados em um servidor.

O Bicep é uma linguagem específica de domínio (DSL) 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.

Examinar o Bicep

Um servidor flexível do Banco de Dados PostgreSQL do Azure é o recurso pai de um ou mais bancos de dados em uma região. Ele fornece o escopo das políticas de gerenciamento que se aplicam aos respectivos bancos de dados: logon, firewall, usuários, funções, configurações etc.

Crie um arquivo main.bicep e copie o seguinte Bicep nele.

param administratorLogin string

@secure()
param administratorLoginPassword string
param ___location string = resourceGroup().___location
param serverName string
param serverEdition string = 'GeneralPurpose'
param skuSizeGB int = 128
param dbInstanceType string = 'Standard_D4ds_v4'
param haMode string = 'ZoneRedundant'
param availabilityZone string = '1'
param version string = '12'
param virtualNetworkExternalId string = ''
param subnetName string = ''
param privateDnsZoneArmResourceId string = ''

resource serverName_resource 'Microsoft.DBforPostgreSQL/flexibleServers@2021-06-01' = {
  name: serverName
  ___location: ___location
  sku: {
    name: dbInstanceType
    tier: serverEdition
  }
  properties: {
    version: version
    administratorLogin: administratorLogin
    administratorLoginPassword: administratorLoginPassword
    network: {
      delegatedSubnetResourceId: (empty(virtualNetworkExternalId) ? json('null') : json('\'${virtualNetworkExternalId}/subnets/${subnetName}\''))
      privateDnsZoneArmResourceId: (empty(virtualNetworkExternalId) ? json('null') : privateDnsZoneArmResourceId)
    }
    highAvailability: {
      mode: haMode
    }
    storage: {
      storageSizeGB: skuSizeGB
    }
    backup: {
      backupRetentionDays: 7
      geoRedundantBackup: 'Disabled'
    }
    availabilityZone: availabilityZone
  }
}

Esses recursos são definidos no arquivo Bicep:

Implante o arquivo Bicep

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

az group create --name exampleRG --___location centralus
az deployment group create --resource-group exampleRG --template-file main.bicep

Você precisará inserir estes valores:

  • serverName: insira um nome exclusivo que identifique sua instância de servidor flexível do Banco de Dados do Azure para PostgreSQL. Por exemplo, mydemoserver-pg. O nome de domínio postgres.database.azure.com será acrescentado ao nome do servidor fornecido. O servidor pode conter apenas letras minúsculas, números e o caractere de hífen (-). Ele deve conter, pelo menos, 3 até 63 caracteres.
  • administratorLogin: insira sua própria conta de login para uso ao se conectar ao servidor. Por exemplo, myadmin. O nome de login do administrador não pode ser azure_superuser, azure_pg_admin, admin, administrator, root, guest ou 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

Use o portal do Azure, a CLI do Azure ou o Azure PowerShell para validar a implantação e examinar os recursos implantados.

az resource list --resource-group exampleRG

Limpar os recursos

Mantenha esse grupo de recursos, servidor e banco de dados único se você quiser ir para o Conteúdo relacionado. A referência mostra como se conectar e consultar o seu banco de dados usando métodos diferentes.

Para excluir o grupo de recursos:

az group delete --name exampleRG