Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Tuto úlohu použijte k nahrání souborů na vzdálený počítač pomocí FTP nebo bezpečně pomocí FTPS.
Tato verze úlohy je zastaralá; použít FtpUpload@2.
Tuto úlohu použijte k nahrání souborů na vzdálený počítač pomocí FTP nebo bezpečně pomocí FTPS.
Syntaxe
# 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.
Vstupy
metoda ověřování credentialsOption
-
Vstupní alias: credsType
.
string
. Povinné. Povolené hodnoty: serviceEndpoint
(připojení služby FTP), inputs
(zadání přihlašovacích údajů). Výchozí hodnota: serviceEndpoint
.
Určuje metodu ověřování. Použijte připojení služby FTP nebo zadejte přihlašovací údaje pro připojení.
serverEndpoint
-
připojení ke službě FTP
string
. Požadováno při credsType = serviceEndpoint
.
Určuje připojení služby pro server FTP. Pokud ho chcete vytvořit, klikněte na odkaz Spravovat a vytvořte nové obecné připojení služby a zadejte adresu URL serveru FTP pro adresu URL serveru, například ftp://server.example.com
a požadované přihlašovací údaje.
Zabezpečená připojení budou vždy provedena bez ohledu na zadaný protokol (ftp://
nebo ftps://
), pokud cílový server podporuje FTPS. Pokud chcete povolit pouze zabezpečená připojení, použijte protokol ftps://
, např. ftps://server.example.com
. Připojení k serverům, které nepodporují FTPS, selžou, pokud je zadána ftps://
.
adresy URL serveru serverUrl
-
string
. Požadováno při credsType = inputs
.
Určuje adresu URL serveru FTP.
username
-
uživatelské jméno
string
. Požadováno při credsType = inputs
.
Určuje uživatelské jméno pro připojení FTP.
password
-
heslo
string
. Požadováno při credsType = inputs
.
Určuje heslo pro připojení FTP.
kořenové složky rootDirectory
-
Vstupní alias: rootFolder
.
string
. Povinné.
Určuje zdrojová složka, ze které se mají nahrát soubory.
vzory souborů filePatterns
-
string
. Povinné. Výchozí hodnota: **
.
Určuje cesty k souborům nebo vzory souborů, které se mají nahrát. Řetězec podporuje více řádků vzorů minimatch. Přečtěte si další informace o vzorech porovnávání souborů .
vzdáleného adresáře remoteDirectory
-
Vstupní alias: remotePath
.
string
. Povinné. Výchozí hodnota: /upload/$(Build.BuildId)/
.
Určuje adresář na vzdáleném serveru FTP, kde úloha nahrává soubory.
clean
-
Odstranění vzdáleného adresáře
boolean
. Výchozí hodnota: false
.
Před nahráním odstraní vzdálený adresář, včetně jeho obsahu.
cleanContents
-
Vymazat obsah vzdáleného adresáře
boolean
. Volitelný. Používá se při clean = false
. Výchozí hodnota: false
.
Rekurzivně odstraní veškerý obsah ve vzdáleném adresáři před nahráním. Existující adresář se neodstraní. Pokud chcete dosáhnout lepšího výkonu, použijte místo toho clean
.
overwrite
-
přepsat
boolean
. Výchozí hodnota: true
.
Přepíše existující soubory ve vzdáleném adresáři.
preservePaths
-
Zachovat cesty k souborům
boolean
. Výchozí hodnota: false
.
Pokud je tato možnost vybraná, relativní místní adresářová struktura se znovu vytvoří ve vzdáleném adresáři, ve kterém se nahrají soubory. Jinak se soubory nahrají přímo do vzdáleného adresáře bez vytvoření dalších podadresářů.
Předpokládejme například, že zdrojová složka je /home/user/source/
, která obsahuje soubor foo/bar/foobar.txt
a váš vzdálený adresář je: /uploads/
. Pokud je vybrána tato logická hodnota, soubor se nahraje do /uploads/foo/bar/foobar.txt
. Pokud tato logická hodnota není vybraná, soubor se nahraje do /uploads/foobar.txt
.
trustSSL
-
důvěřovat certifikátu serveru
boolean
. Výchozí hodnota: false
.
Důvěřuje certifikátu SSL serveru FTP pomocí ftps://
, a to i v případě, že je podepsaný svým držitelem nebo jej nemůže ověřit certifikační autorita (CA).
Možnosti ovládání úloh
Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace naleznete v tématu Možnosti ovládacího prvku a běžné vlastnosti úloh.
Výstupní proměnné
Žádné.
Poznámky
Tuto úlohu použijte k nahrání souborů na vzdálený počítač pomocí FTP nebo bezpečně pomocí FTPS.
Poznámka:
V FtpUpload@2je k dispozici novější verze této úlohy .
Kde najdu další informace o vzorech porovnávání souborů?
Požadavky
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, klasická verze |
Běží na | Agent, DeploymentGroup |
požadavky | Žádný |
možnosti | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
omezení příkazů | Tato úloha se spouští s následujícími omezeními příkazů : omezeno: |
nastavitelné proměnné | Tento úkol má oprávnění nastavit následující proměnné: Nastavení proměnných je zakázáno. |
Verze agenta | 2.182.1 nebo vyšší |
Kategorie úkolu | Užitnost |
Požadavek | Popis |
---|---|
Typy kanálů | YAML, klasické sestavení, klasická verze |
Běží na | Agent, DeploymentGroup |
požadavky | Žádný |
možnosti | Tento úkol nesplňuje žádné požadavky na následné úkoly v úloze. |
omezení příkazů | Jakýkoliv |
nastavitelné proměnné | Jakýkoliv |
Verze agenta | Všechny podporované verze agenta. |
Kategorie úkolu | Užitnost |