مشاركة عبر

DownloadSecureFile@1 - تنزيل مهمة ملف آمن v1

  • مقالة

استخدم هذه المهمة لتنزيل ملف آمن إلى جهاز العامل.

استخدم هذه المهمة لتنزيل ملف آمن إلى موقع مؤقت على جهاز العامل.

استخدم هذه المهمة لتنزيل ملف آمن إلى موقع مؤقت على عامل الإنشاء أو الإصدار.

بناء الجملة

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '8' # string. Retry Count. Default: 8.
    #socketTimeout: # string. Socket Timeout.

# Download secure file v1
# Download a secure file to the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File. 
    #retryCount: '5' # string. Retry Count. Default: 5.

# Download secure file v1
# Download a secure file to a temporary location on the agent machine.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File.

# Download Secure File v1
# Download a secure file to a temporary location on the build or release agent.
- task: DownloadSecureFile@1
  inputs:
    secureFile: # string. Required. Secure File.

الإدخالات

secureFile - ملف آمن
string. مطلوب

يحدد الاسم أو المعرف الفريد (GUID) للملف الآمن الذي يتم تنزيله إلى جهاز العامل. يتم حذف الملف عند اكتمال مهمة البنية الأساسية لبرنامج ربط العمليات التجارية.


retryCount - عدد مرات إعادة المحاولة
string. القيمة الافتراضية: 8.

‏‏اختياري. يحدد عدد مرات إعادة محاولة تنزيل ملف آمن إذا فشل التنزيل.


retryCount - عدد مرات إعادة المحاولة
string. القيمة الافتراضية: 5.

‏‏اختياري. يحدد عدد مرات إعادة محاولة تنزيل ملف آمن إذا فشل التنزيل.


socketTimeout - مهلة مأخذ التوصيل
string.

‏‏اختياري. عند تنزيل طلب ملف آمن في Microsoft، يحدد هذا الإدخال مهلة مأخذ التوصيل.


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

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

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

تحدد هذه المهمة متغيرات الإخراج التالية، والتي يمكنك استهلاكها في خطوات انتقال البيانات من الخادم والوظائف والمراحل.

secureFilePath
يحدد موقع الملف الآمن الذي تم تنزيله.

الملاحظات

استخدم هذه المهمة في البنية الأساسية لبرنامج ربط العمليات التجارية لتنزيل ملف آمن إلى جهاز العامل. عند تحديد اسم الملف (باستخدام secureFile الإدخال)، استخدم الاسم الذي حددته عند تحميله، بدلا من اسم الملف الفعلي.

بمجرد التنزيل، استخدم name القيمة التي تم تعيينها على المهمة (أو "اسم المرجع" في المحرر الكلاسيكي) للإشارة إلى المسار إلى الملف الآمن على جهاز العامل. على سبيل المثال، إذا تم إعطاء المهمة الاسم mySecureFile، يمكن الرجوع إلى مسارها في البنية الأساسية لبرنامج ربط العمليات التجارية ك $(mySecureFile.secureFilePath). بدلا من ذلك، يمكن العثور على الملفات الآمنة التي تم تنزيلها في الدليل الذي يقدمه $(Agent.TempDirectory). راجع مثالا كاملا أدناه.

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

من غير الضروري استخدام هذه المهمة مع تثبيت شهادة Apple أو تثبيت مهام ملف تعريف توفير Apple لأنها تقوم تلقائيا بتنزيل الملف الآمن وتثبيته وحذفه (في نهاية مهمة البنية الأساسية لبرنامج ربط العمليات التجارية).

تدعم هذه المهمة حاليا مهمة ملف واحدة فقط لكل مثيل.

أمثلة

يقوم هذا المثال بتنزيل ملف شهادة آمن وتثبيته إلى دليل المرجع المصدق الموثوق به (CA) على Linux:

- task: DownloadSecureFile@1
  name: caCertificate
  displayName: 'Download CA certificate'
  inputs:
    secureFile: 'myCACertificate.pem'

- script: |
    echo Installing $(caCertificate.secureFilePath) to the trusted CA directory...
    sudo chown root:root $(caCertificate.secureFilePath)
    sudo chmod a+r $(caCertificate.secureFilePath)
    sudo ln -s $(caCertificate.secureFilePath) /etc/ssl/certs/

المتطلبات

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