ExtractFiles@1 - 파일 추출 v1 작업

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

구문론

# 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 같은 패턴을 지정해야 합니다.

다른 경로(예: 파이프라인 아티팩트)에서 파일을 추출하려면 복사 작업 사용하여 추출할 파일을 리포지토리의 루트 폴더인 $(Build.SourcesDirectory)에 복사합니다. 예를 들어 파이프라인 아티팩트를 복사하려면 파일을 $(Pipeline.Workspace)에서 $(Build.SourcesDirectory)로 이동한 다음 루트 폴더 또는 하위 폴더에서 추출합니다.

destinationFolder - 대상 폴더
string; 필수 사항입니다.

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

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

보관 콘텐츠가 추출되기 전에 대상 디렉터리의 전체 콘텐츠를 삭제(정리)하는 옵션을 지정합니다.

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

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

7z 유틸리티대한 pathToSevenZipTool - 경로
string;

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

작업 제어 옵션

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

출력 변수

없음.

비고

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

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

예시

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

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

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

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

이 예제에서는 test/one.zip 추출하고 test/two.ziptest/nested/three.zip유지합니다.

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

요구 사항

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

참고하십시오

• 파일 일치 패턴 참조