DownloadSecureFile@1 – Stažení úlohy zabezpečeného souboru verze 1

Článek
07/02/2024

Tuto úlohu použijte ke stažení zabezpečeného souboru do počítače agenta.

Tato úloha slouží ke stažení zabezpečeného souboru do dočasného umístění na počítači agenta.

Pomocí této úlohy můžete stáhnout zabezpečený soubor do dočasného umístění v agentu sestavení nebo verze.

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.

Vstupy

secureFile - Zabezpečený soubor
string. Povinná hodnota.

Určuje název nebo jedinečný identifikátor (GUID) zabezpečeného souboru, který se stáhne do počítače agenta. Po dokončení úlohy kanálu se soubor odstraní.

retryCount - Počet opakování
string. Výchozí hodnota: 8.

Nepovinný parametr. Určuje počet opakování pokusu o stažení zabezpečeného souboru v případě, že se stahování nezdaří.

retryCount - Počet opakování
string. Výchozí hodnota: 5.

Nepovinný parametr. Určuje počet opakování pokusu o stažení zabezpečeného souboru v případě, že se stahování nezdaří.

socketTimeout - Časový limit soketu
string.

Nepovinný parametr. Při stahování žádosti o zabezpečený soubor v Microsoftu tento vstup určuje časový limit soketu.

Možnosti řízení úkolů

Všechny úkoly mají kromě vstupů úkolů také možnosti řízení. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Tato úloha definuje následující výstupní proměnné, které můžete využívat v podřízených krocích, úlohách a fázích.

secureFilePath
Určuje umístění zabezpečeného souboru, který byl stažen.

Poznámky

Tuto úlohu použijte v kanálu ke stažení zabezpečeného souboru do počítače agenta. Při zadávání názvu souboru (pomocí secureFile vstupu) použijte místo skutečného názvu souboru název, který jste zadali při nahrávání.

Po stažení použijte name hodnotu, která je nastavená v úloze (nebo "Název odkazu" v klasickém editoru) a odkazujte na cestu k zabezpečenému souboru na počítači agenta. Pokud má úkol například název mySecureFile, lze na jeho cestu v kanálu odkazovat jako $(mySecureFile.secureFilePath). Případně stažené zabezpečené soubory najdete v adresáři zadaném nástrojem $(Agent.TempDirectory). Podívejte se na úplný příklad níže.

Po dokončení úlohy kanálu, ať už je úspěšná, neúspěšná nebo zrušená, je zabezpečený soubor odstraněn z umístění pro stahování.

Tuto úlohu není nutné používat u úloh Instalace certifikátu Apple nebo Instalace zřizovacího profilu Apple , protože tyto úlohy automaticky stahují, instalují a odstraňují (na konci úlohy kanálu) zabezpečený soubor.

Tato úloha aktuálně podporuje pouze jeden souborový úkol na instanci.

Příklady

Tento příklad stáhne soubor zabezpečeného certifikátu a nainstaluje ho do adresáře důvěryhodné certifikační autority (CA) v Linuxu:

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

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Tato úloha se spustí pomocí následujících omezení příkazů: restricted
Nastavitelné proměnné	Tato úloha má oprávnění k nastavení následujících proměnných: secureFilePath
Verze agenta	2.182.1 nebo vyšší
Kategorie úloh	Nástroj

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	Agent, DeploymentGroup
Požadavky	Žádné
Možnosti	Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze.
Omezení příkazů	Všechny
Nastavitelné proměnné	Všechny
Verze agenta	2.116.0 nebo vyšší
Kategorie úloh	Nástroj

Sdílet prostřednictvím