DownloadSecureFile@1: tarea Descargar archivo seguro v1

Use esta tarea para descargar un archivo seguro en la máquina del agente.

Sintaxis

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

Entradas

de archivos seguros de secureFile -
string. Obligatorio.

Especifica el nombre o el identificador único (GUID) del archivo seguro que se descarga en la máquina del agente. El archivo se elimina cuando se completa el trabajo de canalización.

de recuento de reintentos de retryCount -
string. Valor predeterminado: 8.

Opcional. Especifica el número de veces que se reintenta la descarga de un archivo seguro si se produce un error en la descarga.

de tiempo de espera de socket de socketTimeout -
string.

Opcional. Al descargar una solicitud de archivo segura en Microsoft, esta entrada especifica el tiempo de espera de un socket.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Esta tarea define las siguientes variables de salida , que puede consumir en pasos, trabajos y fases de bajada.

secureFilePath
Especifica la ubicación del archivo seguro que se descargó.

Observaciones

Use esta tarea en una canalización para descargar un archivo seguro en la máquina del agente. Al especificar el nombre del archivo (mediante el secureFile entrada), use el nombre que especificó al cargarlo, en lugar del nombre de archivo real.

Nota:

Esta tarea se ejecuta al principio de su fase, independientemente de dónde se encuentre dentro de su trabajo.

Una vez descargado, use el valor de name que se establece en la tarea (o "Nombre de referencia" en el editor clásico) para hacer referencia a la ruta de acceso al archivo seguro en el equipo del agente. Por ejemplo, si a la tarea se le asigna el nombre mySecureFile, se puede hacer referencia a su ruta de acceso en la canalización como $(mySecureFile.secureFilePath). Como alternativa, los archivos seguros descargados se pueden encontrar en el directorio proporcionado por $(Agent.TempDirectory). Vea un ejemplo completo a continuación.

Cuando se completa el trabajo de canalización, independientemente de si se realiza correctamente, se produce un error o se cancela, el archivo seguro se elimina de su ubicación de descarga.

No es necesario usar esta tarea con las tareas Instalar certificado de Apple o Instalar perfil de aprovisionamiento de Apple tareas porque descargan, instalan y eliminan automáticamente (al final del trabajo de canalización) el archivo seguro.

Actualmente, esta tarea solo admite una tarea de archivo por instancia.

Ejemplos

En este ejemplo se descarga un archivo de certificado seguro e se instala en un directorio de entidad de certificación (CA) de confianza en 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/ 

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Esta tarea se ejecuta con las restricciones de comandos siguientes: restringido
variables settable	Esta tarea tiene permiso para establecer las siguientes variables: secureFilePath
Versión del agente	2.182.1 o superior
Categoría de tarea	Utilidad