Freigeben über


CopyFilesOverSSH@0: Task "Kopieren von Dateien über SSH v0"

Kopieren Sie Dateien oder Buildartefakte über SSH auf einen Remotecomputer.

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.
# 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.
# 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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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
    #cleanTargetFolder: false # boolean. Clean target folder. Default: false.
    #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.

Eingaben

sshEndpoint - SSH-Dienstverbindung
string. Erforderlich.

Der Name einer SSH-Dienstverbindung , die Verbindungsdetails für den Remotecomputer enthält.

  • Der Hostname oder die IP-Adresse des Remotecomputers, die Portnummer und der Benutzername sind erforderlich, um eine SSH-Dienstverbindung herzustellen.
  • Der private Schlüssel und die Passphrase müssen für die Authentifizierung angegeben werden.

sourceFolder - Quellordner
string.

Der Quellordner der Dateien, die auf den Remotecomputer kopiert werden sollen. Wenn sie leer ist $(System.DefaultWorkingDirectory), wird der Stamm des Repositorys (Build) oder des Artefaktverzeichnisses (Release) verwendet, d. h. . Verwenden Sie Variablen, wenn sich keine Dateien im Repository befinden. Beispiel: $(Agent.BuildDirectory).


contents - Inhalt
string. Erforderlich. Standardwert. **.

Die Dateipfade, die als Teil der Kopie eingeschlossen werden sollen. Unterstützt mehrere Zeilen mit Minimatchmustern. Der Standardwert ist **, der alle Dateien (einschließlich Unterordnern) unter dem Quellordner enthält.

  • Beispiel: **/*.*(jar|war) Enthält alle .jar- und WAR-Dateien (einschließlich Unterordnern) unter dem Quellordner.
  • Beispiel: "** \n !**/*.xml" Schließt alle Dateien (einschließlich Unterordnern) unter dem Quellordner ein, schließt jedoch XML-Dateien aus.

targetFolder - Zielordner
string.

Der Zielordner auf dem Remotecomputer, in den Dateien kopiert werden. Beispiel: /home/user/MySite. Vorangestellt mit einer Tilde (~) , um das Basisverzeichnis des Benutzers anzugeben.


isWindowsOnTarget - Zielcomputer unter Windows
boolean. Standardwert. false.

Überprüft, ob auf dem Zielcomputer Windows ausgeführt wird.


cleanTargetFolder - Bereinigen des Zielordners
boolean. Standardwert. false.

Löscht alle vorhandenen Dateien und Unterordner im Zielordner vor dem Kopieren.


cleanHiddenFilesInTarget - Entfernen ausgeblendeter Dateien im Zielordner
boolean. Optional. Verwenden Sie , wenn cleanTargetFolder = true. Standardwert. false.

Wenn auf truefestgelegt ist, werden ausgeblendete Dateien im Zielordner entfernt.


readyTimeout - SSH-Handshaketimeout
string. Erforderlich. Standardwert. 20000.

Gibt an, wie lange (in Millisekunden) auf den Abschluss des SSH-Handshakes gewartet werden soll.


overwrite - Überschreiben
boolean. Standardwert. true.

Ersetzt vorhandene Dateien in und unter dem Zielordner.


failOnEmptySource - Fehler, wenn keine Dateien zum Kopieren gefunden wurden
boolean. Standardwert. false.

Tritt ein Fehler auf, wenn unter dem Quellordner keine übereinstimmenden Dateien gefunden werden, die kopiert werden sollen.


flattenFolders - Vereinfachen von Ordnern
boolean. Standardwert. false.

Vereinfacht die Ordnerstruktur und kopiert alle Dateien in den angegebenen Zielordner auf dem Remotecomputer.


Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Setzbare Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Festlegen von Variablen ist deaktiviert.
Agent-Version 2.206.1 oder höher
Aufgabenkategorie Bereitstellen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Setzbare Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Festlegen von Variablen ist deaktiviert.
Agent-Version 2.182.1 oder höher
Aufgabenkategorie Bereitstellen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassisches Release
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Einstellbare Variablen Any
Agent-Version 2.144.0 oder höher
Aufgabenkategorie Bereitstellen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Klassischer Build, klassische Version
Wird ausgeführt auf Agent, DeploymentGroup
Forderungen Keine
Capabilities Diese Aufgabe erfüllt keine Anforderungen an nachfolgende Aufgaben im Auftrag.
Befehlseinschränkungen Any
Einstellbare Variablen Any
Agent-Version 2.102.0 oder höher
Aufgabenkategorie Bereitstellen