AzureResourceManagerTemplateDeployment@3 - ARM 템플릿 배포 v3 작업

이 작업을 사용하여 ARM(Azure Resource Manager) 템플릿을 모든 배포 범위에 배포합니다.

통사론

# ARM template deployment v3
# Deploy an Azure Resource Manager (ARM) template to all the deployment scopes.
- task: AzureResourceManagerTemplateDeployment@3
  inputs:
  # Azure Details
    deploymentScope: 'Resource Group' # 'Management Group' | 'Subscription' | 'Resource Group'. Required. Deployment scope. Default: Resource Group.
    azureResourceManagerConnection: # string. Alias: ConnectedServiceName. Required. Azure Resource Manager connection. 
    #subscriptionId: # string. Alias: subscriptionName. Required when deploymentScope != Management Group. Subscription. 
    #action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'DeleteRG'. Required when deploymentScope = Resource Group. Action. Default: Create Or Update Resource Group.
    #resourceGroupName: # string. Required when deploymentScope = Resource Group. Resource group. 
    #location: # string. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Location. 
  # Template
    #templateLocation: 'Linked artifact' # 'Linked artifact' | 'URL of the file'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Template location. Default: Linked artifact.
    #csmFileLink: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template link. 
    #csmParametersFileLink: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file. Template parameters link. 
    #csmFile: # string. Required when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template. 
    #csmParametersFile: # string. Optional. Use when (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact. Template parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Override template parameters. 
    #deploymentMode: 'Incremental' # 'Incremental' | 'Complete' | 'Validation'. Required when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment mode. Default: Incremental.
  # Advanced
    #deploymentName: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment name. 
    #deploymentOutputs: # string. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Deployment outputs. 
    #addSpnToEnvironment: false # boolean. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Access service principal details in override parameters. Default: false.
    #useWithoutJSON: false # boolean. Optional. Use when action = Create Or Update Resource Group || deploymentScope != Resource Group. Use individual output values without JSON.Stringify applied. Default: false.

입력

deploymentScope - 배포 범위
string. 필수. 허용되는 값: Management Group, Subscription, Resource Group. 기본값: Resource Group.

배포의 범위입니다. 배포 범위에 대해 자세히 알아봅니다.

Azure Resource Manager 연결azureResourceManagerConnection -
입력 별칭: ConnectedServiceName. string. 필수.

선택한 배포 범위에 대한 액세스 권한이 있는 Azure Resource Manager 서비스 연결을 지정합니다.

subscriptionId - 구독
입력 별칭: subscriptionName. string. deploymentScope != Management Group때 필요합니다.

Azure 구독을 지정합니다.

중요하다

지정된 값은 구독 이름이 아닌 구독 ID여야 합니다.

action - 작업
string. deploymentScope = Resource Group때 필요합니다. 허용되는 값: Create Or Update Resource Group, DeleteRG(리소스 그룹 삭제). 기본값: Create Or Update Resource Group.

Azure 리소스 또는 리소스 그룹에서 수행할 작업입니다.

resourceGroupName - 리소스 그룹
string. deploymentScope = Resource Group때 필요합니다.

리소스 그룹의 이름을 제공합니다.

location - 위치
string. action = Create Or Update Resource Group || deploymentScope != Resource Group때 필요합니다.

리소스 그룹 배포 범위: 리소스 그룹을 배포할 위치입니다. 리소스 그룹이 Azure 구독에 이미 있는 경우 이 값은 무시됩니다. 기타 배포 범위: 배포 메타데이터를 저장할 위치입니다.

templateLocation - 템플릿 위치
string. action = Create Or Update Resource Group || deploymentScope != Resource Group때 필요합니다. 허용되는 값: Linked artifact, URL of the file. 기본값: Linked artifact.

