DownloadSecureFile@1 - Télécharger la tâche de fichier sécurisé v1

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

Syntaxe

# 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.

Entrées

secureFile - de fichiers sécurisés
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 la tâche de pipeline terminée.

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

Optionnel. Spécifie le nombre de tentatives de téléchargement d’un fichier sécurisé en cas d’échec du téléchargement.

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

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

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. 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 en aval, les travaux et les étapes.

secureFilePath
Spécifie l’emplacement du fichier sécurisé 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, plutôt que le nom de fichier réel.

Remarque

Cette tâche s’exécute au début de sa phase, quel que soit son emplacement dans son travail.

Une fois téléchargé, utilisez la valeur name 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 de l’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 trouverez également 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 la tâche de pipeline terminée, qu’elle réussisse, échoue ou est annulée, 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 l'Installer le certificat Apple ou installer des tâches de 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

Linux

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/ 

Windows

• Importer un certificat dans le magasin racine CurrentUser :

  - task: DownloadSecureFile@1
    displayName: 'Download certificate'
    inputs:
      secureFile: 'myCACertificate.pem'
  
  - powershell: |
      $certPath = '$(caCertificate.secureFilePath)'
      $certStoreLocation = 'Cert:\CurrentUser\Root'
  
      Write-Host "Importing certificate $certPath to $certStoreLocation..."
      $params = @{
          FilePath = $certPath
          CertStoreLocation = $certStoreLocation
      }
      Import-Certificate @params
    displayName: 'Import CA certificate to CurrentUser root store'
  

• Importer un certificat dans le magasin racine LocalMachine :

  - task: DownloadSecureFile@1
    displayName: 'Download certificate'
    inputs:
      secureFile: 'myCACertificate.pem'
  
  - powershell: |
      $certPath = '$(caCertificate.secureFilePath)'
      $certStoreLocation = 'Cert:\LocalMachine\Root'
  
      Write-Host "Importing certificate $certPath to $certStoreLocation..."
      $params = @{
          FilePath = $certPath
          CertStoreLocation = $certStoreLocation
      }
      Import-Certificate @params
    displayName: 'Import CA certificate to LocalMachine root store'
  

Spécifications

Besoin	Descriptif
Types de pipelines	YAML, Build Classique, Version Classique
Exécutions sur	Agent, DeploymentGroup
demandes	Aucun
fonctionnalités de	Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande	Cette tâche s’exécute à l’aide des restrictions de commande suivantes: restreint
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 tâche	Utilité