DownloadSecureFile@1 - Scaricare l'attività Secure File v1

Usare questa attività per scaricare un file sicuro nel computer agente.

Sintassi

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

Ingressi dati

secureFile - di file protetti
string. Obbligatorio.

Specifica il nome o l'identificatore univoco (GUID) del file protetto scaricato nel computer agente. Il file viene eliminato al termine del processo della pipeline.

retryCount - numero di tentativi
string. Valore predefinito: 8

Opzionale. Specifica il numero di tentativi di ripetizione del download di un file protetto se il download non riesce.

socketTimeout - timeout socket
string.

Opzionale. Quando si scarica una richiesta di file sicura in Microsoft, questo input specifica il timeout per un socket.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Questa attività definisce le variabili di output seguenti , che è possibile utilizzare nei passaggi downstream, nei processi e nelle fasi.

secureFilePath
Specifica il percorso del file protetto scaricato.

Osservazioni:

Usare questa attività in una pipeline per scaricare un file sicuro nel computer dell'agente. Quando si specifica il nome del file (usando l'input secureFile), usare il nome specificato durante il caricamento, anziché il nome file effettivo.

Nota

Questa attività viene eseguita all'inizio della fase, indipendentemente dalla posizione in cui si trova all'interno del processo.

Dopo il download, usare il valore name impostato nell'attività (o "Nome riferimento" nell'editor classico) per fare riferimento al percorso del file protetto nel computer agente. Ad esempio, se all'attività viene assegnato il nome mySecureFile, è possibile fare riferimento al relativo percorso nella pipeline come $(mySecureFile.secureFilePath). In alternativa, i file protetti scaricati sono disponibili nella directory specificata da $(Agent.TempDirectory). Vedere un esempio completo di seguito.

Al termine del processo della pipeline, se ha esito positivo, ha esito negativo o viene annullato, il file protetto viene eliminato dal relativo percorso di download.

Non è necessario usare questa attività con l'Install Apple Certificate o Install Apple Provisioning Profile tasks perché scaricano, installano ed eliminano automaticamente (alla fine del processo della pipeline) il file sicuro.

Questa attività supporta attualmente una sola attività di file per istanza.

Esempi

Questo esempio scarica un file di certificato sicuro e lo installa in una directory dell'autorità di certificazione (CA) attendibile in 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/ 

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
richieste	Nessuno
funzionalità di	Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni del comando seguenti: con restrizioni
variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: secureFilePath
Versione dell'agente	2.182.1 o versione successiva
Categoria attività	Utilità