FtpUpload@1 - مهمة تحميل FTP v1

استخدم هذه المهمة لتحميل الملفات إلى جهاز بعيد باستخدام FTP أو بشكل آمن مع FTPS.

بناء الجملة

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

الإدخالات

credentialsOption - أسلوب المصادقة
الاسم المستعار للإدخل: credsType. string. مطلوب القيم المسموح بها: serviceEndpoint (اتصال خدمة FTP)، inputs (إدخال بيانات الاعتماد). القيمة الافتراضية: serviceEndpoint.

يحدد أسلوب المصادقة. استخدم اتصال خدمة FTP أو أدخل بيانات اعتماد الاتصال.

serverEndpoint - اتصال خدمة FTP
string. مطلوب عند credsType = serviceEndpoint.

يحدد اتصال الخدمة لخادم FTP. لإنشاء واحد، انقر فوق الارتباط إدارة وإنشاء اتصال خدمة عام جديد، ثم أدخل عنوان URL لخادم FTP لعنون URL للخادم، على سبيل المثال ftp://server.example.com، وبيانات الاعتماد المطلوبة.

سيتم دائما إجراء اتصالات آمنة بغض النظر عن البروتوكول المحدد (ftp:// أو ftps://) إذا كان الخادم الهدف يدعم FTPS. للسماح بالاتصالات الآمنة ftps:// فقط، استخدم البروتوكول، على سبيل المثال ftps://server.example.com. ستفشل Connections إلى الخوادم التي لا تدعم FTPS إذا ftps:// تم تحديدها.

serverUrl - عنوان URL للخادم
string. مطلوب عند credsType = inputs.

يحدد عنوان URL لخادم FTP.

username - المستخدم
string. مطلوب عند credsType = inputs.

يحدد اسم المستخدم لاتصال FTP.

password - كلمه المرور
string. مطلوب عند credsType = inputs.

تحديد كلمة المرور لاتصال FTP.

rootDirectory - المجلد الجذر
الاسم المستعار للإدخل: rootFolder. string. مطلوب

يحدد المجلد المصدر لتحميل الملفات منه.

filePatterns - أنماط الملفات
string. مطلوب القيمة الافتراضية: **.

يحدد مسارات الملفات أو أنماط الملفات المراد تحميلها. تدعم السلسلة أسطرا متعددة من أنماط المطابقة المصغرة. تعرف على المزيد حول أنماط مطابقة الملفات.

remoteDirectory - الدليل البعيد
الاسم المستعار للإدخل: remotePath. string. مطلوب القيمة الافتراضية: /upload/$(Build.BuildId)/.

يحدد الدليل على خادم FTP البعيد حيث تقوم المهمة بتحميل الملفات.

clean - حذف الدليل البعيد
boolean. القيمة الافتراضية: false.

حذف الدليل البعيد، بما في ذلك محتوياته، قبل التحميل.

cleanContents - مسح محتويات الدليل البعيد
boolean. ‏‏اختياري. استخدم عندما clean = false. القيمة الافتراضية: false.

يحذف بشكل متكرر جميع المحتويات في الدليل البعيد قبل التحميل. لن يتم حذف الدليل الموجود. للحصول على أداء أفضل، استخدم clean بدلا من ذلك.

overwrite - الكتابه
boolean. القيمة الافتراضية: true.

الكتابة فوق الملفات الموجودة في الدليل البعيد.

preservePaths - الاحتفاظ مسارات الملفات
boolean. القيمة الافتراضية: false.

إذا تم تحديده، تتم إعادة إنشاء بنية الدليل المحلي النسبي ضمن الدليل البعيد حيث يتم تحميل الملفات. وإلا، يتم تحميل الملفات مباشرة إلى الدليل البعيد دون إنشاء أدلة فرعية إضافية.

على سبيل المثال، افترض أن المجلد المصدر الخاص بك هو /home/user/source/، والذي يحتوي على الملف foo/bar/foobar.txt، والدليل البعيد الخاص بك هو: /uploads/. إذا تم تحديد هذا المنطقي، يتم تحميل الملف إلى /uploads/foo/bar/foobar.txt. إذا لم يتم تحديد هذا المنطقي، يتم تحميل الملف إلى /uploads/foobar.txt.

trustSSL - شهادة خادم الثقة
boolean. القيمة الافتراضية: false.

يثق في شهادة SSL لخادم FTP مع ftps://، حتى إذا كانت موقعة ذاتيا أو لا يمكن التحقق من صحتها من قبل مرجع مصدق (CA).

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

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

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

لا شيء

الملاحظات

استخدم هذه المهمة لتحميل الملفات إلى جهاز بعيد باستخدام FTP أو بشكل آمن مع FTPS.

ملاحظة

يتوفر إصدار أحدث من هذه المهمة في FtpUpload@2.

أين يمكنني معرفة المزيد حول أنماط مطابقة الملفات؟

• مرجع أنماط مطابقة الملفات

المتطلبات

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