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.
# FTP Upload v1
# FTP Upload.
- 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.com
i 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?
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 |