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

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

Syntaxe

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

Vstupy

zabezpečených souborů secureFile -
string. Povinné.

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.

Volitelný. Určuje počet opakování pokusu o stažení zabezpečeného souboru, pokud stahování selže.

socketTimeout - vypršení časového limitu soketu
string.

Volitelný. Při stahování zabezpečeného požadavku na soubor v Microsoftu určuje tento vstup časový limit pro soket.

Možnosti ovládání úloh

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

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í staženého zabezpečeného souboru.

Poznámky

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

Poznámka:

Tento úkol běží na začátku své fáze bez ohledu na to, kde se nachází v rámci své úlohy.

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

Po dokončení úlohy v kanálu, ať už je úspěšná, selže nebo je zrušena, se zabezpečený soubor odstraní z místa stažení.

Tuto úlohu není nutné používat s Instalovat certifikát Apple nebo Instalovat profil zřizování Apple úkoly, protože automaticky stahují, instalují a odstraňují (na konci úlohy kanálu) zabezpečený soubor.

Tato úloha v současné době podporuje pouze jednu úlohu souboru na instanci.

Příklady

Tento příklad stáhne zabezpečený soubor 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, klasické sestavení, klasická verze
Běží na	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 spouští s následujícími omezeními příkazů : omezeno:
nastavitelné proměnné	Tato úloha má oprávnění k nastavit následující proměnné: secureFilePath
Verze agenta	2.182.1 nebo vyšší
Kategorie úkolu	Užitnost