다음을 통해 공유


ArchiveFiles@2 - 파일 보관 v2 작업

.7z, .tar, .gz 및 .zip 같은 압축 형식을 사용하여 파일을 보관합니다.

.7z, .rar, .tar., .gz 및 .zip 같은 압축 형식을 사용하여 파일을 보관합니다.

Syntax

# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #sevenZipCompression: 'normal' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: normal.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.
# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #sevenZipCompression: '5' # 'ultra' | 'maximum' | 'normal' | 'fast' | 'fastest' | 'none'. Optional. Use when archiveType = 7z. 7z compression. Default: 5.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.
# Archive files v2
# Compress files into .7z, .tar.gz, or .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.
    #verbose: false # boolean. Force verbose output. Default: false.
    #quiet: false # boolean. Force quiet output. Default: false.
# Archive Files v2
# Archive files using compression formats such as .7z, .rar, .tar.gz, and .zip.
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.BinariesDirectory)' # string. Required. Root folder or file to archive. Default: $(Build.BinariesDirectory).
    #includeRootFolder: true # boolean. Prepend root folder name to archive paths. Default: true.
  # Archive
    archiveType: 'zip' # 'zip' | '7z' | 'tar' | 'wim'. Required. Archive type. Default: zip.
    #tarCompression: 'gz' # 'gz' | 'bz2' | 'xz' | 'none'. Optional. Use when archiveType = tar. Tar compression. Default: gz.
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip' # string. Required. Archive file to create. Default: $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip.
    #replaceExistingArchive: true # boolean. Replace existing archive. Default: true.

입력

rootFolderOrFile - 보관할 루트 폴더 또는 파일
string. 필수 요소. 기본값은 $(Build.BinariesDirectory)입니다.

보관 파일에 추가할 루트 폴더 또는 파일 경로의 이름입니다. 폴더의 경우 명명된 폴더의 모든 항목이 보관 파일에 추가됩니다.


includeRootFolder - 경로 보관에 루트 폴더 이름 앞에 추가
boolean. 기본값은 true입니다.

루트 폴더 이름을 보관 파일 경로 앞에 추가합니다. 그렇지 않으면 모든 파일 경로가 한 수준 더 낮게 시작됩니다.

예를 들어 루트 폴더가 이 /home/user/output/classes/ 고 파일 경로 com/acme/Main.class가 인 경우 입니다. 결과 보관 파일에는 가 포함 classes/com/acme/Main.class됩니다. 그렇지 않으면 결과 보관 파일에는 가 포함 com/acme/Main.class됩니다.


archiveType - 보관 유형
string. 필수 요소. 허용되는 값: zip, 7z, tar, . wim 기본값은 zip입니다.

압축 형식을 지정합니다. 유효한 형식은 다음과 같습니다.

  • zip -기본. .zip, .jar, .war, .ear와 같은 모든 zip 호환 형식에 대해 이 형식을 선택합니다.
  • 7z - 7-Zip 형식(.7z)
  • tar - tar 형식, .tar.gz, .tar.bz2, .tar.xz를 비롯한 압축된 타르에 사용
  • wim - wim 형식, .wim

예를 들어 라는 아카이브를 만듭니다 foo.jar.

  • 압축 형식 선택 zip
  • 만들 보관 파일의 이름을 지정합니다. foo.jar

sevenZipCompression - 7z 압축
string. (선택 사항) 를 사용하는 경우 archiveType = 7z를 사용합니다. 허용되는 값: ultra, maximum, normal, fast, fastest, . none 기본값은 normal입니다.

압축 수준을 설정하거나 None 압축되지 않은 .7z 파일을 만듭니다.


sevenZipCompression - 7z 압축
string. (선택 사항) 를 사용하는 경우 archiveType = 7z를 사용합니다. 허용되는 값: ultra, maximum, normal, fast, fastest, . none 기본값은 5입니다.

압축 형식을 설정하거나 None 압축되지 않은 .7z 파일을 만듭니다.


tarCompression - Tar 압축
string. (선택 사항) 를 사용하는 경우 archiveType = tar를 사용합니다. 허용되는 값: gz, bz2, xz, . none 기본값은 gz입니다.

압축 형식을 설정하거나 압축되지 않은 .tar 파일을 만들도록 선택합니다 None .

  • gz - gzip 압축의 기본 형식(.tar.gz, .tar.tgz, .taz)
  • bz2 - bzip2 압축(.tar.bz2, .tz2, .tbz2)
  • xz - xz 압축(.tar.xz, .txz)

archiveFile - 만들 보관 파일
string. 필수 요소. 기본값은 $(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip입니다.

만들 보관 파일의 이름을 지정합니다. 예를 들어 를 만들 foo.tgz려면

  • 보관 유형 설정: tar
  • tar 압축 설정: gz

replaceExistingArchive - 기존 보관 파일 바꾸기
boolean. 기본값은 true입니다.

기본적으로 는 기존 보관 파일을 덮어씁니다. 그렇지 않으면 로 false설정하면 압축되지 않은 tar 파일이 기존 보관 파일에 추가됩니다.

기존 보관 파일에 추가할 수 있는 지원되는 파일 형식:

  • zip
  • 7z
  • tar - 압축되지 않은 경우에만
  • wim

verbose - 자세한 정보 표시 출력 강제 적용
boolean. 기본값은 false입니다.

true로 설정하면 도구에서 자세한 정보 표시 출력을 사용하도록 강제 적용합니다. 'quiet' 설정을 재정의합니다.


quiet - 자동 출력 강제 적용
boolean. 기본값은 false입니다.

true설정하면 도구에서 자동 출력을 강제로 사용합니다. 설정(또는 해당)은 verbose 이 설정을 재정의할 수 있습니다.


작업 제어 옵션

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

출력 변수

없음

설명

이 작업을 사용하여 원본 폴더에서 보관 파일을 만듭니다. 표준 보관 형식은 .zip, .jar, .war, .ear, .tar, .7z 등을 포함하여 지원됩니다.

요구 사항

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