FtpUpload@2 - FTP-upload v2-taak

Gebruik deze taak om bestanden te uploaden naar een externe computer met behulp van FTP of veilig met FTPS.

Syntax

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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. 
    #implicitFTPS: false # boolean. Use implicit FTPS. Default: false.
    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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

Invoerwaarden

credentialsOption - Verificatiemethode
Invoeralias: credsType. string. Vereist. Toegestane waarden: serviceEndpoint (FTP-serviceverbinding), inputs (Referenties invoeren). Standaardwaarde: serviceEndpoint.

Hiermee geeft u de verificatiemethode op. Gebruik een FTP-serviceverbinding of voer de verbindingsreferenties in.

serverEndpoint - FTP-serviceverbinding
string. Vereist wanneer credsType = serviceEndpoint.

Hiermee geeft u de serviceverbinding voor de FTP-server. Als u er een wilt maken, klikt u op de koppeling Beheren en maakt u een nieuwe algemene serviceverbinding en voert u vervolgens de URL van de FTP-server voor de server-URL in, bijvoorbeeld ftp://server.example.com, en de vereiste referenties.

Beveiligde verbindingen worden altijd gemaakt, ongeacht het opgegeven protocol (ftp:// of ftps://) als de doelserver FTPS ondersteunt. Als u alleen beveiligde verbindingen wilt toestaan, gebruikt u het ftps:// protocol, bijvoorbeeld ftps://server.example.com. Verbindingen met servers die FTPS niet ondersteunen, mislukken als ftps:// is opgegeven.

serverUrl - Server-URL
string. Vereist wanneer credsType = inputs.

Hiermee geeft u de URL voor de FTP-server.

username - Gebruikersnaam
string. Vereist wanneer credsType = inputs.

Hiermee geeft u de gebruikersnaam voor de FTP-verbinding.

password - Wachtwoord
string. Vereist wanneer credsType = inputs.

Hiermee geeft u het wachtwoord voor de FTP-verbinding.

implicitFTPS - Impliciete FTPS gebruiken
boolean. Standaardwaarde: false.

rootDirectory - Hoofdmap
Invoeralias: rootFolder. string. Vereist.

Hiermee geeft u de bronmap op waaruit bestanden moeten worden geüpload.

filePatterns - Bestandspatronen
string. Vereist. Standaardwaarde: **.

Hiermee geeft u de bestandspaden of -patronen op van de bestanden die moeten worden geüpload. De tekenreeks ondersteunt meerdere regels met minimatchpatronen. Meer informatie over patronen voor het vergelijken van bestanden.

remoteDirectory - Externe map
Invoeralias: remotePath. string. Vereist. Standaardwaarde: /upload/$(Build.BuildId)/.

Hiermee geeft u de map op de externe FTP-server waar de taak bestanden uploadt.

enableUtf8 - UTF8-ondersteuning inschakelen
boolean. Standaardwaarde: false.

Schakelt UTF-8-ondersteuning in voor de FTP-verbinding (OPTS UTF8 ON).

clean - Externe map verwijderen
boolean. Standaardwaarde: false.

Hiermee verwijdert u de externe map, inclusief de inhoud ervan, voordat u het uploadt.

cleanContents - Inhoud van externe map wissen
boolean. Optioneel. Gebruik wanneer clean = false. Standaardwaarde: false.

Alle inhoud in de externe map recursief verwijderen voordat u het uploadt. De bestaande map wordt niet verwijderd. Gebruik clean in plaats daarvan voor betere prestaties.

preservePaths - Bestandspaden behouden
boolean. Standaardwaarde: false.

Als deze optie is geselecteerd, wordt de relatieve lokale mapstructuur opnieuw gemaakt in de externe map waar bestanden worden geüpload. Anders worden bestanden rechtstreeks geüpload naar de externe map zonder extra submappen te maken.

Stel dat uw bronmap is /home/user/source/, die het bestand foo/bar/foobar.txtbevat en uw externe map is: /uploads/. Als deze booleaanse waarde is geselecteerd, wordt het bestand geüpload naar /uploads/foo/bar/foobar.txt. Als deze booleaanse waarde niet is geselecteerd, wordt het bestand geüpload naar /uploads/foobar.txt.

trustSSL - Servercertificaat vertrouwen
boolean. Standaardwaarde: false.

Vertrouwt het SSL-certificaat van de FTP-server met ftps://, zelfs als het zelfondertekend is of niet kan worden gevalideerd door een certificeringsinstantie (CA).

customCmds - FTP-opdrachten
string.

De optionele FTP-opdrachten die bij de verbinding naar de externe FTP-server worden verzonden.

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

Gebruik deze taak om bestanden te uploaden naar een externe computer met behulp van FTP of veilig met FTPS.

Waar vind ik meer informatie over patronen voor het vergelijken van bestanden?

• Naslaginformatie over bestandskoppelingspatronen

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.182.1 of hoger
Taakcategorie	Hulpprogramma

Zie ook

• Naslaginformatie over bestandskoppelingspatronen