다음을 통해 공유


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 - 인증 방법
입력 별칭: credsType. string; 필수 사항입니다. 허용되는 값: serviceEndpoint(FTP 서비스 연결), inputs(자격 증명 입력). 기본값은 serviceEndpoint입니다.

인증 방법을 지정합니다. FTP 서비스 연결을 사용하거나 연결 자격 증명을 입력합니다.


FTP 서비스 연결serverEndpoint -
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 연결의 암호를 지정합니다.


루트 폴더rootDirectory -
입력 별칭: rootFolder. string; 필수 사항입니다.

파일을 업로드할 원본 폴더를 지정합니다.


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이 작업의 최신 버전을 사용할 수 있습니다.

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

요구 사항

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