FTP - Upload Files

Overview

First time using this Blueprint? Make sure you follow our FTP authorization guide.

Easily import one or more files directly into an FTP Server, no matter how big they are. The match type selected greatly affects how this Blueprint works.

This Blueprint requires write permissions in order to upload to the FTP server.

Note: This Vessel cannot be used to upload a local file from your computer.

Recommended Setup:

1. A Vessel built with this Blueprint should typically run after a Vessel that either downloads a file to Shipyard or generates a file with code.

Variables

Name	Reference	Type	Required	Default	Options	Description
Host	FTP_HOST	Alphanumeric	✅	-	-	Domain or IP address of the FTP server to connect to.
Port	FTP_PORT	Integer	✅	21	-	Number for the port to connect to. 21 is used by default.
Username	FTP_USERNAME	Alphanumeric	➖	-	-	Value of the configured username in the FTP server.
Password	FTP_PASSWORD	Password	➖	-	-	Value of the configured password associated to the username on the FTP server.
Local Folder Name	FTP_SOURCE_FOLDER_NAME	Alphanumeric	➖	-	-	Name of the local folder on Shipyard to upload the target file from. If left blank, will look in the home directory.
Local File Name Match Type	FTP_SOURCE_FILE_NAME_MATCH_TYPE	Select	✅	exact_match	Exact Match: exact_match Regex Match: regex_match	Determines if the text in "Local File Name" will look for one file with exact match, or multiple files using regex.
Local File Name	FTP_SOURCE_FILE_NAME	Alphanumeric	✅	-	-	Name of the target file on Shipyard. Can be regex if "Match Type" is set accordingly.
FTP Folder Name	FTP_DESTINATION_FOLDER_NAME	Alphanumeric	➖	-	-	Folder where the file(s) should be uploaded. Leaving blank will place the file in the root directory of the FTP.
FTP File Name	FTP_DESTINATION_FILE_NAME	Alphanumeric	➖	-	-	What to name the file(s) being uploaded. 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 - Upload Files
  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: 0s
  runtime_cutoff: 4h0m0s
  exclude_exit_code_ranges:
    - "0"