FtpUpload@1 - Tugas unggahan FTP v1

Gunakan tugas ini untuk mengunggah file ke komputer jarak jauh menggunakan FTP atau dengan aman dengan FTPS.

Sintaks

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

Input

credentialsOption - Metode Autentikasi
Alias input: credsType. string. Wajib diisi. Nilai yang diizinkan: serviceEndpoint (koneksi layanan FTP), inputs (Masukkan kredensial). Nilai default: serviceEndpoint.

Menentukan metode autentikasi. Gunakan koneksi layanan FTP atau masukkan kredensial koneksi.

serverEndpoint - Koneksi Layanan FTP
string. Diperlukan saat credsType = serviceEndpoint.

Menentukan koneksi layanan untuk server FTP. Untuk membuatnya, klik tautan Kelola dan buat koneksi layanan generik baru, lalu masukkan URL server FTP untuk URL server, misalnya ftp://server.example.com, dan kredensial yang diperlukan.

Koneksi aman akan selalu dibuat terlepas dari protokol yang ditentukan (ftp:// atau ftps://) jika server target mendukung FTPS. Untuk hanya mengizinkan koneksi aman, gunakan ftps:// protokol, misalnya ftps://server.example.com. Connections ke server yang tidak mendukung FTPS akan gagal jika ftps:// ditentukan.

serverUrl - Server URL
string. Diperlukan saat credsType = inputs.

Menentukan URL untuk server FTP.

username - Username
string. Diperlukan saat credsType = inputs.

Menentukan nama pengguna untuk koneksi FTP.

password - Password
string. Diperlukan saat credsType = inputs.

Menentukan kata sandi untuk koneksi FTP.

rootDirectory - Folder akar
Alias input: rootFolder. string. Wajib diisi.

Menentukan folder sumber untuk mengunggah file.

filePatterns - Pola file
string. Wajib diisi. Nilai default: **.

Menentukan jalur file atau pola file yang akan diunggah. String mendukung beberapa baris pola minimatch. Pelajari selengkapnya tentang pola pencocokan file.

remoteDirectory - Direktori jarak jauh
Alias input: remotePath. string. Wajib diisi. Nilai default: /upload/$(Build.BuildId)/.

Menentukan direktori pada server FTP jarak jauh tempat tugas mengunggah file.

clean - Menghapus direktori jarak jauh
boolean. Nilai default: false.

Menghapus direktori jarak jauh, termasuk isinya, sebelum mengunggah.

cleanContents - Menghapus konten direktori jarak jauh
boolean. Opsional. Gunakan saat clean = false. Nilai default: false.

Menghapus semua konten secara rekursif di direktori jarak jauh sebelum mengunggah. Direktori yang ada tidak akan dihapus. Untuk performa yang lebih baik, gunakan clean sebagai gantinya.

overwrite - Menimpa
boolean. Nilai default: true.

Menimpa file yang ada di direktori jarak jauh.

preservePaths - Mempertahankan jalur file
boolean. Nilai default: false.

Jika dipilih, struktur direktori lokal relatif dibuat ulang di bawah direktori jarak jauh tempat file diunggah. Jika tidak, file diunggah langsung ke direktori jarak jauh tanpa membuat subdirektori tambahan.

Misalnya, folder sumber Anda adalah /home/user/source/, yang berisi file foo/bar/foobar.txt, dan direktori jarak jauh Anda adalah: /uploads/. Jika boolean ini dipilih, file diunggah ke /uploads/foo/bar/foobar.txt. Jika boolean ini tidak dipilih, file diunggah ke /uploads/foobar.txt.

trustSSL - Percayai sertifikat server
boolean. Nilai default: false.

Mempercayai sertifikat SSL server FTP dengan ftps://, meskipun ditandatangani sendiri atau tidak dapat divalidasi oleh otoritas sertifikat (CA).

Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tidak ada.

Keterangan

Gunakan tugas ini untuk mengunggah file ke komputer jarak jauh menggunakan FTP atau dengan aman dengan FTPS.

Catatan

Ada versi yang lebih baru dari tugas ini yang tersedia di FtpUpload@2.

Di mana saya dapat mempelajari selengkapnya tentang pola pencocokan file?

• Referensi pola pencocokan file

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Tugas ini berjalan menggunakan pembatasan perintah berikut: dibatasi
Variabel yang dapat diatur	Tugas ini memiliki izin untuk mengatur variabel berikut: Pengaturan variabel dinonaktifkan
Versi agen	2.182.1 atau lebih tinggi
Kategori tugas	Utilitas