FtpUpload@2 – FTP-uppladdning v2-uppgift

Använd den här uppgiften för att ladda upp filer till en fjärrdator med FTP eller på ett säkert sätt med 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.

Indata

credentialsOption - Autentiseringsmetod
Indataalias: credsType. string. Krävs. Tillåtna värden: serviceEndpoint (FTP-tjänstanslutning), inputs (Ange autentiseringsuppgifter). Standardvärde: serviceEndpoint.

Anger autentiseringsmetoden. Använd en FTP-tjänstanslutning eller ange autentiseringsuppgifterna för anslutningen.

serverEndpoint - FTP-tjänstanslutning
string. Krävs när credsType = serviceEndpoint.

Anger tjänstanslutningen för FTP-servern. Om du vill skapa en klickar du på länken Hantera och skapar en ny allmän tjänstanslutning och anger sedan FTP-serverns URL för serverns URL, t.ex. ftp://server.example.comoch de autentiseringsuppgifter som krävs.

Säkra anslutningar görs alltid oavsett det angivna protokollet (ftp:// eller ftps://) om målservern stöder FTPS. Om du bara vill tillåta säkra anslutningar använder du ftps:// protokollet, t.ex. ftps://server.example.com. Anslutningar till servrar som inte stöder FTPS misslyckas om ftps:// det anges.

serverUrl - Server-URL
string. Krävs när credsType = inputs.

Anger URL:en för FTP-servern.

username - Användarnamn
string. Krävs när credsType = inputs.

Anger användarnamnet för FTP-anslutningen.

password - Lösenord
string. Krävs när credsType = inputs.

Anger lösenordet för FTP-anslutningen.

implicitFTPS - Använda implicit FTPS
boolean. Standardvärde: false.

rootDirectory - Rotmappen
Indataalias: rootFolder. string. Krävs.

Anger källmappen som du vill ladda upp filer från.

filePatterns - Filmönster
string. Krävs. Standardvärde: **.

Anger filsökvägarna eller mönstren för de filer som ska laddas upp. Strängen stöder flera rader med minimatchmönster. Läs mer om filmatchningsmönster.

remoteDirectory - Fjärrkatalog
Indataalias: remotePath. string. Krävs. Standardvärde: /upload/$(Build.BuildId)/.

Anger katalogen på fjärr-FTP-servern där uppgiften laddar upp filer.

enableUtf8 - Aktivera UTF8-stöd
boolean. Standardvärde: false.

Aktiverar UTF-8-stöd för FTP-anslutningen (OPTS UTF8 ON).

clean - Ta bort fjärrkatalog
boolean. Standardvärde: false.

Tar bort fjärrkatalogen, inklusive dess innehåll, innan den laddas upp.

cleanContents - Rensa innehållet i fjärrkatalogen
boolean. Valfritt. Använd när clean = false. Standardvärde: false.

Tar rekursivt bort allt innehåll i fjärrkatalogen innan du laddar upp. Den befintliga katalogen tas inte bort. Använd i stället för bättre prestanda clean .

preservePaths - Bevara filsökvägar
boolean. Standardvärde: false.

Om du väljer det återskapas den relativa lokala katalogstrukturen under fjärrkatalogen där filer laddas upp. Annars laddas filer upp direkt till fjärrkatalogen utan att ytterligare underkataloger skapas.

Anta till exempel att källmappen är /home/user/source/, som innehåller filen foo/bar/foobar.txtoch att fjärrkatalogen är: /uploads/. Om det här booleska objektet har valts laddas filen upp till /uploads/foo/bar/foobar.txt. Om det här booleska objektet inte är markerat laddas filen upp till /uploads/foobar.txt.

trustSSL - Förtroendeservercertifikat
boolean. Standardvärde: false.

Litar på FTP-serverns SSL-certifikat med ftps://, även om det är självsignerat eller inte kan verifieras av en certifikatutfärdare (CA).

customCmds - FTP-kommandon
string.

De valfria FTP-kommandon som ska skickas till fjärr-FTP-servern vid anslutning.

Kontrollalternativ för aktivitet

Alla aktiviteter har kontrollalternativ utöver sina aktivitetsindata. Mer information finns i Kontrollalternativ och vanliga uppgiftsegenskaper.

Utdatavariabler

Inga.

Kommentarer

Använd den här uppgiften för att ladda upp filer till en fjärrdator med FTP eller på ett säkert sätt med FTPS.

Var kan jag lära mig mer om filmatchningsmönster?

• Referens för filmatchningsmönster

Krav

Krav	Beskrivning
Pipelinetyper	YAML, klassisk version, klassisk version
Körs på	Agent, DeploymentGroup
Krav	Ingen
Funktioner	Den här aktiviteten uppfyller inte några krav för efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här uppgiften körs med följande kommandobegränsningar: begränsad
Inställningsbara variabler	Den här aktiviteten har behörighet att ange följande variabler: Inställningsvariabler är inaktiverade
Agentversion	2.182.1 eller senare
Uppgiftskategori	Verktyg

Se även

• Referens för filmatchningsmönster