FtpUpload@1 - FTP-upload v1-taak

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

Deze versie van de taak is afgeschaft; FtpUpload@2gebruiken.

Syntaxis

# 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.

Invoer

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

Hiermee geeft u de verificatiemethode. 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. Voer vervolgens de URL van de FTP-server voor de server-URL in, bijvoorbeeld ftp://server.example.comen 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 protocol ftps://, bijvoorbeeld ftps://server.example.com. Verbindingen met servers die FTPS niet ondersteunen, mislukken als ftps:// is opgegeven.

URL-van serverUrl - server
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.

rootDirectory - hoofdmap
Invoeralias: rootFolder. string. Verplicht.

Hiermee geeft u de bronmap waaruit u bestanden wilt uploaden.

filePatterns - bestandspatronen
string. Verplicht. 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 bestandskoppelingspatronen.

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

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

clean - externe map verwijderen
boolean. Standaardwaarde: false.

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

cleanContents - inhoud van externe map wissen
boolean. Facultatief. Gebruiken wanneer clean = false. Standaardwaarde: false.

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

overwrite - overschrijven
boolean. Standaardwaarde: true.

Hiermee worden bestaande bestanden in de externe map overschreven.

preservePaths - bestandspaden behouden
boolean. Standaardwaarde: false.

Indien geselecteerd, wordt de relatieve lokale mapstructuur opnieuw gemaakt onder de externe map waar bestanden worden geüpload. Anders worden bestanden rechtstreeks naar de externe map geüpload zonder extra submappen te maken.

Stel dat uw bronmap /home/user/source/is, die het bestand foo/bar/foobar.txtbevat en dat uw externe map: /uploads/is. 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).

Opties voor taakbeheer

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

Uitvoervariabelen

Geen.

Opmerkingen

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

Notitie

Er is een nieuwere versie van deze taak beschikbaar op FtpUpload@2.

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

• Naslaginformatie over bestandskoppelingspatronen

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