DownloadSecureFile@1 - Descarregue a tarefa secure file v1

Artigo
07/02/2024

Utilize esta tarefa para descarregar um ficheiro seguro para a máquina do agente.

Utilize esta tarefa para transferir um ficheiro seguro para uma localização temporária na máquina do agente.

Utilize esta tarefa para descarregar um ficheiro seguro para uma localização temporária no agente de construção ou de libertação.

Syntax

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

Especifica o nome ou identificador único (GUID) do ficheiro seguro que é descarregado para a máquina do agente. O ficheiro é apagado quando o trabalho do gasoduto estiver concluído.

retryCount - Contagem de retíria
string. Valor predefinido: 8.

Opcional. Especifica o número de vezes para voltar a tentar descarregar um ficheiro seguro se o download falhar.

retryCount - Contagem de retíria
string. Valor predefinido: 5.

Opcional. Especifica o número de vezes para voltar a tentar descarregar um ficheiro seguro se o download falhar.

socketTimeout - Intervalo de tempo da tomada
string.

Opcional. Ao descarregar um pedido de ficheiro seguro na Microsoft, esta entrada especifica o tempo limite para uma tomada.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefa. Para obter mais informações, consulte opções de Controlo e propriedades de tarefas comuns.

Variáveis de saída

Esta tarefa define as seguintes variáveis de saída, que pode consumir em etapas a jusante, empregos e estágios.

secureFilePath
Especifica a localização do ficheiro seguro que foi descarregado.

Observações

Utilize esta tarefa num oleoduto para descarregar um ficheiro seguro para a máquina do agente. Ao especificar o nome do ficheiro (utilizando a secureFile entrada), utilize o nome especificado ao carregá-lo, em vez do nome do ficheiro real.

Uma vez descarregado, utilize o name valor definido na tarefa (ou "Nome de referência" no editor clássico) para fazer referência ao caminho para o ficheiro seguro na máquina do agente. Por exemplo, se a tarefa for dada o nome mySecureFile, o seu caminho pode ser referenciado no pipeline como $(mySecureFile.secureFilePath). Em alternativa, os ficheiros seguros descarregados podem ser encontrados no diretório dado por $(Agent.TempDirectory). Veja um exemplo completo abaixo.

Quando o trabalho do pipeline estiver concluído, quer tenha sucesso, falhe ou seja cancelado, o ficheiro seguro é eliminado do seu local de descarregamento.

É desnecessário utilizar esta tarefa com o Certificado apple de instalação ou instalar tarefas de Perfil de Provisionamento do Apple porque descarregam, instalam e apagam automaticamente (no final da função de pipeline) o ficheiro seguro.

Esta tarefa suporta atualmente apenas uma tarefa de ficheiro por instância.

Exemplos

Este exemplo descarrega um ficheiro de certificado seguro e instala-o num diretório de autoridade de certificados fidedignos (CA) em 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	Description
Tipos de gasodutos	YAML, Construção clássica, lançamento clássico
Continua	Agente, Grupo de Implementação
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando	Esta tarefa executa usando as seguintes restrições de comando: restritas
Variáveis de configuração	Esta tarefa tem permissão para definir as seguintes variáveis: secureFilePath
Versão do agente	2.182.1 ou maior
Categoria da tarefa	Utilitário

Requisito	Description
Tipos de gasodutos	YAML, Construção clássica, lançamento clássico
Continua	Agente, Grupo de Implementação
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer pedidos para tarefas subsequentes no trabalho.
Restrições de comando	Qualquer
Variáveis de configuração	Qualquer
Versão do agente	2.116.0 ou maior
Categoria da tarefa	Utilitário

Partilhar via