DownloadSecureFile@1 – Task "Sichere Datei v1" herunterladen

Artikel
07/02/2024

Verwenden Sie diese Aufgabe, um eine sichere Datei auf den Agent-Computer herunterzuladen.

Verwenden Sie diese Aufgabe, um eine sichere Datei an einen temporären Speicherort auf dem Agentcomputer herunterzuladen.

Verwenden Sie diese Aufgabe, um eine sichere Datei an einen temporären Speicherort im Build- oder Release-Agent herunterzuladen.

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.

Eingaben

secureFile - Sichere Datei
string. Erforderlich.

Gibt den Namen oder den eindeutigen Bezeichner (GUID) der sicheren Datei an, die auf den Agentcomputer heruntergeladen wird. Die Datei wird gelöscht, wenn der Pipelineauftrag abgeschlossen ist.

retryCount - Anzahl der Wiederholungen
string. Standardwert. 8.

Optional. Gibt an, wie oft das Herunterladen einer sicheren Datei wiederholt werden soll, wenn der Download fehlschlägt.

retryCount - Anzahl der Wiederholungen
string. Standardwert. 5.

Optional. Gibt an, wie oft das Herunterladen einer sicheren Datei wiederholt werden soll, wenn der Download fehlschlägt.

socketTimeout - Sockettimeout
string.

Optional. Beim Herunterladen einer sicheren Dateianforderung in Microsoft gibt diese Eingabe das Timeout für einen Socket an.

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Diese Aufgabe definiert die folgenden Ausgabevariablen, die Sie in Downstreamschritten, Aufträgen und Phasen verwenden können.

secureFilePath
Gibt den Speicherort der sicheren Datei an, die heruntergeladen wurde.

Hinweise

Verwenden Sie diese Aufgabe in einer Pipeline, um eine sichere Datei auf den Agent-Computer herunterzuladen. Wenn Sie den Namen der Datei angeben (mithilfe der secureFile Eingabe), verwenden Sie den Namen, den Sie beim Hochladen angegeben haben, anstelle des tatsächlichen Dateinamens.

Verwenden Sie nach dem Herunterladen den Wert, der name für die Aufgabe festgelegt ist (oder "Verweisname" im klassischen Editor), um auf den Pfad zur sicheren Datei auf dem Agentcomputer zu verweisen. Wenn der Task beispielsweise den Namen mySecureFileerhält, kann sein Pfad in der Pipeline als $(mySecureFile.secureFilePath)referenziert werden. Alternativ können heruntergeladene sichere Dateien in dem von angegebenen $(Agent.TempDirectory)Verzeichnis gefunden werden. Sehen Sie sich unten ein vollständiges Beispiel an.

Nach Abschluss des Pipelineauftrags wird die sichere Datei aus dem Downloadspeicherort gelöscht, unabhängig davon, ob er erfolgreich ist, fehlschlägt oder abgebrochen wird.

Es ist unnötig, diese Aufgabe mit den Aufgaben Apple-Zertifikat installieren oder Apple-Bereitstellungsprofil installieren zu verwenden, da die sichere Datei automatisch heruntergeladen, installiert und gelöscht wird (am Ende des Pipelineauftrags).

Dieser Task unterstützt derzeit nur einen Dateitask pro Instanz.

Beispiele

In diesem Beispiel wird eine sichere Zertifikatdatei heruntergeladen und in einem Verzeichnis der vertrauenswürdigen Zertifizierungsstelle (CA) unter Linux installiert:

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

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Setzbare Variablen	Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: secureFilePath
Agent-Version	2.182.1 oder höher
Aufgabenkategorie	Hilfsprogramm

Anforderung	Beschreibung
Pipelinetypen	YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen	Any
Setzbare Variablen	Any
Agent-Version	2.116.0 oder höher
Aufgabenkategorie	Hilfsprogramm

Freigeben über