DownloadSecureFile@1 – Aufgabe "Sichere Datei v1 herunterladen"

Verwenden Sie diese Aufgabe, um eine sichere Datei auf den Agentcomputer 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.

Eingänge

secureFile - secure File
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 - Wiederholungsanzahl
string. Standardwert: 8.

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

socketTimeout - Sockettimeout-
string.

Wahlfrei. 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 Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Mit dieser Aufgabe werden die folgenden Ausgabevariablendefiniert, die Sie in nachgeschalteten Schritten, Aufträgen und Phasen verwenden können.

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

Bemerkungen

Verwenden Sie diese Aufgabe in einer Pipeline, um eine sichere Datei auf den Agentcomputer herunterzuladen. Verwenden Sie beim Angeben des Namens der Datei (mithilfe der secureFile Eingabe) den Namen, den Sie beim Hochladen angegeben haben, und nicht den tatsächlichen Dateinamen.

Hinweis

Diese Aufgabe wird am Anfang der Phase ausgeführt, unabhängig davon, wo sie sich innerhalb des Auftrags befindet.

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

Wenn der Pipelineauftrag abgeschlossen ist, ob er erfolgreich ist, fehlschlägt oder abgebrochen wird, wird die sichere Datei vom Downloadspeicherort gelöscht.

Es ist unnötig, diese Aufgabe mit dem Apple-Zertifikat installieren oder Installieren von Apple Provisioning Profile Aufgaben zu verwenden, da sie die sichere Datei automatisch herunterladen, installieren und löschen (am Ende des Pipelineauftrags).

Diese Aufgabe unterstützt derzeit nur eine Dateiaufgabe pro Instanz.

Beispiele

In diesem Beispiel wird eine sichere Zertifikatdatei heruntergeladen und in ein 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, Classic Build, Classic Release
Läuft auf	Agent, DeploymentGroup
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen	Diese Aufgabe verfügt über die Berechtigung, die folgenden Variablenfestzulegen: secureFilePath
Agentversion	2.182.1 oder höher
Vorgangskategorie	Nützlichkeit