AzureFileCopy@6 - Azure 파일 복사 v6 작업

파일을 Azure Blob Storage 또는 가상 머신에 복사합니다.

이 버전의 작업은 워크로드 ID 페더레이션을 지원하고 Azure RBAC를 사용하여 Azure Storage에 액세스합니다. Azure RBAC를 사용하면 SAS 토큰이 더 이상 사용되지 않습니다. 자세한 내용은 설명 섹션을 참조하세요.

# Azure file copy v6
# Copy files to Azure Blob Storage or virtual machines.
- task: AzureFileCopy@6
  inputs:
    SourcePath: # string. Required. Source. 
    azureSubscription: # string. Alias: ConnectedServiceNameARM. Required. Azure Subscription. 
    Destination: # 'AzureBlob' | 'AzureVMs'. Required. Destination Type. 
    storage: # string. Alias: StorageAccountRM. Required. RM Storage Account. 
    #ContainerName: # string. Required when Destination = AzureBlob. Container Name. 
    #BlobPrefix: # string. Optional. Use when Destination = AzureBlob. Blob Prefix. 
    #resourceGroup: # string. Alias: EnvironmentNameRM. Required when Destination = AzureVMs. Resource Group. 
    #ResourceFilteringMethod: 'machineNames' # 'machineNames' | 'tags'. Optional. Use when Destination = AzureVMs. Select Machines By. Default: machineNames.
    #MachineNames: # string. Optional. Use when Destination = AzureVMs. Filter Criteria. 
    #vmsAdminUserName: # string. Required when Destination = AzureVMs. Admin Login. 
    #vmsAdminPassword: # string. Required when Destination = AzureVMs. Password. 
    #TargetPath: # string. Required when Destination = AzureVMs. Destination Folder. 
    #AdditionalArgumentsForBlobCopy: # string. Optional Arguments (for uploading files to blob). 
    #AdditionalArgumentsForVMCopy: # string. Optional. Use when Destination = AzureVMs. Optional Arguments (for downloading files to VM). 
    #enableCopyPrerequisites: false # boolean. Optional. Use when Destination = AzureVMs. Enable Copy Prerequisites. Default: false.
    #CopyFilesInParallel: true # boolean. Optional. Use when Destination = AzureVMs. Copy in Parallel. Default: true.
    #CleanTargetBeforeCopy: false # boolean. Clean Target. Default: false.
    #skipCACheck: true # boolean. Optional. Use when Destination = AzureVMs. Test Certificate. Default: true.

SourcePath - 소스
string. 필수 요소.

원본 파일의 위치입니다. 지원되는 값에는 YAML 파이프라인 및 클래식 릴리스 지원 Build.Repository.LocalPath와 같은 미리 정의된 시스템 변수가 포함됩니다.

릴리스 변수는 클래식 릴리스에서만 지원됩니다. 야생 카드 기호(*)는 파일 경로 또는 파일 이름에서 지원됩니다.

식은 단일 폴더 또는 파일을 반환해야 합니다.

azureSubscription - Azure 구독
입력 별칭: ConnectedServiceNameARM. string. 필수 요소.

대상 Azure 서비스, 가상 머신 또는 스토리지 계정이 있는 구독에 대해 구성된 Azure Resource Manager 서비스 연결의 이름을 지정합니다. 자세한 내용은 Azure Resource Manager 개요를 참조하세요.

Destination - 대상 유형
string. 필수 요소. 허용되는 값: AzureBlob (Azure Blob), AzureVMs (Azure VM).

대상 유형을 지정합니다.

storage - RM Storage 계정
입력 별칭: StorageAccountRM. string. 필수 요소.

기존 ARM 스토리지 계정을 지정합니다. Azure VM에 파일을 복사하기 위한 중개자로 사용되는 스토리지 계정입니다.

ContainerName - 컨테이너 이름
string. 필요한 경우 Destination = AzureBlob입니다.

파일이 복사되는 컨테이너의 이름입니다. 지정된 컨테이너가 스토리지 계정에 없으면 만들어집니다.

컨테이너 내에 가상 디렉터리를 만들려면 Blob 접두사 입력을 사용합니다. 예를 들어 대상 위치 https://myaccount.blob.core.windows.net/mycontainer/vd1/vd2/의 경우 컨테이너 이름 mycontainer 및 Blob 접두사를 지정합니다 vd1/vd2.

BlobPrefix - Blob 접두사
string. 선택 사항입니다. 를 사용하는 경우 Destination = AzureBlob를 사용합니다.

Azure Blob 컨테이너 내에서 대상 가상 디렉터리에 대한 접두사를 지정합니다. 이는 에 SourcePath 여러 항목과 일치할 수 있는 와일드카드가 포함된 경우에 적용됩니다.

예: 빌드 번호를 추가하여 빌드 번호가 동일한 모든 Blob의 파일을 접두사로 지정할 수 있습니다.

예: Blob 접두 myvd1사를 지정하면 컨테이너 내에 가상 디렉터리가 만들어집니다. 파일은 원본 https://myaccount.blob.core.windows.net/mycontainer/myvd1/에서 로 복사됩니다.

가 와일드카드가 SourcePath 없는 단일 항목인 경우 이 Blob 접두사는 대상 Blob 이름으로 작동합니다.

resourceGroup - 리소스 그룹
입력 별칭: EnvironmentNameRM. string. 필요한 경우 Destination = AzureVMs입니다.

파일을 복사할 대상 리소스 그룹의 이름을 지정합니다.

