مشاركة عبر

AzureVmssDeployment@0 - مهمة توزيع v0 لمجموعة مقياس جهاز Azure الظاهري

  • مقالة

تنشر هذه المهمة صورة مجموعة مقياس الجهاز الظاهري.

بناء الجملة

# Azure VM scale set deployment v0
# Deploy a virtual machine scale set image.
- task: AzureVmssDeployment@0
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Update image' # 'Update image' | 'Configure application startup'. Required. Action. Default: Update image.
    vmssName: # string. Required. Virtual Machine scale set name. 
    vmssOsType: # 'Windows' | 'Linux'. Required. OS type. 
  # Image Details
    #imageUrl: # string. Required when action = Update image || action = UpdateImage. Image URL. 
  # Configure start-up
    #customScriptsDirectory: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Custom script directory. 
    #customScript: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Command. 
    #customScriptArguments: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Arguments. 
    #customScriptsStorageAccount: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Azure storage account where custom scripts will be uploaded. 
  # Advanced
    #skipArchivingCustomScripts: false # boolean. Skip Archiving custom scripts. Default: false.

# Azure VM scale set Deployment v0
# Deploy Virtual Machine scale set image.
- task: AzureVmssDeployment@0
  inputs:
  # Azure Details
    azureSubscription: # string. Alias: ConnectedServiceName. Required. Azure subscription. 
    action: 'Update image' # 'Update image' | 'Configure application startup'. Required. Action. Default: Update image.
    vmssName: # string. Required. Virtual Machine scale set name. 
    vmssOsType: # 'Windows' | 'Linux'. Required. OS type. 
  # Image Details
    #imageUrl: # string. Required when action = Update image || action = UpdateImage. Image URL. 
  # Configure start-up
    #customScriptsDirectory: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Custom script directory. 
    #customScript: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Command. 
    #customScriptArguments: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Arguments. 
    #customScriptsStorageAccount: # string. Optional. Use when action = Configure application startup || action = Update image || action = UpdateImage. Azure storage account where custom scripts will be uploaded. 
  # Advanced
    #skipArchivingCustomScripts: false # boolean. Skip Archiving custom scripts. Default: false.

الإدخالات

azureSubscription - اشتراك Azure
الاسم المستعار للإدخل: ConnectedServiceName. string. مطلوب

يحدد اشتراك Azure Resource Manager لمجموعة المقياس.


action - العمل
string. مطلوب القيم المسموح بها: Update image (تحديث مجموعة مقياس الجهاز الظاهري باستخدام صورة)، Configure application startup (تشغيل ملحق الجهاز الظاهري للبرنامج النصي المخصص على مجموعة مقياس الجهاز الظاهري). القيمة الافتراضية: Update image.

التحديثات مقياس جهاز ظاهري تم تعيينه بواسطة الأسلوب المختار، باستخدام صورة VHD و/أو عن طريق تشغيل البرامج النصية للتوزيع/التثبيت باستخدام ملحق الجهاز الظاهري للبرنامج النصي المخصص.

نهج صورة VHD أفضل للتحجيم بسرعة والقيام بالتراجع. عند إنشاء مجموعة مقياس جهاز ظاهري باستخدام صورة مخصصة، يمكن تحديثها بواسطة صورة VHD. سيفشل التحديث إذا تم إنشاء مجموعة مقياس الجهاز الظاهري باستخدام صورة النظام الأساسي/المعرض المتوفرة في Azure.

يعد نهج ملحق الجهاز الظاهري للبرنامج النصي المخصص مفيدا لتكوين ما بعد التوزيع أو تثبيت البرامج أو أي مهمة تكوين/إدارة أخرى. يمكن استخدام نهج ملحق الجهاز الظاهري للبرنامج النصي المخصص لمجموعة مقياس الجهاز الظاهري التي تم إنشاؤها باستخدام صورة مخصصة أو صورة النظام الأساسي/المعرض.


vmssName - اسم مجموعة مقياس الجهاز الظاهري
string. مطلوب

يحدد اسم إعداد مقياس الجهاز الظاهري المراد تحديثه. استخدم إما صورة VHD أو ملحق جهاز ظاهري مخصص للبرنامج النصي.


vmssOsType - نوع نظام التشغيل
string. مطلوب القيم المسموح بها: Windows، . Linux

يحدد نوع نظام التشغيل لمجموعة مقياس الجهاز الظاهري.


imageUrl - عنوان URL للصورة
string. مطلوب عند action = Update image || action = UpdateImage.

يحدد عنوان URL لصورة VHD. إذا كان عنوان URL لكائن ثنائي كبير الحجم لتخزين Azure، فإن موقع حساب التخزين هو نفس موقع مجموعة المقياس.


customScriptsDirectory - دليل البرنامج النصي المخصص
string. ‏‏اختياري. استخدم عندما action = Configure application startup || action = Update image || action = UpdateImage.

