Cluster Manager: كيفية إدارة Cluster Manager في Operator Nexus

az networkcloud clustermanager create \
    --name "$CLUSTER_MANAGER_NAME" \
    --location "$LOCATION" \
    --analytics-workspace-id "$LAW_NAME" \
    --fabric-controller-id "$NFC_ID" \
    --managed-resource-group-configuration name="$MRG_NAME" location="$MRG_LOCATION" \
    --tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2"
    --resource-group "$CLUSTER_MANAGER_RG"
    --subscription "$SUB_ID"

الوسيطات:

• --name أو -n [مطلوب] - اسم Cluster Manager.
• --resource-group أو -g [مطلوب] - اسم مجموعة الموارد. يمكنك تكوين مجموعة الموارد الافتراضية باستخدام az configure --defaults group=<name>.
• --fabric-controller-id [مطلوب] - معرف المورد لوحدة تحكم نسيج الشبكة المقترنة ب Cluster Manager.
• --analytics-workspace-id - معرف المورد لمساحة عمل Log Analytics المستخدمة لمجموعة السجلات
• --location أو -l - منطقة Azure حيث يتم إنشاء Cluster Manager. القيم من: az account list -locations. يمكنك تكوين الموقع الافتراضي باستخدام az configure --defaults location="$LOCATION".
• --managed-resource-group-configuration - تكوين مجموعة الموارد المدارة المرتبطة بالمورد.
  • الاستخدام: --managed-resource-group-configuration location=XX name=XX
  • الموقع: منطقة مجموعة الموارد المدارة. إذا لم يتم تحديدها، يتم اختيار منطقة المورد الأصل.
  • name: اسم مجموعة الموارد المدارة. إذا لم يتم تحديده، يتم إنشاء اسم فريد تلقائيا.
• wait / --no-wait - انتظر حتى يكتمل الأمر أو لا تنتظر حتى تنتهي العملية طويلة الأمد.
• --tags - علامات مفصولة بمسافة: key[=value] [key[=value]...]. استخدام '' لمسح العلامات الموجودة
• --subscription - اسم الاشتراك أو معرفه. يمكنك تكوين الاشتراك الافتراضي باستخدام az account set -s NAME_OR_ID.
• --mi-system-assigned - تمكين الهوية المدارة المعينة من قبل النظام.
• --mi-user-assigned - معرفات الموارد المفصولة بمسافة للهويات المدارة المعينة من قبل المستخدم المراد إضافتها.
• --if-match / if-none-match - حدد قيمة ETag التي شوهدت مؤخرا لمنع الكتابة فوق التغييرات المتزامنة عن طريق الخطأ. يتم إرجاع ETag كخاصية المورد بمجرد إنشاء المورد ويمكن استخدامه في عمليات التحديث.

الوسيطات الشائعة المتوفرة لكل أمر Azure CLI:

• --debug - يطبع معلومات مفصلة حول تنفيذ CLI المستخدم لأغراض تصحيح الأخطاء. إذا وجدت خطأ، فوفر الإخراج الذي تم إنشاؤه باستخدام العلامة --debug عند إرسال تقرير خطأ.
• --output أو -o - يحدد تنسيق الإخراج. تنسيقات الإخراج المتوفرة هي Json وJsonc (JSON الملونة) وtsv (قيم مفصولة بعلامات الجدولة) والجدول (جداول ASCII القابلة للقراءة من قبل الإنسان) وyml. بشكل افتراضي، يقوم CLI بإخراج Json.
• --query - يستخدم لغة استعلام JMESPath لتصفية الإخراج الذي تم إرجاعه من خدمات Azure.

$TAGS_HASH = @{
  tag1 = "true"
  tag2 = "false"
}

New-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -Location $LOCATION -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID -AnalyticsWorkspaceId $LAW_NAME -ManagedResourceGroupConfigurationName $MRG_NAME -ManagedResourceGroupConfigurationLocation $MRG_LOCATION -FabricControllerId $NFC_ID -Tag $TAGS_HASH

المعلمات:

• -Name - اسم مدير نظام المجموعة.
• -ResourceGroupName - اسم مجموعة الموارد.
• -SubscriptionId - معرف الاشتراك الهدف.
• -FabricControllerId - معرف المورد لوحدة تحكم النسيج التي تحتوي على تعيين واحد إلى واحد مع مدير نظام المجموعة.
• -Location - الموقع الجغرافي حيث يعيش المورد.
• -AnalyticsWorkspaceId - معرف المورد لمساحة عمل Log Analytics المستخدمة لمجموعة السجلات.
• -ManagedResourceGroupConfigurationLocation - موقع مجموعة الموارد المدارة. إذا لم يتم تحديده، يتم اختيار موقع المورد الأصل.
• -ManagedResourceGroupConfigurationName - اسم مجموعة الموارد المدارة. إذا لم يتم تحديده، يتم إنشاء الاسم الفريد تلقائيا.
• -Tag - Hashtable من علامات الموارد.