ResourceFilteringMethod - 컴퓨터 기준 선택
string. 선택 사항입니다. 를 사용하는 경우 Destination = AzureVMs를 사용합니다. 허용되는 값: machineNames (컴퓨터 이름), tags. 기본값은 machineNames입니다.

리소스 그룹의 VM 하위 집합을 식별하는 VM 호스트 이름 또는 태그를 지정합니다. 태그는 Azure Resource Manager 통해 만든 리소스에 대해서만 지원됩니다.

MachineNames - 필터 조건
string. 선택 사항입니다. 를 사용하는 경우 Destination = AzureVMs를 사용합니다.

작업이 대상으로 하는 VM을 식별하는 VM 이름 또는 태그 이름 목록을 제공합니다. 유효한 필터 조건에는 다음이 포함됩니다.

• Azure 리소스 그룹의 이름입니다.
• 이전 작업의 출력 변수입니다.
• 태그 이름 또는 VM 이름의 쉼표로 구분된 목록입니다.
• 쉼표로 구분된 FQDN 또는 IP 주소 목록을 사용하여 VM 이름 서식을 지정합니다.
• 필터의 태그 이름 서식을 예제로 지정 {TagName}:{Value} 합니다. Role:DB;OS:Win8.1

vmsAdminUserName - 관리 로그인
string. 필요한 경우 Destination = AzureVMs입니다.

모든 대상 VM에 대한 관리 권한이 있는 계정의 사용자 이름을 제공합니다.

• 지원되는 형식은 username, , domain\usernamemachine-name\username및 입니다.\username.
• 과 같은 NT Authority\System 기본 제공 시스템 계정을 포함한 username@domain.com UPN 형식은 지원되지 않습니다.

vmsAdminPassword - 암호
string. 필요한 경우 Destination = AzureVMs입니다.

매개 변수에 대한 Admin Login 암호를 제공합니다.

변수를 찾으려면 매개 변수를 찾습니다 Admin Login . 탭에 정의된 Variables 변수의 자물쇠 아이콘을 선택하여 값을 보호하고 여기에 변수 이름을 삽입합니다.

TargetPath - 대상 폴더
string. 필요한 경우 Destination = AzureVMs입니다.

파일을 복사할 Azure VM의 폴더 경로를 지정합니다.

및 $env:systemroot 와 같은 $env:windir 환경 변수가 지원됩니다. 예: $env:windir\FabrikamFiber\Web 및 c:\FabrikamFiber

AdditionalArgumentsForBlobCopy - 선택적 인수(Blob에 파일 업로드용)
string.

Blob에 AzCopy.exe 업로드하고 VM에 다운로드할 때 사용할 추가 인수를 제공합니다. 자세한 내용은 AzCopy Command-Line 유틸리티를 사용하여 데이터 전송 을 참조하세요.

Azure 페이지 Blob만 지원하는 Premium Storage 계정의 경우 추가 인수로 사용합니다 --blob-type=PageBlob .

기본 인수에는 (기본값) 및 --recursive (컨테이너 이름이 아닌 $root경우)이 포함 --log-level=INFO 됩니다.

AdditionalArgumentsForVMCopy - 선택적 인수(VM에 파일 다운로드용)
string. 선택 사항입니다. 를 사용하는 경우 Destination = AzureVMs를 사용합니다.

와 같은 --check-length=trueVM에 AzCopy.exe 다운로드할 때 적용되는 추가 인수를 제공합니다.

선택적 인수를 지정하지 않으면 기본적으로 다음이 추가됩니다.

• --log-level=INFO
• --log-level=DEBUG (파이프라인이 디버그 모드 집합에서 실행 중인 경우)
• --recursive

enableCopyPrerequisites - 복사 필수 구성 요소 사용
boolean. 선택 사항입니다. 를 사용하는 경우 Destination = AzureVMs를 사용합니다. 기본값은 false입니다.

사용하도록 설정하면 이 옵션은 자체 서명된 인증서를 사용하여 포트 5986의 HTTPS 프로토콜을 통해 WinRM(Windows 원격 관리) 수신기를 구성합니다. 이 구성은 Azure VM에서 복사 작업을 수행하는 데 필요합니다. ARM VM에만 적용됩니다.

• 부하 분산 장치를 통해 대상 VM에 액세스하는 경우 포트 5986에 대한 액세스를 허용하도록 인바운드 NAT 규칙을 구성합니다.
• 대상 VM이 NSG(네트워크 보안 그룹)와 연결된 경우 포트 5986에 대한 액세스를 허용하도록 인바운드 보안 규칙을 구성합니다.

CopyFilesInParallel - 병렬로 복사
boolean. 선택 사항입니다. 을 사용할 때 Destination = AzureVMs사용합니다. 기본값은 true입니다.

대상 VM에 병렬로 파일을 복사하도록 지정 true 합니다.

CleanTargetBeforeCopy - 대상 정리
boolean. 기본값은 false입니다.

true 파일을 복사하기 전에 대상 폴더를 클린 지정합니다.

skipCACheck - 인증서 테스트
boolean. 선택 사항입니다. 을 사용할 때 Destination = AzureVMs사용합니다. 기본값은 true입니다.

WinRM은 중간 스토리지 Blob에서 Azure VM으로 파일을 복사할 때 HTTPS 전송을 위한 인증서가 필요합니다.

자체 서명된 인증서를 사용하는 경우 를 지정 true 하여 프로세스가 신뢰할 수 있는 CA를 사용하여 인증서의 유효성을 검사하지 못하도록 합니다.

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

StorageContainerUri
파일이 복사된 컨테이너의 URI입니다. 선택한 대상이 Azure Blob인 경우에만 유효합니다.