‏‏اختياري. المسار إلى الدليل الذي يحتوي على البرنامج النصي المخصص (البرامج النصية) التي يتم تشغيلها باستخدام ملحق الجهاز الظاهري للبرنامج النصي المخصص. يعد نهج الملحق مفيدا لتكوين ما بعد التوزيع أو تثبيت التطبيق/البرنامج أو أي مهمة أخرى لتكوين/إدارة التطبيق. على سبيل المثال، يمكن للبرنامج النصي تعيين متغير بيئة على مستوى الجهاز يستخدمه التطبيق، مثل سلاسل اتصال قاعدة البيانات.


customScript - الامر
string. ‏‏اختياري. استخدم عندما action = Configure application startup || action = Update image || action = UpdateImage.

‏‏اختياري. البرنامج النصي الذي يتم تشغيله باستخدام ملحق الجهاز الظاهري للبرنامج النصي المخصص. يمكن لهذا البرنامج النصي استدعاء البرامج النصية الأخرى في الدليل ويتم استدعاؤه باستخدام الوسيطات التي تم تمريرها أدناه.
بالاقتران مع مثل هذه الوسيطات، يمكن استخدام هذا البرنامج النصي لتنفيذ الأوامر.

على سبيل المثال:

  1. Update-DatabaseConnectionStrings.ps1 -clusterType dev -user $(dbUser) -password $(dbUserPwd)تحديث سلسلة الاتصال في web.config تطبيق الويب.
  2. install-secrets.sh --key-vault-type prod -key serviceprincipalkey ينشئ ملفا مشفرا يحتوي على مفتاح كيان الخدمة.

customScriptArguments - الحجج
string. ‏‏اختياري. استخدم عندما action = Configure application startup || action = Update image || action = UpdateImage.

‏‏اختياري. سيتم استدعاء البرنامج النصي المخصص مع تمرير الوسيطات. يمكن استخدام متغيرات الإنشاء/الإصدار، ما يجعل من السهل استخدام البيانات السرية.


customScriptsStorageAccount - حساب تخزين Azure حيث سيتم تحميل البرامج النصية المخصصة
string. ‏‏اختياري. استخدم عندما action = Configure application startup || action = Update image || action = UpdateImage.

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


skipArchivingCustomScripts - تخطي أرشفة البرامج النصية المخصصة
boolean. القيمة الافتراضية: false.

‏‏اختياري. بشكل افتراضي، تنشئ هذه المهمة أرشيفا مضغوطا للدليل يحتوي على البرامج النصية المخصصة. يؤدي ذلك إلى تحسين الأداء والموثوقية أثناء التحميل إلى تخزين Azure. إذا لم يتم تحديدها، فلن يتم الأرشفة وسيتم تحميل جميع الملفات بشكل فردي.


خيارات التحكم بالمهمة

تحتوي جميع المهام على خيارات التحكم بالإضافة إلى مدخلات المهام الخاصة بها. لمزيد من المعلومات، راجع خيارات التحكم وخصائص المهمة الشائعة.

متغيرات الإخراج

لا شيء

الملاحظات

استخدم هذه المهمة لنشر صورة مجموعة مقياس الجهاز الظاهري.

يتم الإبلاغ عن تنفيذ البرنامج النصي على أنه ناجح، ولكن لم يتم تحديث مثيلات VMSS

تحتوي مجموعات المقاييس على نهج ترقية يحدد كيفية تحديث الأجهزة الظاهرية بأحدث نموذج لمجموعة المقاييس، وإذا تم تعيين نهج الترقية إلى يدوي، فيجب عليك ترقية كل جهاز ظاهري يدويا. لمزيد من المعلومات، راجع كيفية تحديث الأجهزة الظاهرية بأحدث نموذج لمجموعة المقاييس. يمكنك تغيير نهج التحديث أو ترقية كل جهاز ظاهري يدويا. على سبيل المثال، لترقية النهج إلى Automatic، استخدم الأمر Az CLI التالي: az vmss update --set upgradePolicy.mode=Automatic -g <resource group name> -n <vmss name>

خطأ: "تم رفض الإذن: البرنامج النصي غير قابل للتنفيذ"

تحدث هذه المشكلة إذا حاولت تشغيل برنامج نصي مخصص، ولكن البرنامج النصي غير قابل للتنفيذ.

لحل المشكلة، تأكد أولا من أن customScript الإدخال لا يحتوي ./ على أو أي شيء آخر قبل اسم 'test.sh'البرنامج النصي :

    customScript: 'test.sh'

بعد ذلك، حاول إضافة مهمة سطر أوامر قبل مهمة مجموعة مقياس الجهاز الظاهري:

    - task: CmdLine@2
      inputs:
        script: 'chmod 777 $(System.DefaultWorkingDirectory)/test.sh'

المتطلبات

المتطلبات الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على Agent, DeploymentGroup
المطالب بلا
القدرات لا تفي هذه المهمة بأي متطلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر أي
متغيرات Settable أي
إصدار الوكيل 2.0.0 أو أكبر
فئة المهمة نشر