Delen via


DownloadSecureFile@1 - Veilig bestand v1-taak downloaden

Gebruik deze taak om een beveiligd bestand te downloaden naar de agentcomputer.

Gebruik deze taak om een beveiligd bestand te downloaden naar een tijdelijke locatie op de agentcomputer.

Gebruik deze taak om een beveiligd bestand te downloaden naar een tijdelijke locatie op de build- of releaseagent.

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.

Invoerwaarden

secureFile - Bestand beveiligen
string. Vereist.

Hiermee geeft u de naam of unieke id (GUID) van het beveiligde bestand dat wordt gedownload naar de agentcomputer. Het bestand wordt verwijderd wanneer de pijplijntaak is voltooid.


retryCount - Aantal nieuwe pogingen
string. Standaardwaarde: 8.

Optioneel. Hiermee geeft u het aantal keren op dat een beveiligd bestand opnieuw moet worden gedownload als het downloaden mislukt.


retryCount - Aantal nieuwe pogingen
string. Standaardwaarde: 5.

Optioneel. Hiermee geeft u het aantal keren op dat een beveiligd bestand opnieuw moet worden gedownload als het downloaden mislukt.


socketTimeout - Time-out van socket
string.

Optioneel. Bij het downloaden van een beveiligde bestandsaanvraag in Microsoft geeft deze invoer de time-out voor een socket op.


Opties voor taakbeheer

Alle taken hebben naast de taakinvoer besturingsopties. Zie Opties voor besturingselementen en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Deze taak definieert de volgende uitvoervariabelen, die u kunt gebruiken in downstreamstappen, taken en fasen.

secureFilePath
Hiermee geeft u de locatie van het beveiligde bestand dat is gedownload.

Opmerkingen

Gebruik deze taak in een pijplijn om een beveiligd bestand te downloaden naar de agentcomputer. Wanneer u de naam van het bestand opgeeft (met behulp van de secureFile invoer), gebruikt u de naam die u hebt opgegeven bij het uploaden, in plaats van de werkelijke bestandsnaam.

Nadat u het bestand hebt gedownload, gebruikt u de name waarde die is ingesteld voor de taak (of 'Verwijzingsnaam' in de klassieke editor) om te verwijzen naar het pad naar het beveiligde bestand op de agentcomputer. Als de taak bijvoorbeeld de naam mySecureFilekrijgt, kan naar het pad in de pijplijn worden verwezen als $(mySecureFile.secureFilePath). U kunt ook gedownloade beveiligde bestanden vinden in de map die wordt opgegeven door $(Agent.TempDirectory). Hieronder ziet u een volledig voorbeeld.

Wanneer de pijplijntaak is voltooid, of deze nu slaagt, mislukt of wordt geannuleerd, wordt het beveiligde bestand verwijderd van de downloadlocatie.

Het is niet nodig om deze taak te gebruiken met de taken Apple Certificate installeren of Apple-inrichtingsprofiel installeren , omdat het beveiligde bestand automatisch wordt gedownload, geïnstalleerd en verwijderd (aan het einde van de pijplijntaak).

Deze taak ondersteunt momenteel slechts één bestandstaak per exemplaar.

Voorbeelden

In dit voorbeeld wordt een beveiligd certificaatbestand gedownload en geïnstalleerd in een map met een vertrouwde certificeringsinstantie (CA) 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/ 

Vereisten

Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
Instelbare variabelen Deze taak is gemachtigd om de volgende variabelen in te stellen: secureFilePath
Agentversie 2.182.1 of hoger
Taakcategorie Hulpprogramma
Vereiste Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
Eisen Geen
Functies Deze taak voldoet niet aan eventuele vereisten voor volgende taken in de taak.
Opdrachtbeperkingen Alle
Instelbare variabelen Alle
Agentversie 2.116.0 of hoger
Taakcategorie Hulpprogramma