Quickstart: استخدم قالب Bicep لإنشاء مجموعة مرنة باستخدام Azure Database for PostgreSQL

قاعدة بيانات Azure ل PostgreSQL مع العناقيد المرنة هي خدمة مدارة تستخدمها لتشغيل وإدارة وتوسيع قواعد بيانات PostgreSQL المتوفرة بقوة في السحابة مع إمكانية التوسع الأفقي. يمكنك استخدام قالب Bicep لتوفير قاعدة بيانات Azure الخاصة بك لنسخة PostgreSQL المرنة من العناقيد المرنة للخادم.

Bicep هي لغة المجال المخصصة (DSL) التي تستخدم بناء الجملة التعريفي لتوزيع موارد Azure. توفر بناء جملة مختصر، وسلامة موثوقة من النوع، ودعمًا لإعادة استخدام التعليمة البرمجية. تقدم Bicep أفضل تجربة تأليف لحلول البنية الأساسية باعتبارها تعليمة برمجية في Azure.

Prerequisites

حساب Azure مع اشتراك نشط. أنشئ حسابًا مجانًا.

راجع قالب العضلة ذات الرأسين

قاعدة بيانات Azure لمجموعة الخادم المرنة PostgreSQL هي المورد الأم لقاعدة بيانات موزعة داخل منطقة معينة. يوفر نطاق نهج الإدارة التي تنطبق على نظام المجموعة: جدار الحماية والمستخدمين والأدوار والتكوينات.

أنشئ ملفا elastic-cluster-template.bicep وانسخ النص التالي إليه.

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

يتم تحديد هذه الموارد في ملف Bicep:

• Microsoft.DBforPostgreSQL/flexibleServers

نشر ملف Bicep

استخدم Azure CLI أو Azure PowerShell لنشر ملف 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

تتم مطالبتك بإدخال هذه القيم:

• clusterName: أدخل اسما فريدا يحدد قاعدة بيانات Azure الخاصة بك لمثيل عنقود الخادم المرن PostgreSQL (الخادم المرن Elcc). يتم إلحاق اسم postgres.database.azure.com النطاق باسم العنقود الذي تقدمه. يمكن أن يحتوي اسم العنقود على حروف صغيرة فقط، وأرقام، وحرف الشرطة (-). يجب أن يحتوي على ما لا يقل عن 3 إلى 63 حرفاً.
• تسجيل الدخول للمسؤول: أدخل حساب المصادقة الخاص بك لتستخدمه عند الاتصال بالخادم. على سبيل المثال، clusterAdmin اسم المصادقة الخاص بالمدير لا يمكن أن يكون azure_superuser، azure_pg_admin، admin، administratorrootguestأو .public لا يمكن أن يبدأ ب pg_.
• administratorLoginPassword: أدخل كلمة مرور جديدة لحساب مسؤول الخادم. يجب أن تحتوي على ما بين 8 و128 حرفًا. يجب أن تحتوي كلمة المرور على أحرف من ثلاث فئات من الفئات التالية: الأحرف الإنجليزية الكبيرة والأحرف الإنجليزية الصغيرة والأرقام (من 0 إلى 9) والأحرف غير الأبجدية (!، $، #، ٪، إلخ).

مراجعة الموارد الموزعة

اتبع هذه الخطوات للتحقق مما إذا كان تجمع المرن المرن لخادم Azure Database الخاص بك في PostgreSQL قد تم إنشاؤه.

مدخل Microsoft Azure

1. في مدخل Microsoft Azure، ابحث عن قاعدة بيانات Azure لخوادم PostgreSQL المرنة وحددها.
2. في قائمة قاعدة البيانات، اختر الخادم الجديد لعرض صفحة النظرة العامة لإدارة عنقود المرونة الخاص بك.

المبادره القطريه

يجب عليك إدخال اسم ومجموعة الموارد في العنقود المرن الجديد لعرض تفاصيل قاعدة بيانات Azure الخاصة بك في PostgreSQL مرن للخادم المرن في عنقود المرونة.

$resourceGroupName = Read-Host -Prompt "Enter the resource group where the Azure Database for PostgreSQL flexible server cluster exists"
$clusterName = Read-Host -Prompt "Enter your Azure Database for PostgreSQL flexible server elastic cluster name"
az resource show --resource-group $resourcegroupName --name $clusterName --resource-type "Microsoft.DBforPostgreSQL/flexibleServers"

إشعار

احتفظ بمجموعة الموارد هذه ونظام المجموعة المرن إذا كنت تريد استخدامها لمتابعة الخطوات المقترحة التالية المدرجة في قسم المحتوى المرتبط . توضح لك الخطوات التالية كيفية استخدام المجموعات المرنة مع نماذج وتصميمات مختلفة لتقسيم التطبيقات.

تنظيف الموارد

عندما تنتهي من بيئة العنقود المرنة، احذف مورد عنقود المرنة.

لحذف العنقود المرن، اتبع هذه الخطوات:

Portal

في البوابة، اختر العنقود المرن الذي تريد حذفه.

1. من صفحة النظرة العامة ، اختر الحذف.
2. راجع تفاصيل الموارد، وأكد طلب الحذف لتأكيد عملية الحذف بتحديد مربع الاختيار.
3. حدد حذف.

المبادره القطريه

$resourceGroupName = Read-Host -Prompt "Enter the resource group where the Azure Database for PostgreSQL flexible server exists"
$clusterName = Read-Host -Prompt "Enter your Azure Database for PostgreSQL flexible server elastic cluster name"
az resource delete --resource-type Microsoft.DBforPostgreSQL/flexibleServers `
--name $clusterName --resource-group $resourceGroupName

محتوى ذو صلة

• تصميم قاعدة بيانات متعددة المستأجرين مع مجموعات مرنة.