Freigeben über

Schnellstart: Verwenden einer Bicep-Datei zum Erstellen einer Instanz von Azure Database for PostgreSQL – Flexible Serverinstanz

GILT FÜR: Azure Database for PostgreSQL – Flexibler Server

In diesem Schnellstart erfahren Sie, wie Sie mit einer Bicep-Datei eine Instanz von Azure Database for PostgreSQL-Flexible Serverinstanz erstellen.

Azure Database for PostgreSQL – Flexibler Server ist ein verwalteter Dienst, mit dem Sie hochverfügbare PostgreSQL-Datenbanken in der Cloud ausführen, verwalten und skalieren können. Sie können Bicep verwenden, um eine Azure Database for PostgreSQL-Flexible Serverinstanz bereitzustellen, um mehrere Server oder mehrere Datenbanken auf einem Server bereitzustellen.

Bicep ist eine domänenspezifische Sprache (Domain-Specific Language, DSL), die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. Sie bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Erstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.

Voraussetzungen

Ein Azure-Konto mit einem aktiven Abonnement. Erstellen Sie ein kostenloses Konto.

Überprüfen der Bicep-Datei

Bei einer Instanz von Azure Database for PostgreSQL – Flexible Server handelt es sich um die übergeordnete Ressource für eine oder mehrere Datenbanken innerhalb einer Region. Sie stellt den Bereich für Verwaltungsrichtlinien bereit, die auf die jeweiligen Datenbanken angewendet werden (z. B. Anmeldungen, Firewalls, Benutzer, Rollen und Konfigurationen).

Erstellen Sie eine Datei main.bicep, und kopieren Sie den folgenden Bicep-Datei in diese Datei.

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

In der Bicep-Datei sind die folgenden Ressourcen definiert:

Bereitstellen der Bicep-Datei

Sie können entweder die Azure-Befehlszeilenschnittstelle oder Azure PowerShell zum Bereitstellen der Bicep-Datei verwenden.

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

Sie werden aufgefordert, die folgenden Werte einzugeben:

  • serverName: Geben Sie einen eindeutigen Namen ein, der Ihre Azure Database for PostgreSQL-Flexible Serverinstanz identifiziert. Beispiel: mydemoserver-pg. Der Domänenname postgres.database.azure.com wird an den angegebenen Servernamen angefügt. Der Servername darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Er muss 3 bis 63 Zeichen umfassen.
  • administratorLogin: geben Sie Ihr eigenes Anmeldekonto für die Verbindungsherstellung mit dem Server ein. Beispiel: myadmin. Der Administratoranmeldename darf nicht azure_superuser, azure_pg_admin, admin, administrator, root, guest oder public lauten. Er kann nicht mit pg_ beginnen.
  • administratorLoginPassword: geben Sie ein neues Kennwort für das Serveradministratorkonto ein. Es muss zwischen acht und 128 Zeichen lang sein. Das Kennwort muss Zeichen aus drei der folgenden Kategorien enthalten: Englische Großbuchstaben, englische Kleinbuchstaben, Zahlen (0 bis 9) und nicht alphanumerische Zeichen (!, $, #, % usw.).

Überprüfen der bereitgestellten Ressourcen

Verwenden Sie das Azure-Portal, die Azure CLI oder Azure PowerShell, um die Bereitstellung und die bereitgestellten Ressourcen zu überprüfen.

az resource list --resource-group exampleRG

Bereinigen von Ressourcen

Behalten Sie die Ressourcengruppe, den Server und die Einzeldatenbank, wenn Sie mit Verwandte Inhalte fortfahren möchten. Das Referenzmaterial zeigt, wie Sie mithilfe verschiedener Methoden eine Verbindung mit Ihrer Datenbank herstellen und die Datenbank abfragen.

So löschen Sie die Ressourcengruppe:

az group delete --name exampleRG

Zugehöriger Inhalt