CopyFilesOverSSH@0: bestanden kopiëren via SSH v0-taak

Kopieer bestanden of bouw artefacten naar een externe computer via SSH.

Syntax

# Copy files over SSH v0
# Copy files or build artifacts to a remote machine over SSH.
- task: CopyFilesOverSSH@0
  inputs:
    sshEndpoint: # string. Required. SSH service connection. 
    #sourceFolder: # string. Source folder. 
    contents: '**' # string. Required. Contents. Default: **.
    #targetFolder: # string. Target folder. 
  # Advanced
    #isWindowsOnTarget: false # boolean. Target machine running Windows. Default: false.
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #cleanHiddenFilesInTarget: false # boolean. Optional. Use when cleanTargetFolder = true. Remove hidden files in target folder. Default: false.
    readyTimeout: '20000' # string. Required. SSH handshake timeout. Default: 20000.
    #overwrite: true # boolean. Overwrite. Default: true.
    #failOnEmptySource: false # boolean. Fail if no files found to copy. Default: false.
    #flattenFolders: false # boolean. Flatten folders. Default: false.

Invoerwaarden

sshEndpoint - SSH-serviceverbinding
string. Vereist.

De naam van een SSH-serviceverbinding met verbindingsdetails voor de externe computer.

• De hostnaam of het IP-adres van de externe computer, het poortnummer en de gebruikersnaam zijn vereist om een SSH-serviceverbinding te maken.
• De persoonlijke sleutel en de wachtwoordzin moeten worden opgegeven voor verificatie.

sourceFolder - Bronmap
string.

De bronmap van de bestanden die naar de externe computer moeten worden gekopieerd. Wanneer deze map leeg is, wordt de hoofdmap van de opslagplaats (build) of de map artefacten (release) gebruikt, namelijk $(System.DefaultWorkingDirectory). Gebruik variabelen als bestanden zich niet in de opslagplaats bevinden. Bijvoorbeeld: $(Agent.BuildDirectory).

contents - Inhoud
string. Vereist. Standaardwaarde: **.

De bestandspaden die moeten worden opgenomen als onderdeel van de kopie. Ondersteunt meerdere regels met minimatchpatronen. De standaardwaarde is **, die alle bestanden (inclusief submappen) onder de bronmap bevat.

• Voorbeeld: **/*.*(jar|war) bevat alle .jar- en .war-bestanden (inclusief submappen) onder de bronmap.
• Voorbeeld: "** \n !**/*.xml" bevat alle bestanden (inclusief submappen) onder de bronmap, maar xml-bestanden worden uitgesloten.

targetFolder - Doelmap
string.

De doelmap op de externe computer, waar bestanden worden gekopieerd. Bijvoorbeeld: /home/user/MySite. Voorafgegaan door een tilde (~) om de basismap van de gebruiker op te geven.

isWindowsOnTarget - Doelcomputer met Windows
boolean. Standaardwaarde: false.

Controleert of op de doelcomputer Windows wordt uitgevoerd.

cleanTargetFolder - Doelmap opschonen
boolean. Standaardwaarde: false.

Hiermee verwijdert u alle bestaande bestanden en submappen in de doelmap voordat u het kopieert.

cleanHiddenFilesInTarget - Verborgen bestanden in de doelmap verwijderen
boolean. Optioneel. Gebruik wanneer cleanTargetFolder = true. Standaardwaarde: false.

Als deze optie is ingesteld op true, worden verborgen bestanden in de doelmap verwijderd.

readyTimeout - Time-out voor SSH-handshake
string. Vereist. Standaardwaarde: 20000.

Hoe lang (in milliseconden) moet worden gewacht totdat de SSH-handshake is voltooid.

overwrite - Overschrijven
boolean. Standaardwaarde: true.

Vervangt bestaande bestanden in en onder de doelmap.

failOnEmptySource - Mislukt als er geen bestanden zijn gevonden om te kopiëren
boolean. Standaardwaarde: false.

Mislukt als er geen overeenkomende bestanden zijn gevonden die moeten worden gekopieerd onder de bronmap.

flattenFolders - Mappen plat maken
boolean. Standaardwaarde: false.

Hiermee wordt de mapstructuur platgemaakt en worden alle bestanden gekopieerd naar de opgegeven doelmap op de externe computer.

Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Besturingsopties en algemene taakeigenschappen voor meer informatie.

Uitvoervariabelen

Geen.

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: Het instellen van variabelen is uitgeschakeld
Agentversie	2.206.1 of hoger
Taakcategorie	Implementeren