ExtractFiles@1 - 파일 v1 작업 추출

이 작업을 사용하여 .7z, .rar, .tar.gz 및 .zip 같은 다양한 보관 및 압축 파일을 추출합니다.

Syntax

# Extract files v1
# Extract a variety of archive and compression files such as .7z, .rar, .tar.gz, and .zip.
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip' # string. Required. Archive file patterns. Default: **/*.zip.
    destinationFolder: # string. Required. Destination folder. 
    #cleanDestinationFolder: true # boolean. Clean destination folder before extracting. Default: true.
    #overwriteExistingFiles: false # boolean. Overwrite existing files. Default: false.
    #pathToSevenZipTool: # string. Path to 7z utility.

입력

archiveFilePatterns - 파일 패턴 보관
string. 필수 요소. 기본값은 **/*.zip입니다.

추출할 보관 파일의 파일 경로 또는 패턴을 지정합니다. 여러 줄의 미니매치 패턴을 지원합니다. 파일 추출 작업에 대해 자세히 알아봅니다.

추출하려는 보관 파일과 일치하는 패턴을 지정합니다. 기본적으로 패턴은 리포지토리의 루트 폴더에서 시작됩니다(를 지정한 경우와 동일) $(Build.SourcesDirectory).
추출할 보관 파일과 일치하는 패턴 필터를 한 줄당 하나씩 지정합니다. 예:

• test.zip 는 루트 폴더에서 test.zip 파일을 추출합니다.
• test/*.zip 는 테스트 폴더의 모든 .zip 파일을 추출합니다.
• **/*.tar 는 루트 폴더 및 하위 폴더의 모든 .tar 파일을 추출합니다.
• **/bin/*.7z 는 "bin"이라는 하위 폴더의 모든 .7z 파일을 추출합니다.
  패턴은 폴더 경로가 아닌 보관 파일 경로만 일치시키고 추출할 콘텐츠를 보관하지 않는 데 사용됩니다. 따라서 대신 **/bin와 같은 **/bin/** 패턴을 지정해야 합니다.

destinationFolder - 대상 폴더
string. 필수 요소.

보관 파일을 추출할 대상 폴더를 지정합니다. 파일이 리포지토리에 없는 경우 변수 를 사용합니다. 예: $(agent.builddirectory)

cleanDestinationFolder - 추출하기 전에 대상 폴더 정리
boolean. 기본값은 true입니다.

보관 내용이 추출되기 전에 대상 디렉터리를 정리하는 옵션을 지정합니다.

overwriteExistingFiles - 기존 파일 덮어쓰기
boolean. 기본값은 false입니다.

대상 디렉터리의 기존 파일이 이미 있는 경우 덮어쓰는 옵션을 지정합니다. 옵션이 인 경우 스크립트는 false기존 파일을 덮어쓸지 여부를 묻는 메시지를 표시합니다.

pathToSevenZipTool - 7z 유틸리티 경로
string.

7z 유틸리티에 대한 사용자 지정 경로를 지정합니다. 예를 들어 C:\7z\7z.exe Windows 및 /usr/local/bin/7z MacOS/Ubuntu에서. Windows에서 지정되지 않은 경우 작업과 함께 제공되는 기본 7zip 버전이 사용됩니다.

작업 제어 옵션

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

출력 변수

없음

설명

이 작업을 사용하여 일치 패턴을 사용하여 보관 파일에서 대상 폴더로 파일을 추출합니다. .zip, .jar, .war, .ear, .tar, .7z 등을 비롯한 다양한 표준 보관 형식이 지원됩니다.

파일 일치 패턴에 대한 자세한 내용은 파일 일치 패턴 참조를 참조하세요.

예제

모든 .zip 파일을 재귀적으로 추출

이 예제에서는 하위 폴더에서 루트 파일과 파일을 포함하여 모든 .zip 파일을 재귀적으로 추출합니다.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: '**/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

하위 폴더에서 모든 .zip 파일 추출

이 예제에서는 및 를 test/two.zip추출 test/one.zip 하지만 은 그대로 둡니다test/nested/three.zip.

steps:
- task: ExtractFiles@1
  inputs:
    archiveFilePatterns: 'test/*.zip'
    cleanDestinationFolder: true
    overwriteExistingFiles: false

요구 사항

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

추가 정보

• 파일 일치 패턴 참조