ArchiveFiles@2 - 파일 보관 v2 작업

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

구문론

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

입력

보관할 루트 폴더 또는 파일 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, tarwim. 기본값은 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 파일을 만듭니다.

tarCompression - Tar 압축
string; 선택 사항. archiveType = tar때 사용합니다. 허용되는 값: gz, bz2, xznone. 기본값은 gz입니다.

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

• 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 등을 포함하여 지원됩니다.

요구 사항

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