Partilhar via

DownloadSecureFile@1 - Download de arquivo seguro v1 tarefa

Use esta tarefa para baixar um arquivo seguro para a máquina 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.

Insumos

secureFile - de arquivos seguros
string. Obrigatório.

Especifica o nome ou identificador exclusivo (GUID) do arquivo seguro que é baixado para a máquina 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 que o download de um arquivo seguro será tentado novamente 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 controlo de tarefas

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

Variáveis de saída

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

secureFilePath
Especifica o local do arquivo seguro que foi baixado.

Observações

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

Observação

Essa tarefa é executada no início de seu estágio, independentemente de onde esteja localizada dentro de 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 na máquina do agente. Por exemplo, se a tarefa receber o nome mySecureFile, seu caminho pode ser referenciado no pipeline como $(mySecureFile.secureFilePath). Como alternativa, os arquivos seguros baixados podem ser encontrados no diretório fornecido pelo $(Agent.TempDirectory). Veja um exemplo completo abaixo.

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

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

Atualmente, essa tarefa suporta 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 autoridade de certificação (CA) 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/

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Esta tarefa é executada usando as seguintes restrições de comando : restrito
Variáveis configuráveis Esta tarefa tem permissão para definir as seguintes variáveis: secureFilePath
Versão do agente 2.182.1 ou superior
Categoria de tarefa Utilidade
  • Last updated on