Skip to main content

FTP - Download Files to Platform

Overview​

Quickly export one or more files from an FTP Server. The match type selected greatly affects how this Blueprint works.

This Blueprint requires read permissions in order to download from the FTP server.

Variables​

NameReferenceTypeRequiredDefaultOptionsDescription
HostFTP_HOSTAlphanumericβœ…--The domain or the IP address of the FTP Server you want to connect to.
PortFTP_PORTIntegerβœ…"21"-Number for the port to connect to. 21 is used by default.
UsernameFTP_USERNAMEAlphanumericβž–--Value of the configured username in the FTP server.
PasswordFTP_PASSWORDPasswordβž–--Value of the configured password associated to the username on the FTP server.
FTP Folder NameFTP_SOURCE_FOLDER_NAMEAlphanumericβž–--Name of the folder where the file is stored in the FTP server.
FTP File Name Match TypeFTP_SOURCE_FILE_NAME_MATCH_TYPESelectβœ…exact_matchExact Match: exact_match

Regex Match: regex_match

Determines if the text in "FTP File Name" will look for one file with exact match, or multiple files using regex.
FTP File NameFTP_SOURCE_FILE_NAMEAlphanumericβœ…--Name of the target file in the FTP server. Can be regex if "Match Type" is set accordingly.
Shipyard Folder NameFTP_DESTINATION_FOLDER_NAMEAlphanumericβž–--Folder where the file(s) should be downloaded. Leaving blank will place the file in the home directory.
Shipyard File NameFTP_DESTINATION_FILE_NAMEAlphanumericβž–--What to name the file(s) being downloaded. If left blank, defaults to the original file name(s).

YAML​

Below is the YAML template for this Blueprint and can be used in the Fleet YAML Editor.

source:
blueprint: FTP - Download Files to Shipyard
inputs:
FTP_HOST: null ## REQUIRED
FTP_PORT: '21' ## REQUIRED
FTP_USERNAME: null
FTP_PASSWORD: null
FTP_SOURCE_FOLDER_NAME: null
FTP_SOURCE_FILE_NAME_MATCH_TYPE: exact_match ## REQUIRED
FTP_SOURCE_FILE_NAME: null ## REQUIRED
FTP_DESTINATION_FOLDER_NAME: null
FTP_DESTINATION_FILE_NAME: null
type: BLUEPRINT
guardrails:
retry_count: 1
retry_wait: 0h0m0s
runtime_cutoff: 1h0m0s
exclude_exit_code_ranges:
- '202'
- '210'