FtpUpload@1 – FTP-uppladdning v1-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.

Den här versionen av uppgiften är inaktuell. använd FtpUpload@2.

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.

Ingångar

credentialsOption - autentiseringsmetod
Indataalias: credsType. string. Obligatoriskt. 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 server-URL:en, t.ex. ftp://server.example.comoch nödvändiga autentiseringsuppgifter.

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 protokollet ftps://, t.ex. ftps://server.example.com. Anslutningar till servrar som inte stöder FTPS misslyckas om ftps:// 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.

rootDirectory - Rotmapp
Indataalias: rootFolder. string. Obligatoriskt.

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

filePatterns - Filmönster
string. Obligatoriskt. 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. Obligatoriskt. Standardvärde: /upload/$(Build.BuildId)/.

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

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

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

cleanContents - Rensa
boolean. Valfritt. Använd när clean = false. Standardvärde: false.

Rekursivt tar bort allt innehåll i fjärrkatalogen innan det laddas upp. Den befintliga katalogen tas inte bort. Använd clean i stället för bättre prestanda.

overwrite - Skriv över
boolean. Standardvärde: true.

Skriver över befintliga filer i fjärrkatalogen.

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 fjärrkatalogen är: /uploads/. Om det här booleska värdet är markerat 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 - Betrodda servercertifikat
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).

Kontrollalternativ för aktivitet

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

Utdatavariabler

Ingen.

Anmärkningar

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.

Anmärkning

Det finns en nyare version av den här uppgiften tillgänglig på FtpUpload@2.

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
kräver	Ingen
funktioner	Den här aktiviteten uppfyller inte några krav på efterföljande uppgifter i jobbet.
Kommandobegränsningar	Den här aktiviteten körs med hjälp av följande kommandobegränsningar: begränsad
variabler som kan	Den här uppgiften har behörighet att ange följande variabler: Inställningsvariabler är inaktiverade
Agentversion	2.182.1 eller senare
Aktivitetskategori	Nytta