FtpUpload@2 - FTP アップロード v2 タスク

このタスクを使用して、FTP を使用してリモート コンピューターにファイルをアップロードするか、FTPS で安全にファイルをアップロードします。

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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. 
    #implicitFTPS: false # boolean. Use implicit FTPS. Default: false.
    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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

# FTP upload v2
# Upload files using FTP.
- task: FtpUpload@2
  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
    #enableUtf8: false # boolean. Enable UTF8 support. Default: false.
    #clean: false # boolean. Delete remote directory. Default: false.
    #cleanContents: false # boolean. Optional. Use when clean = false. Clear remote directory contents. Default: false.
    #preservePaths: false # boolean. Preserve file paths. Default: false.
    #trustSSL: false # boolean. Trust server certificate. Default: false.
    #customCmds: # string. FTP Commands.

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 接続のパスワードを指定します。

implicitFTPS - 暗黙的な FTPS を使用する
boolean。 既定値: false。

ルート フォルダーの rootDirectory -
入力エイリアス: rootFolder。 string。 必須。

ファイルをアップロードするソース フォルダーを指定します。

filePatterns - ファイル パターンの
string。 必須。 既定値: **。

アップロードするファイルのパスまたはパターンを指定します。 この文字列は、複数行のミニマッチ パターンをサポートしています。 ファイル マッチング パターン の詳細を確認します。

リモート ディレクトリの remoteDirectory -
入力エイリアス: remotePath。 string。 必須。 既定値: /upload/$(Build.BuildId)/。

タスクがファイルをアップロードするリモート FTP サーバー上のディレクトリを指定します。

enableUtf8 - UTF8 サポートを有効にする
boolean。 既定値: false。

FTP 接続 (OPTS UTF8 ON) の UTF-8 サポートを有効にします。

clean - リモート ディレクトリ を削除する
boolean。 既定値: false。

アップロードする前に、その内容を含むリモート ディレクトリを削除します。

cleanContents - リモート ディレクトリの内容をクリアする
boolean。 任意。 clean = falseするときに使用します。 既定値: false。

アップロードする前に、リモート ディレクトリ内のすべてのコンテンツを再帰的に削除します。 既存のディレクトリは削除されません。 パフォーマンスを向上させるには、代わりに clean を使用してください。

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://で信頼します。

customCmds - FTP コマンド
string。

接続時にリモート FTP サーバーに送信されるオプションの FTP コマンド。

なし。