Udostępnij za pośrednictwem


FtpUpload@2 — zadanie przekazywania ftp w wersji 2

To zadanie służy do przekazywania plików na maszynę zdalną przy użyciu protokołu FTP lub bezpiecznie z usługą FTPS.

Składnia

# 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.
# 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. 
    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.
# 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. 
    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.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.

Dane wejściowe

credentialsOption - Metoda uwierzytelniania
Alias wejściowy: credsType. string. Wymagane. Dozwolone wartości: serviceEndpoint (połączenie z usługą FTP), inputs (Wprowadź poświadczenia). Wartość domyślna: serviceEndpoint.

Określa metodę uwierzytelniania. Użyj połączenia usługi FTP lub wprowadź poświadczenia połączenia.


serverEndpoint - Połączenie z usługą FTP
string. Wymagane, gdy credsType = serviceEndpoint.

Określa połączenie usługi dla serwera FTP. Aby go utworzyć, kliknij link Zarządzaj i utwórz nowe połączenie usługi ogólnej, a następnie wprowadź adres URL serwera FTP dla adresu URL serwera, np. ftp://server.example.comi wymagane poświadczenia.

Bezpieczne połączenia będą zawsze wykonywane niezależnie od określonego protokołu (ftp:// lub ftps://), jeśli serwer docelowy obsługuje protokół FTPS. Aby zezwolić tylko na bezpieczne połączenia, użyj ftps:// protokołu, np. ftps://server.example.com. Połączenia z serwerami, które nie obsługują usługi FTPS, nie powiedzą się, jeśli ftps:// zostanie określony.


serverUrl - Adres URL serwera
string. Wymagane, gdy credsType = inputs.

Określa adres URL serwera FTP.


username - Nazwę użytkownika
string. Wymagane, gdy credsType = inputs.

Określa nazwę użytkownika dla połączenia FTP.


password - Hasło
string. Wymagane, gdy credsType = inputs.

Określa hasło dla połączenia FTP.


implicitFTPS - Używanie niejawnego protokołu FTPS
boolean. Wartość domyślna: false.


rootDirectory - Folder główny
Alias wejściowy: rootFolder. string. Wymagane.

Określa folder źródłowy do przekazywania plików z.


filePatterns - Wzorce plików
string. Wymagane. Wartość domyślna: **.

Określa ścieżki plików lub wzorce plików do przekazania. Ciąg obsługuje wiele wierszy wzorców minimatch. Dowiedz się więcej o wzorcach dopasowywania plików.


remoteDirectory - Katalog zdalny
Alias wejściowy: remotePath. string. Wymagane. Wartość domyślna: /upload/$(Build.BuildId)/.

Określa katalog na zdalnym serwerze FTP, na którym zadanie przekazuje pliki.


enableUtf8 - Włączanie obsługi utF8
boolean. Wartość domyślna: false.

Włącza obsługę protokołu UTF-8 dla połączenia FTP (OPTS UTF8 ON).


clean - Usuwanie katalogu zdalnego
boolean. Wartość domyślna: false.

Usuwa katalog zdalny, w tym jego zawartość, przed przekazaniem.


cleanContents - Wyczyść zawartość katalogu zdalnego
boolean. Opcjonalny. Użyj polecenia , gdy clean = false. Wartość domyślna: false.

Rekursywnie usuwa całą zawartość w katalogu zdalnym przed przekazaniem. Istniejący katalog nie zostanie usunięty. Aby uzyskać lepszą wydajność, należy zamiast tego użyć polecenia clean .


preservePaths - Zachowaj ścieżki plików
boolean. Wartość domyślna: false.

W przypadku wybrania względna struktura katalogów lokalnych jest odtwarzana w katalogu zdalnym, w którym są przekazywane pliki. W przeciwnym razie pliki są przekazywane bezpośrednio do katalogu zdalnego bez tworzenia dodatkowych podkatalogów.

Załóżmy na przykład, że folder źródłowy to /home/user/source/, który zawiera plik foo/bar/foobar.txt, a katalog zdalny to: /uploads/. Jeśli ta wartość logiczna jest zaznaczona, plik zostanie przekazany do ./uploads/foo/bar/foobar.txt Jeśli ta wartość logiczna nie jest zaznaczona, plik zostanie przekazany do pliku /uploads/foobar.txt.


trustSSL - Certyfikat serwera zaufania
boolean. Wartość domyślna: false.

Ufa certyfikatowi ftps://SSL serwera FTP, nawet jeśli jest on z podpisem własnym lub nie można go zweryfikować przez urząd certyfikacji.


customCmds - Polecenia FTP
string.

Opcjonalne polecenia FTP, które zostaną wysłane do zdalnego serwera FTP po nawiązaniu połączenia.


Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Uwagi

To zadanie służy do przekazywania plików na maszynę zdalną przy użyciu protokołu FTP lub bezpiecznie z usługą FTPS.

Gdzie można dowiedzieć się więcej o wzorcach dopasowywania plików?

Wymagania

Wymaganie Opis
Typy potoków YAML, klasyczna kompilacja, wersja klasyczna
Działa w Agent, DeploymentGroup
Wymagania Brak
Możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń To zadanie jest uruchamiane przy użyciu następujących ograniczeń poleceń: ograniczone
Zmienne ustawialne To zadanie ma uprawnienia do ustawiania następujących zmiennych: Ustawienie zmiennych jest wyłączone
Wersja agenta 2.182.1 lub nowsza
Kategoria zadania Narzędzie
Wymaganie Opis
Typy potoków YAML, kompilacja klasyczna, wersja klasyczna
Działa na Agent, DeploymentGroup
Wymagania Brak
Możliwości To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń Dowolne
Zmienne w formie tabeli settable Dowolne
Wersja agenta Wszystkie obsługiwane wersje agentów.
Kategoria zadania Narzędzie

Zobacz też