FtpUpload@1 : Aufgabe "FTP-Upload v1"

Verwenden Sie diese Aufgabe, um Dateien mithilfe von FTP oder sicher mit FTPS auf einen Remotecomputer hochzuladen.

Syntax

# FTP upload v1
# Upload files using FTP.
- task: FtpUpload@1
  inputs:
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required. Authentication Method. Default: serviceEndpoint.
    serverEndpoint: # string. Required when credsType = serviceEndpoint. FTP Service Connection. 
    #serverUrl: # string. Required when credsType = inputs. Server URL. 
    #username: # string. Required when credsType = inputs. Username. 
    #password: # string. Required when credsType = inputs. Password. 
    rootDirectory: # string. Alias: rootFolder. Required. Root folder. 
    filePatterns: '**' # string. Required. File patterns. Default: **.
    remoteDirectory: '/upload/$(Build.BuildId)/' # string. Alias: remotePath. Required. Remote directory. Default: /upload/$(Build.BuildId)/.
  # Advanced
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #overwrite: true # boolean. Overwrite. Default: true.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Eingaben

credentialsOption - Authentifizierungsmethode
Eingabealias: credsType. string. Erforderlich. Zulässige Werte: serviceEndpoint (FTP-Dienstverbindung), inputs (Geben Sie Anmeldeinformationen ein). Standardwert. serviceEndpoint.

Gibt die Authentifizierungsmethode an. Verwenden Sie eine FTP-Dienstverbindung, oder geben Sie die Anmeldeinformationen ein.

serverEndpoint - FTP-Dienstverbindung
string. Erforderlich, wenn credsType = serviceEndpoint.

Gibt die Dienstverbindung für den FTP-Server an. Um einen zu erstellen, klicken Sie auf den Link Verwalten, und erstellen Sie eine neue generische Dienstverbindung, und geben Sie dann die FTP-Server-URL für die Server-URL ein, z. B. ftp://server.example.com, und die erforderlichen Anmeldeinformationen.

Sichere Verbindungen werden immer unabhängig vom angegebenen Protokoll (ftp:// oder ftps://) hergestellt, wenn der Zielserver FTPS unterstützt. Um nur sichere Verbindungen zuzulassen, verwenden Sie das ftps:// Protokoll, z. B. ftps://server.example.com. Connections zu Servern, die FTPS nicht unterstützen, schlägt fehl, wenn ftps:// angegeben ist.

serverUrl - Server-URL
string. Erforderlich, wenn credsType = inputs.

Gibt die URL für den FTP-Server an.

username - Nutzername
string. Erforderlich, wenn credsType = inputs.

Gibt den Benutzernamen für die FTP-Verbindung an.

password - Passwort
string. Erforderlich, wenn credsType = inputs.

Gibt das Kennwort für die FTP-Verbindung an.

rootDirectory - Stammordner
Eingabealias: rootFolder. string. Erforderlich.

Gibt den Quellordner an, aus dem Dateien hochgeladen werden sollen.

filePatterns - Dateimuster
string. Erforderlich. Standardwert. **.

Gibt die Dateipfade oder Muster der hochzuladenden Dateien an. Die Zeichenfolge unterstützt mehrere Zeilen von Minimatchmustern. Erfahren Sie mehr über Dateiabgleichsmuster.

remoteDirectory - Remoteverzeichnis
Eingabealias: remotePath. string. Erforderlich. Standardwert. /upload/$(Build.BuildId)/.

Gibt das Verzeichnis auf dem FTP-Remoteserver an, auf dem die Aufgabe Dateien hochlädt.

clean - Remoteverzeichnis löschen
boolean. Standardwert. false.

Löscht das Remoteverzeichnis einschließlich des Inhalts vor dem Hochladen.

cleanContents - Löschen des Remoteverzeichnisinhalts
boolean. Optional. Verwenden Sie , wenn clean = false. Standardwert. false.

Löscht rekursiv alle Inhalte im Remoteverzeichnis vor dem Hochladen. Das vorhandene Verzeichnis wird nicht gelöscht. Verwenden Sie clean stattdessen, um die Leistung zu verbessern.

overwrite - Überschreiben
boolean. Standardwert. true.

Überschreibt vorhandene Dateien im Remoteverzeichnis.

preservePaths - Beibehalten von Dateipfaden
boolean. Standardwert. false.

Bei Auswahl wird die relative lokale Verzeichnisstruktur unter dem Remoteverzeichnis neu erstellt, in dem Dateien hochgeladen werden. Andernfalls werden Dateien direkt in das Remoteverzeichnis hochgeladen, ohne zusätzliche Unterverzeichnisse zu erstellen.

Angenommen, Ihr Quellordner ist /home/user/source/, der die Datei foo/bar/foobar.txtenthält, und Ihr Remoteverzeichnis ist: /uploads/. Wenn dieser boolesche Wert ausgewählt ist, wird die Datei in /uploads/foo/bar/foobar.txthochgeladen. Wenn dieser boolesche Wert nicht ausgewählt ist, wird die Datei in /uploads/foobar.txthochgeladen.

trustSSL - Zertifikat des Vertrauensservers
boolean. Standardwert. false.

Vertraut dem SSL-Zertifikat des FTP-Servers mit ftps://, auch wenn es selbstsigniert ist oder nicht von einer Zertifizierungsstelle überprüft werden kann.

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.

Hinweise

Verwenden Sie diese Aufgabe, um Dateien mithilfe von FTP oder sicher mit FTPS auf einen Remotecomputer hochzuladen.

Hinweis

Es ist eine neuere Version dieser Aufgabe unter FtpUpload@2 verfügbar.

Wo erhalte ich weitere Informationen zu Dateiabgleichsmustern?

• Referenz zu Dateiabgleichsmustern

Anforderungen

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	Dieser Task wird mit den folgenden Befehlseinschränkungen ausgeführt: restricted
Einstellbare 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	Hilfsprogramm