Freigeben über


CopyFilesOverSSH@0 – Kopieren von Dateien über SSH v0-Aufgabe

Kopieren Sie Dateien oder Erstellen von Artefakten auf einen Remotecomputer über 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.
    #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.

Eingänge

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 zu erstellen.
  • 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 leer, wird der Stamm des Repositorys (Build) oder Artefaktverzeichnisses (Release) verwendet, das $(System.DefaultWorkingDirectory). Verwenden Sie Variablen, wenn sich dateien nicht im Repository befinden. Beispiel: $(Agent.BuildDirectory).


contents - Inhalte
string. Erforderlich. Standardwert: **.

Die Dateipfade, die als Teil der Kopie eingeschlossen werden sollen. Unterstützt mehrere Linien Miniübereinstimmungsmuster. 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" enthält alle Dateien (einschließlich Unterordnern) unter dem Quellordner, 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 Startverzeichnis des Benutzers anzugeben.


isWindowsOnTarget - Zielcomputer mit Windows
boolean. Standardwert: false.

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


cleanTargetFolder - "Zielordner bereinigen"
boolean. Standardwert: false.

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


cleanHiddenFilesInTarget - Entfernen ausgeblendeter Dateien im Zielordner
boolean. Wahlfrei. Wird verwendet, wenn cleanTargetFolder = true. Standardwert: false.

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


readyTimeout - SSH-Handshake-Timeout
string. Erforderlich. Standardwert: 20000.

Wie lange (in Millisekunden) auf den Abschluss des SSH-Handshakes warten soll.


overwrite - überschreiben
boolean. Standardwert: true.

Ersetzt vorhandene Dateien in und unter dem Zielordner.


failOnEmptySource - Fehlschlagen, wenn keine Dateien gefunden wurden, die
boolean. Standardwert: false.

Schlägt fehl, wenn keine übereinstimmenden Dateien, die kopiert werden sollen, unter dem Quellordner gefunden werden.


flattenFolders - flachen Ordner
boolean. Standardwert: false.

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


concurrentUploads - Anzahl gleichzeitiger Uploads beim Kopieren von Dateien
string. Standardwert: 10.

Die Anzahl der gleichzeitigen Uploads beim Kopieren von Dateien. Der Standardwert ist 10.


delayBetweenUploads - Verzögerung zwischen Uploads in der Warteschlange (in Millisekunden)
string. Standardwert: 50.

Verzögerung zwischen Uploads in der Warteschlange (in Millisekunden). Der Standardwert ist 50.


Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Keiner.

Anforderungen

Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion 2.206.1 oder höher
Vorgangskategorie Einsetzen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Diese Aufgabe wird mit den folgenden Befehlseinschränkungenausgeführt: restricted
Settable-Variablen Diese Aufgabe verfügt über die Berechtigung zum Festlegen der folgenden Variablen: Das Festlegen von Variablen ist deaktiviert.
Agentversion 2.182.1 oder höher
Vorgangskategorie Einsetzen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.144.0 oder höher
Vorgangskategorie Einsetzen
Anforderung BESCHREIBUNG
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Agent, DeploymentGroup
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.102.0 oder höher
Vorgangskategorie Einsetzen