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

Artikel
07/02/2024

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

Använd den här uppgiften för att ladda ned en säker fil till en tillfällig plats på agentdatorn.

Använd den här uppgiften för att ladda ned en säker fil till en tillfällig plats i bygg- eller versionsagenten.

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.

Indata

secureFile - Säker fil
string. Krävs.

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 försöker ladda ned en säker fil igen om nedladdningen misslyckas.

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

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

socketTimeout - Tidsgräns för socket
string.

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

Alternativ för aktivitetskontroll

Alla aktiviteter har kontrollalternativ utöver sina uppgiftsindata. 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.

Kommentarer

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 indata) secureFile använder du det namn som du angav när du laddade upp den i stället för det faktiska filnamnet.

När du har laddat ned använder du värdet name som anges 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 till 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 onödigt att använda den här uppgiften med uppgifterna Installera Apple-certifikat eller Installera Apple-etableringsprofil eftersom de automatiskt laddar ned, installerar och tar bort (i slutet av pipelinejobbet) den säkra filen.

Den här uppgiften 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
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här uppgiften körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här uppgiften har behörighet att ange följande variabler: secureFilePath
Agentversion	2.182.1 eller senare
Uppgiftskategori	Verktyg

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Valfri
Inställningsbara variabler	Valfri
Agentversion	2.116.0 eller senare
Uppgiftskategori	Verktyg

Dela via