DownloadSecureFile@1 – Ladda ned v1-uppgift för säker fil

Använd den här uppgiften för att ladda ned en säker fil till agentdatorn.

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.

Ingångar

secureFile - säker fil
string. Obligatoriskt.

Anger namnet eller den unika identifieraren (GUID) för den säkra fil som laddas ned till agentdatorn. Filen tas bort när pipelinejobbet är klart.

retryCount - Antal återförsök
string. Standardvärde: 8.

Valfritt. Anger hur många gånger du ska försöka ladda ned en säker fil igen om nedladdningen misslyckas.

socketTimeout - Socket-timeout
string.

Valfritt. När du laddar ned en säker filbegäran i Microsoft anger dessa indata tidsgränsen för en socket.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Den här uppgiften definierar följande utdatavariabler, som du kan använda i underordnade steg, jobb och steg.

secureFilePath
Anger platsen för den skyddade fil som laddades ned.

Anmärkningar

Använd den här uppgiften i en pipeline för att ladda ned en säker fil till agentdatorn. När du anger namnet på filen (med hjälp av secureFile indata) använder du det namn som du angav när du laddade upp den i stället för det faktiska filnamnet.

Anmärkning

Den här aktiviteten körs i början av fasen, oavsett var den finns i jobbet.

När du har laddat ned använder du det name värde som har angetts för uppgiften (eller "Referensnamn" i den klassiska redigeraren) för att referera till sökvägen till den säkra filen på agentdatorn. Om aktiviteten till exempel får namnet mySecureFilekan dess sökväg refereras i pipelinen som $(mySecureFile.secureFilePath). Du kan också hitta nedladdade säkra filer i katalogen som anges av $(Agent.TempDirectory). Se ett fullständigt exempel nedan.

När pipelinejobbet är klart, oavsett om det lyckas, misslyckas eller avbryts, tas den säkra filen bort från nedladdningsplatsen.

Det är inte nödvändigt att använda den här uppgiften med Installera Apple Certificate eller Installera Apple Provisioning Profile uppgifter eftersom de automatiskt laddar ned, installerar och tar bort (i slutet av pipelinejobbet) den säkra filen.

Den här aktiviteten stöder för närvarande endast en filaktivitet per instans.

Exempel

Det här exemplet laddar ned en säker certifikatfil och installerar den i en katalog för betrodd certifikatutfärdare (CA) i 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/ 

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här aktiviteten körs med hjälp av följande kommandobegränsningar: begränsad
variabler som kan	Den här uppgiften har behörighet att ange följande variabler: secureFilePath
Agentversion	2.182.1 eller senare
Aktivitetskategori	Nytta