Compartir a través de

Inicio rápido: Uso de una plantilla de Bicep para crear un clúster elástico con Azure Database for PostgreSQL

Azure Database for PostgreSQL con clústeres elásticos es un servicio administrado que se usa para ejecutar, administrar y escalar bases de datos PostgreSQL de alta disponibilidad en la nube con una funcionalidad de escalabilidad horizontal. Puede usar una plantilla de Bicep para aprovisionar la instancia de clústeres elásticos de servidor flexible de Azure Database for PostgreSQL.

Bicep es un lenguaje específico de dominio (DSL) que usa una sintaxis declarativa para implementar recursos de Azure. Brinda sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

Prerrequisitos

Una cuenta de Azure con una suscripción activa. cree una de forma gratuita.

Revisión de la plantilla de Bicep

Una instancia de clúster elástico de servidor flexible de Azure Database for PostgreSQL es el recurso primario de una base de datos distribuida dentro de una región. Proporciona el ámbito de las directivas de administración que se aplican al clúster: firewall, usuarios, roles y configuraciones.

Cree un elastic-cluster-template.bicep archivo y copie el siguiente script en él.

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

En el archivo de Bicep se definen estos recursos:

Desplegar el archivo Bicep

Use la CLI de Azure o Azure PowerShell para implementar el archivo 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

Se le pide que introduzca estos valores:

  • clusterName: escriba un nombre único que identifique la instancia de clúster elástico de servidor flexible de Azure Database for PostgreSQL. El nombre postgres.database.azure.com de dominio se anexa al nombre del clúster que proporcione. El nombre del clúster solo puede contener letras minúsculas, números y el carácter guión (-). Debe contener al menos entre tres y 63 caracteres.
  • administratorLogin: escriba su propia cuenta de autenticación que se usará al conectarse al servidor. Por ejemplo: clusterAdmin. El nombre de autenticación de administrador no puede ser azure_superuser, azure_pg_admin, admin, administrator, root, guesto public. No puede empezar por pg_.
  • administratorLoginPassword: Escriba una nueva contraseña para la cuenta de administrador del servidor. Debe tener entre 8 y 128 caracteres. La contraseña debe contener caracteres de tres de las siguientes categorías: letras en mayúsculas del alfabeto inglés, letras en minúscula del alfabeto inglés, números (de cero a nueve) y caracteres no alfanuméricos (!, $, #, %, etc.).

Revisión de los recursos implementados

Siga estos pasos para comprobar si se creó el clúster elástico de servidor flexible de Azure Database for PostgreSQL.

  1. En Azure Portal, busque y seleccione Servidores flexibles de Azure Database for PostgreSQL.
  2. En la lista de bases de datos, seleccione el nuevo servidor para ver la página Información general para administrar el clúster elástico.

Nota:

Mantenga este grupo de recursos y el clúster elástico si desea usarlo para continuar con los siguientes pasos sugeridos que se enumeran en la sección Contenido relacionado . Los pasos siguientes muestran cómo usar clústeres elásticos con diferentes modelos y diseños de particionamiento de aplicaciones.

Limpieza de recursos

Cuando haya terminado con el entorno del clúster elástico, elimine el recurso del clúster elástico.

Para eliminar el clúster elástico, siga estos pasos:

En el portal, seleccione el clúster elástico que desea eliminar.

  1. En la página Información general , seleccione Eliminar.
  2. Revise los detalles del recurso y confirme la solicitud de eliminación para confirmar la operación de eliminación activando la casilla .
  3. Seleccione Eliminar.

Contenido relacionado

  • Last updated on