Condividi tramite

Guida introduttiva: Usare un modello Bicep per creare un cluster elastico con Database di Azure per PostgreSQL

Database di Azure per PostgreSQL con cluster elastici è un servizio gestito utilizzato per eseguire, gestire e ridimensionare database PostgreSQL con alta disponibilità nel cloud con capacità di scalabilità orizzontale. È possibile usare un modello Bicep per effettuare il provisioning dell'istanza di cluster elastici del server flessibile di Database di Azure per PostgreSQL.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Fornisce sintassi concisa, sicurezza dei tipi affidabile e supporto per il riutilizzo del codice. Bicep offre la migliore esperienza di creazione per le soluzioni di infrastruttura come codice in Azure.

Prerequisiti

Un account Azure con una sottoscrizione attiva. Creane uno gratis.

Esaminare il modello Bicep

Un'istanza del cluster elastico del server flessibile Database di Azure per PostgreSQL è la risorsa padre per un database distribuito all'interno di un'area. Fornisce l'ambito per i criteri di gestione applicabili al cluster: firewall, utenti, ruoli e configurazioni.

Creare un elastic-cluster-template.bicep file e copiarlo nello script seguente.

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
    }
  }
]

Nel file Bicep sono definite le risorse seguenti:

Implementazione del file Bicep

Usare l'interfaccia della riga di comando di Azure o Azure PowerShell per distribuire il file 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

Verrà chiesto di immettere questi valori:

  • clusterName: immettere un nome univoco che identifichi l'istanza del cluster elastico del server flessibile di Database di Azure per PostgreSQL. Il nome postgres.database.azure.com di dominio viene aggiunto al nome del cluster specificato. Il nome del cluster può contenere solo lettere minuscole, numeri e il trattino (-). Deve contenere almeno da 3 a 63 caratteri.
  • administratorLogin: immettere il proprio account di autenticazione da usare quando ci si connette al server. Ad esempio: clusterAdmin. Il nome di autenticazione dell'amministratore non può essere azure_superuser, azure_pg_admin, admin, administratorroot, guest, o public. Non può iniziare con pg_.
  • administratorLoginPassword: immettere una nuova password per l'account amministratore del server. Deve contenere tra 8 e 128 caratteri. La password deve contenere caratteri di tre delle categorie seguenti: lettere maiuscole, lettere minuscole, numeri (da 0 a 9) e caratteri non alfanumerici (!, $, #, % e così via).

Esaminare le risorse distribuite

Seguire questa procedura per verificare se è stato creato il cluster elastico del server flessibile di Database di Azure per PostgreSQL.

  1. Nel portale di Azure cercare e selezionare l'opzione relativa ai server flessibili di Database di Azure per PostgreSQL.
  2. Nell'elenco di database selezionare il nuovo server per visualizzare la pagina Panoramica per gestire il cluster elastico.

Annotazioni

Mantenere questo gruppo di risorse e il cluster elastico se si vuole usarlo per continuare con i passaggi suggeriti successivi elencati nella sezione Contenuto correlato . I passaggi successivi illustrano come usare cluster elastici con modelli e progettazioni di partizionamento orizzontale di applicazioni diversi.

Pulire le risorse

Quando è completata la lavorazione con l'ambiente del cluster elastico, si può eliminare la risorsa del cluster elastico.

Per eliminare il cluster elastico, seguire questa procedura:

Nel portale selezionare il cluster elastico da eliminare.

  1. Nella pagina Panoramica selezionare Elimina.
  2. Esaminare i dettagli della risorsa e confermare la richiesta di eliminazione per confermare l'operazione di eliminazione selezionando la casella di controllo.
  3. Selezionare Elimina.

Contenuti correlati

  • Last updated on