مشاركة عبر

FtpUpload@2 - مهمة تحميل FTP v2

  • مقالة

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

بناء الجملة

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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. 
    #implicitFTPS: false # boolean. Use implicit FTPS. Default: false.
    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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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.
    #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. ستفشل الاتصالات بالخوادم التي لا تدعم FTPS إذا ftps:// تم تحديدها.


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

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


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

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


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

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


implicitFTPS - استخدام FTPS الضمني
boolean. القيمة الافتراضية: false.


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

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


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

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


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

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


enableUtf8 - تمكين دعم UTF8
boolean. القيمة الافتراضية: false.

تمكين دعم UTF-8 لاتصال FTP (OPTS UTF8 ON).


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

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


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

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


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).


customCmds - أوامر FTP
string.

أوامر FTP الاختيارية التي سيتم إرسالها إلى خادم FTP البعيد عند الاتصال.


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

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

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

لا شيء

الملاحظات

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

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

المتطلبات

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

راجع أيضًا