Partager via


DownloadSecureFile@1 - Tâche Télécharger le fichier sécurisé v1

Utilisez cette tâche pour télécharger un fichier sécurisé sur l’ordinateur de l’agent.

Utilisez cette tâche pour télécharger un fichier sécurisé à un emplacement temporaire sur l’ordinateur agent.

Utilisez cette tâche pour télécharger un fichier sécurisé à un emplacement temporaire sur l’agent de build ou de mise en production.

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.

Entrées

secureFile - Fichier sécurisé
string. Obligatoire.

Spécifie le nom ou l’identificateur unique (GUID) du fichier sécurisé téléchargé sur l’ordinateur de l’agent. Le fichier est supprimé une fois le travail de pipeline terminé.


retryCount - Nombre de nouvelles tentatives
string. Valeur par défaut : 8.

facultatif. Spécifie le nombre de tentatives de téléchargement d’un fichier sécurisé si le téléchargement échoue.


retryCount - Nombre de nouvelles tentatives
string. Valeur par défaut : 5.

facultatif. Spécifie le nombre de tentatives de téléchargement d’un fichier sécurisé si le téléchargement échoue.


socketTimeout - Délai d’expiration du socket
string.

facultatif. Lors du téléchargement d’une demande de fichier sécurisé dans Microsoft, cette entrée spécifie le délai d’attente d’un socket.


Options de contrôle des tâches

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâche. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Cette tâche définit les variables de sortie suivantes, que vous pouvez utiliser dans les étapes, les travaux et les étapes en aval.

secureFilePath
Spécifie l’emplacement du fichier sécurisé qui a été téléchargé.

Remarques

Utilisez cette tâche dans un pipeline pour télécharger un fichier sécurisé sur l’ordinateur agent. Lorsque vous spécifiez le nom du fichier (à l’aide de l’entrée secureFile ), utilisez le nom que vous avez spécifié lors du chargement de celui-ci, plutôt que le nom de fichier réel.

Une fois téléchargé, utilisez la name valeur définie sur la tâche (ou « Nom de référence » dans l’éditeur classique) pour référencer le chemin d’accès au fichier sécurisé sur l’ordinateur agent. Par exemple, si la tâche reçoit le nom mySecureFile, son chemin d’accès peut être référencé dans le pipeline en tant que $(mySecureFile.secureFilePath). Vous pouvez également trouver des fichiers sécurisés téléchargés dans le répertoire donné par $(Agent.TempDirectory). Consultez un exemple complet ci-dessous.

Une fois le travail de pipeline terminé, qu’il réussisse, échoue ou soit annulé, le fichier sécurisé est supprimé de son emplacement de téléchargement.

Il n’est pas nécessaire d’utiliser cette tâche avec les tâches Installer le certificat Apple ou Installer le profil d’approvisionnement Apple , car elles téléchargent, installent et suppriment automatiquement (à la fin du travail de pipeline) le fichier sécurisé.

Cette tâche ne prend actuellement en charge qu’une seule tâche de fichier par instance.

Exemples

Cet exemple télécharge un fichier de certificat sécurisé et l’installe dans un répertoire d’autorité de certification approuvée sur 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/ 

Spécifications

Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Cette tâche s’exécute à l’aide des restrictions de commande suivantes : restricted
Variables settables Cette tâche est autorisée à définir les variables suivantes : secureFilePath
Version de l’agent 2.182.1 ou version ultérieure
Catégorie de la tâche Utilitaire
Condition requise Description
Types de pipelines YAML, build classique, version classique
S’exécute sur Agent, DeploymentGroup
Demandes Aucun
Capabilities Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commandes Quelconque
Variables settables Quelconque
Version de l’agent 2.116.0 ou supérieur
Catégorie de la tâche Utilitaire