Freigeben über

Schnellstart: Verwenden einer ARM-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 Azure Resource Manager-Vorlage (ARM-Vorlage) verwenden, um eine elastische Clusterinstanz zu erstellen.

Eine Azure Resource Manager-Vorlage ist eine JSON (JavaScript Object Notation)-Datei, welche die Infrastruktur und die Konfiguration für Ihr Projekt definiert. Die Vorlage verwendet eine deklarative Syntax. Sie beschreiben Ihre geplante Bereitstellung, ohne die Abfolge der Programmierbefehle zu schreiben, mit denen die Bereitstellung erstellt wird.

Azure Resource Manager ist der Bereitstellungs- und Verwaltungsdienst für Azure. Er bietet eine Verwaltungsebene, die das Erstellen, Aktualisieren und Löschen von Ressourcen in Ihrem Azure-Konto ermöglicht. Mithilfe von Verwaltungsfeatures wie Zugriffssteuerung, Sperren und Tags können Sie Ihre Ressourcen nach der Bereitstellung schützen und organisieren. Informationen zu Azure Resource Manager-Vorlagen finden Sie in der Übersicht über die Vorlagenbereitstellung.

Voraussetzungen

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

Überprüfen der Vorlage

Bei einer Instanz von Azure Database for PostgreSQL – flexibler Server handelt es sich um die übergeordnete Ressource für verteilte Datenbanken 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.json Datei, und kopieren Sie das folgende JSON-Skript darin.

{
  "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "administratorLogin": {
      "type": "string"
    },
    "administratorLoginPassword": {
      "type": "securestring"
    },
    "location": {
      "type": "string",
      "defaultValue": "canadacentral"
    },
    "clusterName": {
      "type": "string"
    },
    "serverEdition": {
      "type": "string",
      "defaultValue": "GeneralPurpose"
    },
    "storageSizeGB": {
      "type": "int",
      "defaultValue": 64
    },
    "haEnabled": {
      "type": "string",
      "defaultValue": "Disabled"
    },
    "availabilityZone": {
      "type": "string",
      "defaultValue": "1"
    },
    "backupRetentionDays": {
      "type": "int",
      "defaultValue": 7
    },
    "skuName": {
      "type": "string",
      "defaultValue": "Standard_D4ds_v5"
    },
    "clusterSize": {
      "type": "int",
      "defaultValue": 2
    },
    "guid": {
      "type": "string",
      "defaultValue": "[newGuid()]"
    },
    "firewallRules": {
      "type": "object",
      "defaultValue": {
        "rules": [
          {
            "name": "AllowAll",
            "startIPAddress": "0.0.0.0",
            "endIPAddress": "255.255.255.255"
          }
        ]
      }
    },
    "network": {
      "type": "object",
      "defaultValue": { "publicNetworkAccess": "Enabled" }
    }
  },
  "variables": {
    "firewallRules": "[parameters('firewallRules').rules]"
  },
  "resources": [
    {
      "apiVersion": "2025-08-01",
      "location": "[parameters('location')]",
      "name": "[parameters('clusterName')]",
      "properties": {
        "createMode": "Default",
        "version": "16",
        "administratorLogin": "[parameters('administratorLogin')]",
        "administratorLoginPassword": "[parameters('administratorLoginPassword')]",
        "availabilityZone": "[parameters('availabilityZone')]",
        "Storage": {
          "StorageSizeGB": "[parameters('storageSizeGB')]",
          "Autogrow": "Disabled"
        },
        "Network": "[if(empty(parameters('network')), json('null'), parameters('network'))]",
        "Backup": {
          "backupRetentionDays": "[parameters('backupRetentionDays')]",
          "geoRedundantBackup": "Disabled"
        },
        "highAvailability": {
          "mode": "[parameters('haEnabled')]"
        },
        "cluster": {
          "clusterSize": "[parameters('clusterSize')]"
        }
      },
      "sku": {
        "name": "[parameters('skuName')]",
        "tier": "[parameters('serverEdition')]"
      },
      "type": "Microsoft.DBforPostgreSQL/flexibleServers"
    },
    {
      "condition": "[greater(length(variables('firewallRules')), 0)]",
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2019-08-01",
      "name": "[concat('firewallRules-', parameters('guid'), '-', copyIndex())]",
      "copy": {
        "count": "[if(greater(length(variables('firewallRules')), 0), length(variables('firewallRules')), 1)]",
        "mode": "Serial",
        "name": "firewallRulesIterator"
      },
      "dependsOn": [
        "[concat('Microsoft.DBforPostgreSQL/flexibleServers/', parameters('clusterName'))]"
      ],
      "properties": {
        "mode": "Incremental",
        "template": {
          "$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
          "contentVersion": "1.0.0.0",
          "resources": [
            {
              "type": "Microsoft.DBforPostgreSQL/flexibleServers/firewallRules",
              "name": "[concat(parameters('clusterName'),'/',variables('firewallRules')[copyIndex()].name)]",
              "apiVersion": "2025-08-01",
              "properties": {
                "StartIpAddress": "[variables('firewallRules')[copyIndex()].startIPAddress]",
                "EndIpAddress": "[variables('firewallRules')[copyIndex()].endIPAddress]"
              }
            }
          ]
        }
      }
    }
  ]
}

Diese Ressourcen sind in der Vorlage definiert:

Bereitstellen der Vorlage

Wählen Sie Ausprobieren aus dem folgenden PowerShell-Codeblock, um die Azure Cloud Shell zu öffnen.

$clusterName = Read-Host -Prompt "Enter a name for the new Azure Database for PostgreSQL flexible server elastic cluster instance"
$resourceGroupName = Read-Host -Prompt "Enter a name for the new resource group where the elastic cluster will exist"
$adminUser = Read-Host -Prompt "Enter the Azure Database for PostgreSQL flexible server elastic cluster instance's administrator account name"
$adminPassword = Read-Host -Prompt "Enter the administrator password" -AsSecureString
# New-AzResourceGroup -Name $resourceGroupName -Location <AZURE_LOCATION>  Use this command when you need to create a new resource group for your deployment
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName `
    -TemplateFile "elastic-cluster-template.json" `
    -clusterName $clusterName `
    -administratorLogin $adminUser `
    -administratorLoginPassword $adminPassword

Read-Host -Prompt "Press [ENTER] to continue ..."

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

Nächste Schritte

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, können Sie Ihre elastische Clusterressource löschen:

So löschen Sie den elastischen Cluster:

Wählen Sie im Portal die Ressourcengruppe aus, die Sie löschen möchten.

  1. Wählen Sie die Option Ressourcengruppe löschen.
  2. Geben Sie den Namen der Ressourcengruppe ein, um den Löschvorgang zu bestätigen.

Zugehöriger Inhalt

  • Last updated on