Compartilhar via


DownloadSecureFile@1 – Baixar a tarefa de arquivo seguro v1

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

Use essa tarefa para baixar um arquivo seguro para um local temporário no computador do agente.

Use essa tarefa para baixar um arquivo seguro para um local temporário no agente de build ou versão.

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

Entradas

secureFile - Arquivo seguro
string. Obrigatórios.

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.


retryCount - Contagem de repetições
string. Valor padrão: 8.

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


retryCount - Contagem de repetições
string. Valor padrão: 5.

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


socketTimeout - Tempo limite do soquete
string.

Opcional. Ao baixar uma solicitação de arquivo seguro 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 de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.

Variáveis de saída

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

secureFilePath
Especifica o local do arquivo seguro que foi baixado.

Comentários

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

Depois de baixado, use o name valor definido na tarefa (ou "Nome da referência" no editor clássico) para referenciar o 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, os arquivos seguros baixados podem ser encontrados no diretório dado por $(Agent.TempDirectory). Veja um exemplo completo abaixo.

Quando o trabalho de pipeline é concluído, se ele é bem-sucedido, falha ou é cancelado, o arquivo seguro é excluído de seu local de download.

É desnecessário usar essa tarefa com as tarefas Instalar o Apple Certificate ou Instalar Perfil de Provisionamento da Apple porque elas 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
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Essa tarefa é executada usando as seguintes restrições de comando: restrito
Variáveis configuráveis Essa tarefa tem permissão para definir as seguintes variáveis: secureFilePath
Versão do agente 2.182.1 ou superior
Categoria da tarefa Utilitário
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Executa em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente 2.116.0 ou superior
Categoria da tarefa Utilitário