FtpUpload@2 – úloha nahrávání přes FTP v2

Tuto úlohu použijte k nahrání souborů do vzdáleného počítače pomocí ftp nebo bezpečně pomocí 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.

Vstupy

credentialsOption - Metoda ověřování
Vstupní alias: credsType. string. Povinná hodnota. Povolené hodnoty: serviceEndpoint (připojení služby FTP), inputs (Zadejte přihlašovací údaje). 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í služby FTP
string. Vyžaduje se, když 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í se budou vždy navazovat bez ohledu na zadaný protokol (ftp:// nebo ftps://), pokud cílový server podporuje PROTOKOL FTPS. Pokud chcete povolit pouze zabezpečená ftps:// připojení, použijte protokol, například ftps://server.example.com. Připojení k serverům, které nepodporují protokol FTPS, selžou, pokud ftps:// je zadáno.

serverUrl - Adresa URL serveru
string. Vyžaduje se, když credsType = inputs.

Určuje adresu URL serveru FTP.

username - Username
string. Vyžaduje se, když credsType = inputs.

Určuje uživatelské jméno pro připojení FTP.

password - Heslo
string. Vyžaduje se, když credsType = inputs.

Určuje heslo pro připojení FTP.

implicitFTPS - Použití implicitního ftps
boolean. Výchozí hodnota: false.

rootDirectory - Kořenová složka
Vstupní alias: rootFolder. string. Povinná hodnota.

Určuje zdrojovou složku, ze které chcete nahrát soubory.

filePatterns - Vzory souborů
string. Povinná hodnota. Výchozí hodnota: **.

Určuje cesty k souborům nebo vzory souborů, které se mají nahrát. Řetězec podporuje více řádků minimatch vzorů. Přečtěte si další informace o vzorech porovnávání souborů.

remoteDirectory - Vzdálený adresář
Vstupní alias: remotePath. string. Povinná hodnota. Výchozí hodnota: /upload/$(Build.BuildId)/.

Určuje adresář na vzdáleném serveru FTP, kam úloha nahrává soubory.

enableUtf8 - Povolení podpory UTF8
boolean. Výchozí hodnota: false.

Povolí podporu UTF-8 pro připojení FTP (OPTS UTF8 ON).

clean - Odstranit vzdálený adresář
boolean. Výchozí hodnota: false.

Odstraní vzdálený adresář, včetně jeho obsahu, před nahráním.

cleanContents - Vymazání obsahu vzdáleného adresáře
boolean. Nepovinný parametr. Použijte, když 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í. Pro lepší výkon použijte clean místo toho.

preservePaths - Zachovat cesty k souborům
boolean. Výchozí hodnota: false.

Pokud je tato možnost vybrána, vytvoří se struktura relativního místního adresáře znovu ve vzdáleném adresáři, do kterého se soubory nahrávají. V opačném případě 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.txta vzdálený adresář je : /uploads/. Pokud je vybraná 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 s ftps://, i když je podepsaný svým držitelem nebo nemůže být ověřen certifikační autoritou (CA).

customCmds - Příkazy FTP
string.

Volitelné příkazy FTP, které se po připojení odešlou na vzdálený server FTP.

Možnosti ovládání úloh

Všechny úlohy mají kromě vstupů také možnosti ovládání. Další informace najdete v tématu Možnosti ovládacího prvku a běžné vlastnosti úlohy.

Výstupní proměnné

Žádné

Poznámky

Tuto úlohu použijte k nahrání souborů do vzdáleného počítače pomocí ftp nebo bezpečně pomocí FTPS.

Kde se dozvím další informace o vzorech porovnávání souborů?

• Referenční informace ke vzorům porovnávání souborů

Požadavky

Požadavek	Popis
Typy kanálů	YAML, classic build, verze Classic
Spustí se	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 spustí pomocí následujících omezení příkazů: restricted
Nastavitelné proměnné	Tato úloha má oprávnění k nastavení následujících proměnných: Nastavení proměnných je zakázáno.
Verze agenta	2.182.1 nebo vyšší
Kategorie úloh	Nástroj

Viz také

• Referenční informace ke vzorům porovnávání souborů