Delen via


CopyFilesOverSSH@0 - Bestanden kopiëren via SSH v0-taak

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

Syntaxis

# 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.
    #concurrentUploads: '10' # string. Number of concurrent uploads when copying files. Default: 10.
    #delayBetweenUploads: '50' # string. Delay between queueing uploads (in milliseconds). Default: 50.
# 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.
# 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.
    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.

Invoer

sshEndpoint - SSH-serviceverbinding
string. Verplicht.

De naam van een SSH-serviceverbinding met verbindingsgegevens 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 u naar de externe computer wilt kopiëren. Als deze map leeg is, wordt de hoofdmap van de opslagplaats (build) of artefactenmap (release) gebruikt. Dit is $(System.DefaultWorkingDirectory). Gebruik variabelen als bestanden zich niet in de opslagplaats bevinden. Voorbeeld: $(Agent.BuildDirectory).


contents - Inhoudsopgave
string. Verplicht. Standaardwaarde: **.

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

  • 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 sluit XML-bestanden uit.

targetFolder - doelmap
string.

De doelmap op de externe computer, waar bestanden worden gekopieerd. Voorbeeld: /home/user/MySite. Voorwoord met 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.

Verwijdert alle bestaande bestanden en submappen in de doelmap voordat u kopieert.


cleanHiddenFilesInTarget - Verborgen bestanden verwijderen in de doelmap
boolean. Facultatief. Gebruiken 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. Verplicht. 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 worden gevonden in 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.


concurrentUploads - aantal gelijktijdige uploads bij het kopiëren van bestanden
string. Standaardwaarde: 10.

Aantal gelijktijdige uploads bij het kopiëren van bestanden. De standaardwaarde is 10.


delayBetweenUploads - vertraging tussen uploads in de wachtrij (in milliseconden)
string. Standaardwaarde: 50.

Vertraging tussen uploads in de wachtrij (in milliseconden). De standaardwaarde is 50.


Opties voor taakbeheer

Alle taken hebben besturingsopties naast hun taakinvoer. Zie Opties en algemene taakeigenschappenvoor meer informatie.

Uitvoervariabelen

Geen.

Vereisten

Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
variabelen instellen Deze taak is gemachtigd om de volgende variabelen in te stellen : Variabelen instellen is uitgeschakeld
Agentversie 2.206.1 of hoger
Taakcategorie Implementeren
Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Deze taak wordt uitgevoerd met behulp van de volgende opdrachtbeperkingen: beperkt
variabelen instellen Deze taak is gemachtigd om de volgende variabelen in te stellen : Variabelen instellen is uitgeschakeld
Agentversie 2.182.1 of hoger
Taakcategorie Implementeren
Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 2.144.0 of hoger
Taakcategorie Implementeren
Voorwaarde Beschrijving
Pijplijntypen YAML, klassieke build, klassieke release
Wordt uitgevoerd op Agent, DeploymentGroup
eisen Geen
mogelijkheden Deze taak voldoet niet aan de vereisten voor volgende taken in de taak.
opdrachtbeperkingen Welk dan ook
variabelen instellen Welk dan ook
Agentversie 2.102.0 of hoger
Taakcategorie Implementeren