Condividi tramite

Guida introduttiva: Usare un file Bicep per creare un database di Azure per PostgreSQL

Questo argomento di avvio rapido illustra come usare un file Bicep per creare un'istanza del server flessibile di Database di Azure per PostgreSQL.

Database di Azure per PostgreSQL è un servizio gestito usato per eseguire, gestire e ridimensionare database PostgreSQL a disponibilità elevata nel cloud. È possibile usare Bicep per effettuare il provisioning di un'istanza del server flessibile di Database di Azure per PostgreSQL, più server o più database in un server.

Bicep è un linguaggio specifico del dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre 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. È possibile crearne uno gratuitamente.

Esaminare Bicep

Un'istanza di Database di Azure per PostgreSQL - Server flessibile è la risorsa padre per uno o più database all'interno di un'area. Fornisce l'ambito per i criteri di gestione che si applicano ai relativi database: account di accesso, firewall, utenti, ruoli e configurazioni.

Creare un file main.bicep e copiare al suo interno il codice Bicep seguente.

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

Nel file Bicep sono definite le risorse seguenti:

Distribuire il file Bicep

Usare l'interfaccia della riga di comando di Azure o Azure PowerShell per distribuire il file Bicep.

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

Verrà chiesto di immettere questi valori:

  • serverName: immettere un nome univoco che identifichi l'istanza del server flessibile di Database di Azure per PostgreSQL. Ad esempio: mydemoserver-pg. Al nome del server inserito viene aggiunto il nome di dominio postgres.database.azure.com. Il server può contenere solo lettere minuscole, numeri e il segno meno (-). Deve contenere almeno da 3 a 63 caratteri.
  • administratorLogin: immettere l’account di accesso da usare per la connessione al server. Ad esempio: myadmin. Il nome di accesso 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

Usare il portale di Azure, l'interfaccia della riga di comando di Azure o Azure PowerShell per convalidare la distribuzione ed esaminare le risorse distribuite.

az resource list --resource-group exampleRG

Pulire le risorse

Se si vuole procedere con il Contenuto correlato, conservare il gruppo di risorse, il server e il database singolo. Il riferimento illustra come connettersi al database ed eseguire query con diversi metodi.

Per eliminare il gruppo di risorse:

az group delete --name exampleRG

Contenuti correlati

  • Last updated on