次の方法で共有


FtpUpload@1 - FTP アップロード v1 タスク

このタスクを使用して、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 - 認証方法の
入力エイリアス: credsTypestring。 必須。 使用できる値: serviceEndpoint (FTP サービス接続)、inputs (資格情報の入力)。 既定値: serviceEndpoint.

認証方法を指定します。 FTP サービス接続を使用するか、接続資格情報を入力します。


serverEndpoint - FTP サービス接続
stringcredsType = serviceEndpointする場合に必要です。

FTP サーバーのサービス接続を指定します。 作成するには、[管理] リンクをクリックして新しい汎用サービス接続を作成し、サーバー URL の FTP サーバー URL (ftp://server.example.comなど) と必要な資格情報を入力します。

ターゲット サーバーが FTPS をサポートしている場合、指定されたプロトコル (ftp:// または ftps://) に関係なく、常にセキュリティで保護された接続が行われます。 セキュリティで保護された接続のみを許可するには、ftps:// プロトコル (例: ftps://server.example.com) を使用します。 ftps:// が指定されている場合、FTPS をサポートしていないサーバーへの接続は失敗します。


serverUrl - サーバー URL
stringcredsType = inputsする場合に必要です。

FTP サーバーの URL を指定します。


username - ユーザー名の
stringcredsType = inputsする場合に必要です。

FTP 接続のユーザー名を指定します。


password - パスワード
stringcredsType = inputsする場合に必要です。

FTP 接続のパスワードを指定します。


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

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


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

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


リモート ディレクトリremoteDirectory -
入力エイリアス: remotePathstring。 必須。 既定値: /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で使用できます。

ファイル マッチング パターンの詳細については、どこで確認できますか?

必要条件

要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
の需要 なし
機能の このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 このタスクは、次の コマンド制限: restricted を使用して実行されます。
設定可能な変数 このタスクには、次の変数 設定アクセス許可があります。変数の設定は無効です
エージェントのバージョン 2.182.1 以上
タスク カテゴリ 効用
要件 説明
パイプラインの種類 YAML、クラシック ビルド、クラシック リリース
実行日 エージェント、DeploymentGroup
の需要 なし
機能の このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限 どれでも
設定可能な変数 どれでも
エージェントのバージョン サポートされているすべてのエージェント バージョン。
タスク カテゴリ 効用