FtpUpload@1 – úloha nahrávání PŘES FTP v1

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 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

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. Connections na servery, které nepodporují 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.

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.

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.

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 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).

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.

Poznámka

Na FtpUpload@2 je k dispozici novější verze této úlohy.

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