Condividi tramite

Guida introduttiva: Usare un file Bicep per creare un'istanza del server flessibile Database di Azure per PostgreSQL

SI APPLICA A: Database di Azure per PostgreSQL - Server flessibile

In questa guida introduttiva si apprenderà come usare un file Bicep per creare un'istanza del server flessibile Database di Azure per PostgreSQL.

Il server flessibile di 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 Database di Azure per PostgreSQL per distribuire più server o più database in un server.

Bicep è un linguaggio specifico di dominio (DSL) che usa la sintassi dichiarativa per distribuire le risorse di Azure. Offre sintassi concisa, indipendenza dai 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. Crearne una gratuitamente.

Esaminare Bicep

Un'istanza del server flessibile Database di Azure per PostgreSQL è 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 copiarlo nel file 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 queste risorse:

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à richiesto di immettere questi valori:

  • serverName: immettere un nome univoco che identifichi l'istanza del server flessibile Database di Azure per PostgreSQL. Ad esempio: mydemoserver-pg. Al nome del server fornito 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 il proprio account di accesso da usare quando ci si connette al server. Ad esempio: myadmin. Il nome dell'account 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

Mantenere questo gruppo di risorse, il server e il database singolo se si vuole passare al contenuto correlato. Il riferimento illustra come connettersi ed eseguire query sul database usando metodi diversi.

Per eliminare il gruppo di risorse:

az group delete --name exampleRG

Contenuto correlato