DownloadSecureFile@1 - Scaricare l'attività secure file v1

Articolo
07/02/2024

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

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

Usare questa attività per scaricare un file sicuro in un percorso temporaneo nell'agente di compilazione o versione.

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.

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

Input

secureFile - File sicuro
string. Obbligatorio.

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

retryCount - Conteggio tentativi
string. Valore predefinito: 8.

Facoltativa. Specifica il numero di volte in cui ripetere il download di un file sicuro se il download ha esito negativo.

retryCount - Conteggio tentativi
string. Valore predefinito: 5.

Facoltativa. Specifica il numero di volte in cui ripetere il download di un file sicuro se il download ha esito negativo.

socketTimeout - Socket Timeout
string.

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

Opzioni di controllo 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, nei processi e nelle fasi downstream.

secureFilePath
Specifica il percorso del file sicuro scaricato.

Commenti

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

Dopo il download, usare il name valore impostato sull'attività (o "Nome di riferimento" nell'editor classico) per fare riferimento al percorso del file sicuro nel computer agente. Ad esempio, se l'attività viene assegnato al nome mySecureFile, il relativo percorso può essere fatto riferimento 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 sicuro viene eliminato dal percorso di download.

Non è necessario usare questa attività con le attività Installa certificato Apple o Installa profilo di provisioning Apple perché scaricano, installano ed eliminano automaticamente (alla fine del processo della pipeline) il file sicuro.

Questa attività supporta attualmente solo un'attività file per istanza.

Esempio

Questo esempio scarica un file di certificato sicuro e lo installa in una directory ca (Trusted Certificate Authority) 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
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Questa attività viene eseguita usando le restrizioni di comando seguenti: limitato
Variabili impostabili	Questa attività dispone dell'autorizzazione per impostare le variabili seguenti: secureFilePath
Versione agente	2.182.1 o versione successiva
Categoria attività	Utilità

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Esecuzione in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	2.116.0 o versione successiva
Categoria attività	Utilità

Condividi tramite