DownloadSecureFile@1 - Unduh tugas file aman v1

Artikel
07/02/2024

Gunakan tugas ini untuk mengunduh file aman ke komputer agen.

Gunakan tugas ini untuk mengunduh file aman ke lokasi sementara pada komputer agen.

Gunakan tugas ini untuk mengunduh file aman ke lokasi sementara pada agen build atau rilis.

Sintaks

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

Input

secureFile - File Aman
string. Wajib diisi.

Menentukan nama atau pengidentifikasi unik (GUID) dari file aman yang diunduh ke komputer agen. File dihapus ketika pekerjaan alur selesai.

retryCount - Jumlah Coba Lagi
string. Nilai default: 8.

Opsional. Menentukan berapa kali untuk mencoba lagi mengunduh file aman jika pengunduhan gagal.

retryCount - Jumlah Coba Lagi
string. Nilai default: 5.

Opsional. Menentukan berapa kali untuk mencoba lagi mengunduh file aman jika pengunduhan gagal.

socketTimeout - Batas Waktu Soket
string.

Opsional. Saat mengunduh permintaan file aman di Microsoft, input ini menentukan batas waktu untuk soket.

Opsi kontrol tugas

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

Variabel output

Tugas ini mendefinisikan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

secureFilePath
Menentukan lokasi file aman yang diunduh.

Keterangan

Gunakan tugas ini dalam alur untuk mengunduh file aman ke mesin agen. Saat menentukan nama file (menggunakan secureFile input), gunakan nama yang Anda tentukan saat mengunggahnya, bukan nama file yang sebenarnya.

Setelah diunduh, gunakan name nilai yang diatur pada tugas (atau "Nama referensi" di editor klasik) untuk mereferensikan jalur ke file aman pada komputer agen. Misalnya, jika tugas diberi nama mySecureFile, jalurnya dapat dirujuk dalam alur sebagai $(mySecureFile.secureFilePath). Atau, file aman yang diunduh dapat ditemukan di direktori yang diberikan oleh $(Agent.TempDirectory). Lihat contoh lengkap di bawah ini.

Ketika pekerjaan alur selesai, apakah berhasil, gagal, atau dibatalkan, file aman dihapus dari lokasi unduhannya.

Tidak perlu menggunakan tugas ini dengan tugas Instal Sertifikat Apple atau Instal Profil Provisi Apple karena secara otomatis mengunduh, menginstal, dan menghapus (di akhir pekerjaan alur) file aman.

Tugas ini saat ini hanya mendukung satu tugas file per instans.

Contoh

Contoh ini mengunduh file sertifikat aman dan menginstalnya ke direktori otoritas sertifikat (CA) tepercaya di 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/

Persyaratan

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan 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: secureFilePath
Versi agen	2.182.1 atau lebih tinggi
Kategori tugas	Utilitas

Persyaratan	Deskripsi
Jenis alur	YAML, Build klasik, Rilis klasik
Berjalan pada	Agen, DeploymentGroup
Permintaan	Tidak ada
Kemampuan	Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah	Apa pun
Variabel yang dapat diatur	Apa pun
Versi agen	2.116.0 atau lebih tinggi
Kategori tugas	Utilitas

Bagikan melalui