FtpUpload@2 - FTP 업로드 v2 작업

FTP를 사용하거나 FTPS를 사용하여 안전하게 원격 머신에 파일을 업로드하려면 이 작업을 사용합니다.

Syntax

# 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.

입력

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 명령입니다.

작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성을 참조하세요.

출력 변수

없음

설명

FTP를 사용하거나 FTPS를 사용하여 안전하게 원격 머신에 파일을 업로드하려면 이 작업을 사용합니다.

파일 일치 패턴에 대한 자세한 내용은 어디에서 확인할 수 있나요?

• 파일 일치 패턴 참조

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	없음
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	이 작업은 다음 명령 제한을 사용하여 실행됩니다. 제한됨
설정 가능한 변수	이 작업에는 다음 변수를 설정할 수 있는 권한이 있습니다. 변수 설정을 사용할 수 없습니다.
에이전트 버전	2.182.1 이상
작업 범주	유틸리티

추가 정보

• 파일 일치 패턴 참조