Delen via

Quickstart: Een Bicep-bestand gebruiken om een Azure Database for PostgreSQL te maken

In deze quickstart leert u hoe u een Bicep-bestand gebruikt om een flexibele Server-instantie van Azure Database for PostgreSQL te maken.

Azure Database for PostgreSQL is een beheerde service die u gebruikt voor het uitvoeren, beheren en schalen van maximaal beschikbare PostgreSQL-databases in de cloud. U kunt Bicep gebruiken om een exemplaar van een flexibele Azure Database for PostgreSQL-server in te richten om meerdere servers of meerdere databases op een server te implementeren.

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. Deze taal voorziet in een beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt de beste ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

Vereisten

Een Azure-account met een actief abonnement. Maak gratis een account.

Bekijk de Bicep

Een exemplaar van een flexibele Azure Database for PostgreSQL-server is de bovenliggende resource voor een of meer databases in een regio. Deze levert de beheerbeleidsregels die van toepassing zijn op de betreffende databases: aanmeldingen, firewall, gebruikers, rollen en configuraties.

Maak een main.bicep-bestand en kopieer de volgende Bicep erin.

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

Deze resources worden gedefinieerd in het Bicep-bestand:

Het Bicep-bestand implementeren

Gebruik Azure CLI of Azure PowerShell om het Bicep-bestand te implementeren.

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

U wordt gevraagd deze waarden in te voeren:

  • serverName: voer een unieke naam in waarmee het exemplaar van uw flexibele Azure Database for PostgreSQL-server wordt geïdentificeerd. Bijvoorbeeld: mydemoserver-pg. De domeinnaam postgres.database.azure.com wordt toegevoegd aan de servernaam die u opgeeft. De server mag alleen kleine letters, cijfers en het koppelteken (-) bevatten. Hij moet ten minste 3 en mag maximaal 63 tekens bevatten.
  • administratorLogin: voer uw eigen aanmeldingsaccount in dat moet worden gebruikt wanneer u verbinding maakt met de server. Bijvoorbeeld: myadmin. De aanmeldingsnaam van de beheerder kan niet azure_superuserzijn: , azure_pg_admin, admin, administrator, rootof guestpublic. Het kan niet beginnen met pg_.
  • administratorLoginPassword: voer een nieuw wachtwoord in voor het beheerdersaccount van de server. Dit wachtwoord moet tussen 8 en 128 tekens bevatten. Uw wachtwoord moet tekens bevatten uit drie van de volgende categorieën: Nederlandse hoofdletters, Nederlandse kleine letters, cijfers (0 tot en met 9) en niet-alfanumerieke tekens (!, $, #, % etc.).

Geïmplementeerde resources bekijken

Gebruik Azure Portal, Azure CLI of Azure PowerShell om de implementatie te valideren en de geïmplementeerde resources te controleren.

az resource list --resource-group exampleRG

Resources opschonen

Bewaar deze resourcegroep, server en individuele database als u naar de gerelateerde inhoud wilt gaan. In de verwijzing ziet u hoe u verbinding maakt en een query uitvoert op uw database met behulp van verschillende methoden.

De resourcegroep verwijderen:

az group delete --name exampleRG

Gerelateerde inhoud