DownloadSecureFile@1 - Güvenli dosya v1 görevini indirme

Makale
05/16/2024

Aracı makinesine güvenli bir dosya indirmek için bu görevi kullanın.

Aracı makinesinde geçici bir konuma güvenli bir dosya indirmek için bu görevi kullanın.

Derleme veya yayın aracısının geçici bir konumuna güvenli bir dosya indirmek için bu görevi kullanın.

Syntax

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

Girişler

secureFile - Güvenli Dosya
string. Gereklidir.

Aracı makinesine indirilen güvenli dosyanın adını veya benzersiz tanımlayıcısını (GUID) belirtir. İşlem hattı işi tamamlandığında dosya silinir.

retryCount - Yeniden Deneme Sayısı
string. Varsayılan değer: 8.

İsteğe bağlı. İndirme başarısız olursa güvenli bir dosyayı indirmeyi yeniden deneme sayısını belirtir.

retryCount - Yeniden Deneme Sayısı
string. Varsayılan değer: 5.

İsteğe bağlı. İndirme başarısız olursa güvenli bir dosyayı indirmeyi yeniden deneme sayısını belirtir.

socketTimeout - Yuva Zaman Aşımı
string.

İsteğe bağlı. Microsoft'ta güvenli bir dosya isteği indirilirken, bu giriş bir yuvanın zaman aşımını belirtir.

Görev denetimi seçenekleri

Tüm görevlerin, görev girişlerine ek olarak denetim seçenekleri vardır. Daha fazla bilgi için bkz . Denetim seçenekleri ve ortak görev özellikleri.

Çıkış değişkenleri

Bu görev aşağı akış adımlarında, işlerde ve aşamalarda kullanabileceğiniz aşağıdaki çıkış değişkenlerini tanımlar.

secureFilePath
İndirilen güvenli dosyanın konumunu belirtir.

Açıklamalar

Aracı makinesine güvenli bir dosya indirmek için bu görevi işlem hattında kullanın. Dosyanın adını belirtirken (girişi kullanarak secureFile ), dosyayı karşıya yüklerken gerçek dosya adı yerine belirttiğiniz adı kullanın.

İndirildikten sonra, aracı makinesindeki güvenli dosyanın yoluna başvurmak için görevde ayarlanan değeri (veya klasik düzenleyicide "Başvuru adı") kullanın name . Örneğin, göreve adı mySecureFileverilirse, işlem hattında yoluna olarak $(mySecureFile.secureFilePath)başvurulabilir. Alternatif olarak, indirilen güvenli dosyalar tarafından $(Agent.TempDirectory)verilen dizinde bulunabilir. Aşağıda tam bir örniğe bakın.

İşlem hattı işi tamamlandığında, başarılı, başarısız veya iptal edilmiş olsun, güvenli dosya indirme konumundan silinir.

Güvenli dosyayı otomatik olarak indirdikleri, yükledikleri ve sildikleri (işlem hattı işinin sonunda) bu görevi Apple Sertifikasını Yükle veya Apple Sağlama Profili Yükle görevleriyle kullanmak gereksizdir.

Bu görev şu anda örnek başına yalnızca bir dosya görevini destekler.

Örnekler

Bu örnek güvenli bir sertifika dosyasını indirir ve Linux'ta güvenilir bir sertifika yetkilisi (CA) dizinine yükler:

- 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/

Gereksinimler

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Bu görev aşağıdaki komut kısıtlamaları kullanılarak çalıştırılır: kısıtlı
Ayarlanabilir değişkenler	Bu görevin şu değişkenleri ayarlama izni var: secureFilePath
Aracı sürümü	2.182.1 veya üzeri
Görev kategorisi	Yardımcı Program

Gereksinim	Açıklama
İşlem hattı türleri	YAML, Klasik derleme, Klasik sürüm
Üzerinde çalışır	Agent, DeploymentGroup
Talep	Hiçbiri
Özellikler	Bu görev, işteki sonraki görevler için hiçbir talebi karşılamaz.
Komut kısıtlamaları	Herhangi biri
Ayarlanabilir değişkenler	Herhangi biri
Aracı sürümü	2.116.0 veya üzeri
Görev kategorisi	Yardımcı Program

Aracılığıyla paylaş