템플릿 및 매개 변수 JSON 파일의 위치입니다. 파일이 연결된 코드/빌드 아티팩트 중 일부인 경우 연결된 아티팩트 선택합니다. 연결된 아티팩트에서 Bicep 파일의 경로를 지정할 수도 있습니다. JSON 파일이 공개적으로 액세스할 수 있는 http/https URL에 있는 경우 파일 URL을 선택합니다. 프라이빗 스토리지 계정에 저장된 파일을 사용하려면 템플릿의 URL에 SAS(공유 액세스 서명) 토큰을 검색하고 포함합니다. 예: <blob_storage_url>/template.json?. 스토리지 계정에 매개 변수 파일을 업로드하고 SAS 토큰을 생성하려면 Azure 파일 복사 작업 사용하거나 PowerShell 사용하거나 Azure CLI 단계를 수행할 수 있습니다.

csmFileLink - 템플릿 링크
string. (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file때 필요합니다.

템플릿 파일의 URL을 지정합니다. URL 예: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.json

프라이빗 스토리지 계정에 저장된 템플릿을 배포하려면 템플릿의 URL에 SAS(공유 액세스 서명) 토큰을 검색하고 포함합니다. 예: <blob_storage_url>/template.json?<SAStoken>. 스토리지 계정에 템플릿 파일(또는 연결된 템플릿)을 업로드하고 SAS 토큰을 생성하려면 Azure 파일 복사 작업을 사용하거나 PowerShell 사용하거나 Azure CLI 단계를 수행합니다.

표에서 템플릿 매개 변수를 보려면 재정의 템플릿 매개 변수 텍스트 상자 옆에 있는 ... 클릭합니다. 이 기능을 사용하려면 원본에서 CORS 규칙을 사용하도록 설정해야 합니다. 템플릿이 Azure Storage Blob에 있는 경우 원본 간 리소스 공유 참조하여 CORS를 사용하도록 설정합니다.

csmParametersFileLink - 템플릿 매개 변수 링크
string. 선택적. (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = URL of the file때 사용합니다.

매개 변수 파일의 URL을 지정합니다. URL 예: https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-vm-simple-windows/azuredeploy.parameters.json

프라이빗 스토리지 계정에 저장된 파일을 사용하려면 템플릿의 URL에 SAS(공유 액세스 서명) 토큰을 검색하고 포함합니다. 예: <blob_storage_url>/template.json?<SAStoken>. 스토리지 계정에 템플릿 파일(또는 연결된 템플릿)을 업로드하고 SAS 토큰을 생성하려면 Azure 파일 복사 작업을 사용하거나 PowerShell 사용하거나 Azure CLI 단계를 수행합니다.

그리드에서 템플릿 매개 변수를 보려면 템플릿 매개 변수 재정의 텍스트 상자 옆에 있는 ... 클릭합니다. 이 기능을 사용하려면 원본에서 CORS 규칙을 사용하도록 설정해야 합니다. 템플릿이 Azure Storage Blob에 있는 경우 원본 간 리소스 공유 참조하여 CORS를 사용하도록 설정합니다.

csmFile - 템플릿
string. (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact때 필요합니다.

Azure Resource Manager 템플릿을 가리키는 경로 또는 패턴을 지정합니다. Azure Resource Manager 템플릿 대해 자세히 알아봅니다. 즉시 시작하려면 이 샘플 템플릿 사용합니다. Azure CLI 버전이 2.20.0을 > 경우 Bicep 파일을 지원합니다.

csmParametersFile - 템플릿 매개 변수
string. 선택적. (action = Create Or Update Resource Group || deploymentScope != Resource Group) && templateLocation = Linked artifact때 사용합니다.

Azure Resource Manager 템플릿의 매개 변수 파일을 가리키는 경로 또는 패턴을 지정합니다. Azure CLI 버전이 2.47.0을 > 경우 Bicep Param 파일을 지원합니다.

템플릿 매개 변수재정의 overrideParameters -
string. 선택적. action = Create Or Update Resource Group || deploymentScope != Resource Group때 사용합니다.

재정의할 템플릿 매개 변수를 지정합니다.

표에서 템플릿 매개 변수를 보려면 매개 변수 재정의 텍스트 상자 옆에 있는 ... 클릭합니다. 이 기능을 사용하려면 원본에서 CORS 규칙을 사용하도록 설정해야 합니다. 템플릿이 Azure Storage Blob에 있는 경우 이 문자열을 참조하여 CORS를 사용하도록 설정하거나 텍스트 상자에 재정의할 템플릿 매개 변수를 입력합니다.

예: -storageName fabrikam -adminUsername $(vmusername) -adminPassword (ConvertTo-SecureString -String '$(password)' -AsPlainText -Force) -azureKeyVaultName $(fabrikamFibre).

매개 변수 값에 여러 단어가 있는 경우 변수를 사용하여 값을 전달하는 경우에도 단어를 따옴표로 묶습니다. 예를 들어 -name "parameter value" -name2 "$(var)". 개체 형식 매개 변수를 재정의하려면 문자열화된 JSON 개체를 사용합니다. 예를 들어 -options ["option1"] -map {"key1": "value1" }.

deploymentMode - 배포 모드
string. action = Create Or Update Resource Group || deploymentScope != Resource Group때 필요합니다. 허용되는 값: Incremental, Complete, Validation(유효성 검사에만 해당) 기본값: Incremental.

Incremental 모드는 배포를 리소스 그룹에 대한 증분 업데이트로 처리합니다. 리소스 그룹에 있지만 템플릿에 지정되지 않은 변경되지 않은 리소스를 남깁니다.

Complete 모드는 템플릿에 없는 리소스를 삭제합니다. 전체 모드는 증분 모드보다 비교적 많은 시간이 걸립니다. 작업 시간이 초과되면 시간 제한을 늘리거나 Incremental 모드로 변경하는 것이 좋습니다.

경고

전체 모드는 템플릿에 지정되지 않은 리소스 그룹의 모든 기존 리소스를 삭제합니다. 배포하려는 리소스 그룹에 템플릿에 지정되지 않은 필요한 리소스가 포함되어 있지 않은지 검토하세요. Validate 모드를 사용하면 실제 리소스를 만들기 전에 템플릿 문제를 찾을 수 있습니다.

메모

Validate 모드는 리소스가 배포되지 않더라도 항상 리소스 그룹을 만듭니다. 배포 모드에 대해 자세히 알아봅니다.

deploymentName - 배포 이름
string. 선택적. action = Create Or Update Resource Group || deploymentScope != Resource Group때 사용합니다.

만들 리소스 그룹 배포의 이름을 지정합니다.

deploymentOutputs - 배포 출력
string. 선택적. action = Create Or Update Resource Group || deploymentScope != Resource Group때 사용합니다.

현재 배포 개체의 출력 섹션을 문자열 형식으로 포함하는 출력 변수의 변수 이름을 제공합니다. ConvertFrom-Json PowerShell cmdlet을 사용하여 JSON 개체를 구문 분석하고 개별 출력 값에 액세스할 수 있습니다. 배포 출력에 대해 자세히 알아봅니다.

재정의 매개 변수서비스 주체 세부 정보 액세스 addSpnToEnvironment -
boolean. 선택적. action = Create Or Update Resource Group || deploymentScope != Resource Group때 사용합니다. 기본값: false.

스크립트의 실행 환경으로 선택한 Azure 엔드포인트의 서비스 주체 ID와 키를 추가합니다. $servicePrincipalId 및 $servicePrincipalKey 변수는 -key $servicePrincipalKey같은 재정의 매개 변수에 있을 수 있습니다.

useWithoutJSON - JSON 없이 개별 출력 값을 사용합니다. Stringify 적용된
boolean. 선택적. action = Create Or Update Resource Group || deploymentScope != Resource Group때 사용합니다. 기본값: false.

개별 출력 값은 JSON을 통해 변환됩니다. 기본적으로 Stringify입니다. 출력 값을 JSON을 통해 변환하지 않고 그대로 사용하려는 경우 Stringify, 이 옵션을 사용하도록 설정합니다. 자세한 내용은 이 참조하세요.

작업 제어 옵션

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

출력 변수

없음.

발언

메모

이 작업은 Azure CLI 버전이 2.20.0을 > 경우 Bicep 파일을 지원합니다.

• 모든 배포 범위에서 배포에 대한 지원이 추가되었습니다.
  • 모든 VM 관련 작업을 제거했습니다.

요구 사항

요구	묘사
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행	에이전트, DeploymentGroup
요구	없음
기능	이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한	어떤
settable 변수	어떤
에이전트 버전	2.119.1 이상
작업 범주	전개시키다