このタスクを使用して、FTP を使用してリモート コンピューターにファイルをアップロードするか、FTPS で安全にファイルをアップロードします。
このバージョンのタスクは非推奨です。FtpUpload@2を使用します。
このタスクを使用して、FTP を使用してリモート コンピューターにファイルをアップロードするか、FTPS で安全にファイルをアップロードします。
構文
# 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.
入力
credentialsOption
-
認証方法の
入力エイリアス: credsType
。
string
。 必須。 使用できる値: serviceEndpoint
(FTP サービス接続)、inputs
(資格情報の入力)。 既定値: serviceEndpoint
.
認証方法を指定します。 FTP サービス接続を使用するか、接続資格情報を入力します。
serverEndpoint
-
FTP サービス接続
string
。
credsType = serviceEndpoint
する場合に必要です。
FTP サーバーのサービス接続を指定します。 作成するには、[管理] リンクをクリックして新しい汎用サービス接続を作成し、サーバー URL の FTP サーバー URL (ftp://server.example.com
など) と必要な資格情報を入力します。
ターゲット サーバーが FTPS をサポートしている場合、指定されたプロトコル (ftp://
または ftps://
) に関係なく、常にセキュリティで保護された接続が行われます。 セキュリティで保護された接続のみを許可するには、ftps://
プロトコル (例: ftps://server.example.com
) を使用します。
ftps://
が指定されている場合、FTPS をサポートしていないサーバーへの接続は失敗します。
serverUrl
-
サーバー URL
string
。
credsType = inputs
する場合に必要です。
FTP サーバーの URL を指定します。
username
-
ユーザー名の
string
。
credsType = inputs
する場合に必要です。
FTP 接続のユーザー名を指定します。
password
-
パスワード
string
。
credsType = inputs
する場合に必要です。
FTP 接続のパスワードを指定します。
filePatterns
-
ファイル パターンの
string
。 必須。 既定値: **
.
アップロードするファイルのパスまたはパターンを指定します。 この文字列は、複数行のミニマッチ パターンをサポートしています。 ファイル マッチング パターン の詳細を確認します。
リモート ディレクトリの remoteDirectory
-
入力エイリアス: remotePath
。
string
。 必須。 既定値: /upload/$(Build.BuildId)/
.
タスクがファイルをアップロードするリモート FTP サーバー上のディレクトリを指定します。
clean
-
リモート ディレクトリ を削除する
boolean
。 既定値: false
.
アップロードする前に、その内容を含むリモート ディレクトリを削除します。
cleanContents
-
リモート ディレクトリの内容をクリアする
boolean
。 任意
clean = false
するときに使用します。 既定値: false
.
アップロードする前に、リモート ディレクトリ内のすべてのコンテンツを再帰的に削除します。 既存のディレクトリは削除されません。 パフォーマンスを向上させるには、代わりに clean
を使用してください。
overwrite
-
上書き
boolean
。 既定値: true
.
リモート ディレクトリ内の既存のファイルを上書きします。
preservePaths
-
ファイル パス を保持する
boolean
。 既定値: false
.
選択すると、ファイルがアップロードされるリモート ディレクトリの下に相対ローカル ディレクトリ構造が再作成されます。 それ以外の場合、ファイルは追加のサブディレクトリを作成せずにリモート ディレクトリに直接アップロードされます。
たとえば、ソース フォルダーが /home/user/source/
で、ファイル foo/bar/foobar.txt
が含まれており、リモート ディレクトリが /uploads/
であるとします。 このブール値が選択されている場合、ファイルは /uploads/foo/bar/foobar.txt
にアップロードされます。 このブール値が選択されていない場合、ファイルは /uploads/foobar.txt
にアップロードされます。
trustSSL
-
信頼サーバー証明書の
boolean
。 既定値: false
.
自己署名されているか、証明機関 (CA) によって検証できない場合でも、FTP サーバーの SSL 証明書を ftps://
で信頼します。
タスク コントロールのオプション
すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「コントロール オプションと一般的なタスク プロパティを参照してください。
出力変数
なし。
注釈
このタスクを使用して、FTP を使用してリモート コンピューターにファイルをアップロードするか、FTPS で安全にファイルをアップロードします。
注
このタスクの新しいバージョンは、FtpUpload@2で使用できます。