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

secureFile - Archivo seguro
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.

retryCount - Recuento de reintentos
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.

socketTimeout - Tiempo de espera de socket
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 tareas. Para obtener más información, vea 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 la secureFile entrada), use el nombre que especificó al cargarlo, en lugar del nombre de archivo real.

Una vez descargado, use el name valor 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, 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 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
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Esta tarea se ejecuta con las siguientes restricciones de comandos: restringido
Variables que se pueden establecer	Esta tarea tiene permiso para establecer las siguientes variables: secureFilePath
Versión del agente	2.182.1 o superior
Categoría de la tarea:	Utilidad