لإنشاء Cluster Manager عبر قالب ARM، تحتاج إلى توفير ملف قالب (clusterManager.jsonc) وملف معلمة (clusterManager.parameters.jsonc).

يمكنك العثور على أمثلة على هذين الملفين هنا:

• clusterManager.jsonc
• clusterManager.parameters.jsonc

1. افتح مستعرض ويب وانتقل إلى مدخل Microsoft Azure وسجل الدخول.
2. استخدم شريط البحث في مدخل Microsoft Azure واكتب "نشر قالب مخصص". حدده من الخدمات المتوفرة.
3. انقر فوق إنشاء القالب الخاص بك في المحرر.
4. انقر فوق تحميل الملف. حدد موقع ملف قالب clusterManager.jsonc وقم بتحميله.
5. انقر فوق حفظ.
6. انقر فوق تحرير المعلمات.
7. انقر فوق تحميل الملف. حدد موقع ملف معلمات clusterManager.parameters.jsonc وقم بتحميله.
8. انقر فوق حفظ.
9. حدد الاشتراك الصحيح.
10. ابحث عن مجموعة الموارد إذا كانت موجودة بالفعل، أو قم بإنشاء جديد.
11. تأكد من صحة كافة تفاصيل المثيل.
12. انقر فوق مراجعة + إنشاء.

يسرد هذا الأمر Cluster Managers في مجموعة الموارد المحددة.

az networkcloud clustermanager list --resource-group "$CLUSTER_MANAGER_RG"

يسرد هذا الأمر Cluster Managers في الاشتراك المحدد.

az networkcloud clustermanager list  --subscription "$SUB_ID"

يعرض هذا الأمر خصائص Cluster Manager المحدد.

az networkcloud clustermanager show \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

يسرد هذا الأمر Cluster Managers في مجموعة الموارد المحددة.

 Get-AzNetworkCloudClusterManager -ResourceGroupName "$CLUSTER_MANAGER_RG"

يسرد هذا الأمر Cluster Managers في الاشتراك المحدد.

 Get-AzNetworkCloudClusterManager -SubscriptionId "$SUB_ID"

يعرض هذا الأمر خصائص Cluster Manager المحددة بتنسيق Json.

 Get-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME" -ResourceGroupName "$CLUSTER_MANAGER_RG" -SubscriptionId "$SUB_ID" | ConvertTo-Json

لعرض Cluster Managers، استخدم Portal أو CLI أو PowerShell.

يقوم هذا الأمر بتحديث Cluster Managers في مجموعة الموارد المحددة.

az networkcloud clustermanager update \
    --name "$CLUSTER_MANAGER_NAME" \
    --tags $TAG_KEY1="$TAG_VALUE1" $TAG_KEY2="$TAG_VALUE2" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

يمكن إدارة هوية Cluster Manager عبر CLI باستخدام az networkcloud clustermanager identity الأوامر الفرعية.

يعرض هذا الأمر الهويات المعينة حاليا.

az networkcloud clustermanager identity show \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

يضيف هذا الأمر هوية جديدة يعينها المستخدم.

az networkcloud clustermanager identity assign \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"
    --mi-user-assigned "$UAI_RESOURCE_ID"

يضيف هذا الأمر هوية معينة من قبل النظام.

az networkcloud clustermanager identity assign \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"
    --mi-system-assigned

يزيل هذا الأمر الهوية المعينة من قبل المستخدم.

az networkcloud clustermanager identity remove \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"
    --mi-user-assigned "$UAI_RESOURCE_ID"

يزيل هذا الأمر الهوية المعينة من قبل النظام.

az networkcloud clustermanager identity remove \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"
    --mi-system-assigned

$TAGS_HASH = @{
  tag1 = "true"
  tag2 = "false"
}

Update-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID -Tag $TAGS_HASH

يمكن أيضا استخدام القالب المستخدم للإنشاء لتحديث Cluster Manager.

az networkcloud clustermanager delete \
    --name "$CLUSTER_MANAGER_NAME" \
    --resource-group "$CLUSTER_MANAGER_RG" \
    --subscription "$SUB_ID"

Remove-AzNetworkCloudClusterManager -Name "$CLUSTER_MANAGER_NAME -ResourceGroupName $CLUSTER_MANAGER_RG -SubscriptionId $SUB_ID

لحذف Cluster Manager، استخدم Portal أو CLI أو PowerShell.