FtpUpload@2 - Tugas unggahan FTP v2

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

Sintaks

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

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

implicitFTPS - Gunakan FTPS implisit
boolean. Nilai default: false.

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.

enableUtf8 - Mengaktifkan dukungan UTF8
boolean. Nilai default: false.

Mengaktifkan dukungan UTF-8 untuk koneksi FTP (OPTS UTF8 ON).

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

Menghapus direktori jarak jauh, termasuk isinya, sebelum mengunggah.

cleanContents - Menghapus konten direktori jarak jauh
boolean. Pilihan. 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.

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

customCmds - Perintah FTP
string.

Perintah FTP opsional yang akan dikirim ke server FTP jarak jauh saat koneksi.

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.

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

Lihat juga

• Referensi pola pencocokan file