FtpUpload@2 – FTP upload v2 feladat

Ezzel a feladattal fájlokat tölthet fel egy távoli gépre FTP használatával vagy biztonságosan FTPS használatával.

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.

Bevitelek

credentialsOption - Hitelesítési módszer
Bemeneti alias: credsType. string. Kötelező. Engedélyezett értékek: serviceEndpoint (FTP-szolgáltatáskapcsolat), inputs (Adja meg a hitelesítő adatokat). Alapértelmezett érték: serviceEndpoint.

Megadja a hitelesítési módszert. Használjon FTP-szolgáltatáskapcsolatot, vagy adja meg a kapcsolat hitelesítő adatait.

serverEndpoint - FTP-szolgáltatáskapcsolat
string. Akkor szükséges, ha credsType = serviceEndpoint.

Megadja az FTP-kiszolgáló szolgáltatáskapcsolatát. Ha létre szeretne hozni egyet, kattintson a Kezelés hivatkozásra, és hozzon létre egy új általános szolgáltatáskapcsolatot, majd adja meg a kiszolgáló URL-címéhez tartozó FTP-kiszolgáló URL-címét, például ftp://server.example.coma címet és a szükséges hitelesítő adatokat.

Ha a célkiszolgáló támogatja az FTPS-t, a biztonságos kapcsolatok mindig a megadott protokolltól (ftp:// vagy ftps://) függetlenül létrejönnek. Ha csak biztonságos kapcsolatokat szeretne engedélyezni, használja a ftps:// protokollt, például: ftps://server.example.com. Az FTPS-t nem támogató kiszolgálók kapcsolatai sikertelenek lesznek, ha ftps:// meg van adva.

serverUrl - Kiszolgáló URL-címe
string. Akkor szükséges, ha credsType = inputs.

Megadja az FTP-kiszolgáló URL-címét.

username - Felhasználónév
string. Akkor szükséges, ha credsType = inputs.

Megadja az FTP-kapcsolat felhasználónevét.

password - Jelszó
string. Akkor szükséges, ha credsType = inputs.

Megadja az FTP-kapcsolat jelszavát.

implicitFTPS - Implicit FTPS használata
boolean. Alapértelmezett érték: false.

rootDirectory - Gyökérmappa
Bemeneti alias: rootFolder. string. Kötelező.

Megadja azt a forrásmappát, amelyből fájlokat szeretne feltölteni.

filePatterns - Fájlminták
string. Kötelező. Alapértelmezett érték: **.

Megadja a feltöltendő fájlok elérési útját vagy mintáit. A sztring több sornyi kis egyező mintát támogat. További információ a fájlegyeztetési mintákról.

remoteDirectory - Távoli könyvtár
Bemeneti alias: remotePath. string. Kötelező. Alapértelmezett érték: /upload/$(Build.BuildId)/.

Megadja azt a könyvtárat a távoli FTP-kiszolgálón, ahol a feladat fájlokat tölt fel.

enableUtf8 - UTF8-támogatás engedélyezése
boolean. Alapértelmezett érték: false.

Engedélyezi az UTF-8 támogatását az FTP-kapcsolathoz (OPTS UTF8 ON).

clean - Távoli címtár törlése
boolean. Alapértelmezett érték: false.

A feltöltés előtt törli a távoli könyvtárat, beleértve annak tartalmát is.

cleanContents - Távoli címtár tartalmának törlése
boolean. Választható. Használja a következőt: clean = false. Alapértelmezett érték: false.

Rekurzív módon törli a távoli könyvtárban lévő összes tartalmat feltöltés előtt. A meglévő címtár nem törlődik. A jobb teljesítmény érdekében használja inkább a parancsot clean .

preservePaths - Fájlelérési utak megőrzése
boolean. Alapértelmezett érték: false.

Ha be van jelölve, a relatív helyi könyvtárstruktúra újra létrejön abban a távoli könyvtárban, amelyben a fájlok feltöltődnek. Ellenkező esetben a fájlok közvetlenül a távoli könyvtárba lesznek feltöltve további alkönyvtárak létrehozása nélkül.

Tegyük fel például, hogy a forrásmappa , /home/user/source/amely a fájlt foo/bar/foobar.txttartalmazza, a távoli könyvtár pedig a következő: /uploads/. Ha ez a logikai érték van kiválasztva, a rendszer feltölti a fájlt a fájlba /uploads/foo/bar/foobar.txt. Ha ez a logikai érték nincs kijelölve, a rendszer feltölti a fájlt a fájlba /uploads/foobar.txt.

trustSSL - Kiszolgálótanúsítvány megbízhatósága
boolean. Alapértelmezett érték: false.

Megbízik az FTP-kiszolgáló SSL-tanúsítványában a használatával ftps://, még akkor is, ha önaláírt, vagy nem érvényesíthető hitelesítésszolgáltató által.

customCmds - FTP-parancsok
string.

Az opcionális FTP-parancsok, amelyeket a rendszer a csatlakozáskor a távoli FTP-kiszolgálóra küld.

Feladatvezérlési lehetőségek

Minden feladathoz tartoznak vezérlési lehetőségek is a feladat bemenetei mellett. További információ: Vezérlési beállítások és gyakori feladattulajdonságok.

Kimeneti változók

Nincsenek.

Megjegyzések

Ezzel a feladattal fájlokat tölthet fel egy távoli gépre FTP használatával vagy biztonságosan FTPS használatával.

Hol tudhatok meg többet a fájlegyeztetési mintákról?

• Fájlegyeztetési minták referenciája

Követelmények

Követelmény	Leírás
Folyamattípusok	YAML, klasszikus build, klasszikus kiadás
Futtatás:	Ügynök, DeploymentGroup
Igények	None
Képességek	Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek.
Parancskorlátozások	Ez a feladat a következő parancskorlátozásokkal fut: korlátozott
Változók beállítása	Ez a feladat a következő változók beállítására jogosult: A változók beállítása le van tiltva
Ügynök verziója	2.182.1 vagy újabb
Feladatkategória	Segédprogram

Lásd még

• Fájlegyeztetési minták referenciája