DownloadSecureFile@1 – Baixar a tarefa de arquivo seguro v1

Use essa tarefa para baixar um arquivo seguro no computador do agente.

Sintaxe

# 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 - de Arquivo Seguro
string. Obrigatório

Especifica o nome ou o GUID (identificador exclusivo) do arquivo seguro que é baixado no computador do agente. O arquivo é excluído quando o trabalho de pipeline é concluído.

contagem de repetição retryCount -
string. Valor padrão: 8.

Opcional. Especifica o número de vezes que tentará baixar novamente um arquivo seguro se o download falhar.

tempo limite do soquete socketTimeout -
string.

Opcional. Ao baixar uma solicitação de arquivo segura na Microsoft, essa entrada especifica o tempo limite para um soquete.

Opções de controle de tarefa

Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Essa tarefa define as seguintes variáveis de saída , que você pode consumir em etapas downstream, trabalhos e estágios.

secureFilePath
Especifica o local do arquivo seguro que foi baixado.

Observações

Use essa tarefa em um pipeline para baixar um de arquivo seguro para o computador do agente. Ao especificar o nome do arquivo (usando a entrada secureFile), use o nome especificado ao carregá-lo, em vez do nome do arquivo real.

Observação

Essa tarefa é executada no início de seu estágio, independentemente de onde ela esteja localizada em seu trabalho.

Depois de baixado, use o valor name definido na tarefa (ou "Nome de referência" no editor clássico) para fazer referência ao caminho para o arquivo seguro no computador do agente. Por exemplo, se a tarefa receber o nome mySecureFile, seu caminho poderá ser referenciado no pipeline como $(mySecureFile.secureFilePath). Como alternativa, arquivos seguros baixados podem ser encontrados no diretório dado por $(Agent.TempDirectory). Veja um exemplo completo abaixo.

Quando o trabalho de pipeline for concluído, se ele for bem-sucedido, falhar ou for cancelado, o arquivo seguro será excluído de seu local de download.

É desnecessário usar essa tarefa com o Instalar o Apple Certificate ou Instalar tarefas do Perfil de Provisionamento da Apple, pois eles baixam, instalam e excluem automaticamente (no final do trabalho de pipeline) o arquivo seguro.

Atualmente, essa tarefa dá suporte a apenas uma tarefa de arquivo por instância.

Exemplos

Este exemplo baixa um arquivo de certificado seguro e o instala em um diretório de AC (autoridade de certificação) confiável no 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	Descrição
Tipos de pipeline	YAML, build clássico, versão clássica
Execuções em	Agent, DeploymentGroup
de demandas	Nenhum
recursos	Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando	Esta tarefa é executada usando as seguintes restrições de comando : restrito
variáveis settable	Essa tarefa tem permissão para definir as seguintes variáveis: secureFilePath
Versão do agente	2.182.1 ou superior
Categoria de tarefa	Utilidade