Partager via


Démarrage rapide : Utiliser un modèle Bicep pour créer un cluster élastique avec Azure Database pour PostgreSQL

Azure Database pour PostgreSQL avec clusters élastiques est un service managé que vous utilisez pour exécuter, gérer et mettre à l’échelle des bases de données PostgreSQL hautement disponibles dans le cloud avec une fonctionnalité de scale-out horizontale. Vous pouvez utiliser un modèle Bicep pour approvisionner votre instance de clusters élastiques de serveurs flexibles Azure Database pour PostgreSQL.

Bicep est un langage spécifique à un domaine (DSL) qui utilise la syntaxe déclarative pour déployer des ressources Azure. Il fournit une syntaxe concise, une cohérence des types fiable et une prise en charge de la réutilisation du code. Bicep offre la meilleure expérience de création pour vos solutions d’infrastructure en tant que code dans Azure.

Prerequisites

Un compte Azure avec un abonnement actif. Créez-en un gratuitement.

Passer en revue le modèle Bicep

Une instance de cluster élastique serveur flexible Azure Database pour PostgreSQL est la ressource parente d’une base de données distribuée au sein d’une région. Elle fournit l’étendue des stratégies de gestion qui s’appliquent au cluster : pare-feu, utilisateurs, rôles et configurations.

Créez un elastic-cluster-template.bicep fichier et copiez le script suivant dans celui-ci.

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

Ces ressources sont définies dans le fichier Bicep :

Déployer le fichier Bicep

Utilisez Azure CLI ou Azure PowerShell pour déployer le fichier Bicep.

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

Vous êtes invité à entrer ces valeurs :

  • clusterName : entrez un nom unique qui identifie votre instance de cluster élastique serveur flexible Azure Database pour PostgreSQL. Le nom postgres.database.azure.com de domaine est ajouté au nom de cluster que vous fournissez. Le nom du cluster ne peut contenir que des lettres minuscules, des chiffres et le caractère de trait d’union (-). Il doit contenir entre 3 et 63 caractères.
  • administratorLogin : entrez votre propre compte d’authentification à utiliser lorsque vous vous connectez au serveur. Par exemple : clusterAdmin. Le nom d’authentification administrateur ne peut pas être azure_superuser, , azure_pg_adminadmin, administrator, root, guestou public. Il ne peut pas commencer par pg_.
  • administratorLoginPassword : renseignez un nouveau mot de passe pour le compte Administrateur du serveur. Il doit contenir entre 8 et 128 caractères. Votre mot de passe doit contenir des caractères appartenant à trois des catégories suivantes : lettres majuscules, lettres minuscules, chiffres (0 à 9) et caractères non alphanumériques (!, $, #, %, etc.).

Passer en revue les ressources déployées

Suivez ces étapes pour vérifier si votre cluster élastique serveur flexible Azure Database pour PostgreSQL a été créé.

  1. Dans le portail Azure, recherchez et sélectionnez Azure Database pour PostgreSQL - Serveurs flexibles.
  2. Dans la liste de bases de données, sélectionnez votre nouveau serveur pour afficher la page Vue d’ensemble pour gérer votre cluster élastique.

Note

Conservez ce groupe de ressources et le cluster élastique si vous souhaitez l’utiliser pour continuer avec les étapes suggérées suivantes répertoriées dans la section Contenu associé . Les étapes suivantes vous montrent comment utiliser des clusters élastiques avec différents modèles et conceptions de partitionnement d’application.

Nettoyer les ressources

Lorsque vous avez terminé avec votre environnement de cluster élastique, supprimez votre ressource de cluster élastique.

Pour supprimer le cluster élastique, procédez comme suit :

Dans le portail, sélectionnez le cluster élastique que vous souhaitez supprimer.

  1. À partir de la page Vue d’ensemble, sélectionnez Supprimer.
  2. Passez en revue les détails de votre ressource et reconnaissez la demande de suppression pour confirmer l’opération de suppression en cochant la case.
  3. Sélectionnez Supprimer.