FtpUpload@1 — zadanie przekazywania ftp w wersji 1

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

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. Connections do serwerów, które nie obsługują usługi FTPS, zakończy się niepowodzeniem, 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.

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.

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 .

overwrite - Zastąpić
boolean. Wartość domyślna: true.

Zastępuje istniejące pliki w katalogu zdalnym.

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.

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.

Uwaga

W FtpUpload@2 jest dostępna nowsza wersja tego zadania.

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

• Odwołanie do wzorców 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