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

Linux

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/ 

Windows

• Import certifikátu do kořenového úložiště CurrentUser:

  ## Download a secure file to the agent machine
  - task: DownloadSecureFile@1
    displayName: 'Download CA certificate'
    inputs:
      secureFile: 'myCACertificate.pem'
  
  - powershell: |
      $certPath = "$(caCertificate.secureFilePath)"
      $certStoreLocation = 'Cert:\CurrentUser\Root'
      Write-Host "Importing certificate $certPath to $certStoreLocation..."
      $params = @{
        FilePath = $certPath
        CertStoreLocation = $certStoreLocation
      }
      Import-Certificate @params
    displayName: 'Import CA certificate to CurrentUser root store'
  

• Import certifikátu do kořenového úložiště LocalMachine:

  ## Download a secure file to the agent machine
  - task: DownloadSecureFile@1
    displayName: 'Download CA certificate'
    inputs:
      secureFile: 'myCACertificate.pem'
  
  - powershell: |
      $certPath = "$(caCertificate.secureFilePath)"
      $certStoreLocation = 'Cert:\LocalMachine\Root'
  
      Write-Host "Importing certificate $certPath to $certStoreLocation..."
      $params = @{
        FilePath = $certPath
        CertStoreLocation = $certStoreLocation
      }
      Import-Certificate @params
    displayName: 'Import CA certificate to LocalMachine root store'
  

Požadavky

Požadavek	Popis
Typy kanálů	YAML, klasické sestavení, klasická verze
Běží na	Agent, skupina nasazení
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