Freigeben über


Schnellstart: Verwenden einer Bicep-Vorlage zum Erstellen eines elastischen Clusters mit Azure-Datenbank für PostgreSQL

Azure Database for PostgreSQL mit elastischen Clustern ist ein verwalteter Dienst, den Sie zum Ausführen, Verwalten und Skalieren hoch verfügbarer PostgreSQL-Datenbanken in der Cloud mit einer horizontalen Skalierungsfunktion verwenden. Sie können eine Bicep-Vorlage verwenden, um Ihre elastische Clusterinstanz von Azure Database for PostgreSQL – Flexible 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 Entwicklungserfahrung 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-Vorlage

Eine elastische Clusterinstanz in der Azure-Datenbank für PostgreSQL Flexible Server ist die übergeordnete Ressource für eine verteilte Datenbank innerhalb einer Region. Sie stellt den Bereich für Verwaltungsrichtlinien bereit, die den Cluster betreffen: Firewalls, Benutzende, Rollen und Konfigurationen.

Erstellen Sie eine elastic-cluster-template.bicep Datei, und kopieren Sie das folgende Skript darin.

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

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

Sie werden aufgefordert, die folgenden Werte einzugeben:

  • clusterName: Geben Sie einen eindeutigen Namen ein, der Ihre Azure-Datenbank für flexible serverlastische Clusterinstanz für PostgreSQL identifiziert. Der Domänenname wird an den von Ihnen angegebenen Clusternamen postgres.database.azure.com angefügt. Der Clustername darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Er muss 3 bis 63 Zeichen umfassen.
  • administratorLogin: Geben Sie Ihr eigenes Authentifizierungskonto ein, das beim Herstellen einer Verbindung mit dem Server verwendet werden soll. Beispiel: clusterAdmin. Der Name der Administratorauthentifizierung kann nicht sein azure_superuser, , azure_pg_admin, admin, , administrator, , root, oder guestpublic. 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–9) und nicht alphanumerische Zeichen (!, $, #, % usw.).

Überprüfen der bereitgestellten Ressourcen

Führen Sie die folgenden Schritte aus, um zu überprüfen, ob Ihre Azure-Datenbank für flexiblen Serverlastencluster für PostgreSQL erstellt wurde.

  1. Suchen Sie im Azure-Portal nach flexiblen Azure-Servern, und wählen Sie Azure-Datenbank für flexible Server für PostgreSQL aus.
  2. Wählen Sie in der Datenbankliste Ihren neuen Server aus, um die Seite "Übersicht" anzuzeigen, um Ihren elastischen Cluster zu verwalten.

Hinweis

Behalten Sie diese Ressourcengruppe und den elastischen Cluster bei, wenn Sie sie verwenden möchten, um mit den nächsten vorgeschlagenen Schritten fortzufahren, die im Abschnitt "Verwandte Inhalte " aufgeführt sind. Die nächsten Schritte zeigen Ihnen, wie Sie elastische Cluster mit verschiedenen Anwendungsshardingmodellen und -designs verwenden.

Bereinigen von Ressourcen

Wenn Sie mit Ihrer elastischen Clusterumgebung fertig sind, löschen Sie Ihre elastische Clusterressource.

Führen Sie die folgenden Schritte aus, um den elastischen Cluster zu löschen:

Wählen Sie im Portal den elastischen Cluster aus, den Sie löschen möchten.

  1. Wählen Sie auf der Seite "Übersicht " die Option "Löschen" aus.
  2. Überprüfen Sie die Ressourcendetails, und bestätigen Sie die Löschanforderung, um den Löschvorgang zu bestätigen, indem Sie das Kontrollkästchen aktivieren.
  3. Klicken Sie auf Löschen.