다음을 통해 공유


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

이 옵션을 선택하면 상대 로컬 디렉터리 구조가 파일이 업로드되는 원격 디렉터리 아래에 다시 만들어집니다. 그렇지 않으면 파일이 추가 하위 디렉터리를 만들지 않고 원격 디렉터리에 직접 업로드됩니다.

예를 들어 원본 폴더가 파일 foo/bar/foobar.txt포함된 /home/user/source/원격 디렉터리가 /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 이상
작업 범주 유틸리티
요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 지원되는 모든 에이전트 버전입니다.
작업 범주 유틸리티