AzureResourceGroupDeployment@1 - Azure 리소스 그룹 배포 v1 작업

아티클
08/19/2024

이 작업을 사용하여 Azure 리소스 그룹을 배포, 시작, 중지 및 삭제할 수 있습니다.

이 작업은 더 이상 사용되지 않습니다. AzureResourceGroupDeployment@2 사용합니다.

Syntax

# Azure Resource Group Deployment v1
# Deploy, start, stop, delete Azure Resource Groups.
- task: AzureResourceGroupDeployment@1
  inputs:
    #ConnectedServiceNameSelector: 'ConnectedServiceName' # 'ConnectedServiceName' | 'ConnectedServiceNameClassic'. Azure Connection Type. Default: ConnectedServiceName.
    ConnectedServiceName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Azure Subscription. 
    #ConnectedServiceNameClassic: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Azure Classic Subscription. 
    action: 'Create Or Update Resource Group' # 'Create Or Update Resource Group' | 'Select Resource Group' | 'Start' | 'Stop' | 'Restart' | 'Delete' | 'DeleteRG'. Required when ConnectedServiceNameSelector = ConnectedServiceName. Action. Default: Create Or Update Resource Group.
    #actionClassic: 'Select Resource Group' # 'Select Resource Group'. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Action. Default: Select Resource Group.
    resourceGroupName: # string. Required when ConnectedServiceNameSelector = ConnectedServiceName. Resource Group. 
    #cloudService: # string. Required when ConnectedServiceNameSelector = ConnectedServiceNameClassic. Cloud Service. 
    #location: 'East US' # 'Australia East' | 'Australia Southeast' | 'Brazil South' | 'Canada Central' | 'Canada East' | 'Central India' | 'Central US' | 'East Asia' | 'East US' | 'East US 2 ' | 'Japan East' | 'Japan West' | 'North Central US' | 'North Europe' | 'South Central US' | 'South India' | 'Southeast Asia' | 'UK South' | 'UK West' | 'West Central US' | 'West Europe' | 'West India' | 'West US' | 'West US 2'. Required when action = Create Or Update Resource Group. Location. Default: East US.
    #csmFile: # string. Required when action = Create Or Update Resource Group. Template. 
    #csmParametersFile: # string. Optional. Use when action = Create Or Update Resource Group. Template Parameters. 
    #overrideParameters: # string. Optional. Use when action = Create Or Update Resource Group. Override Template Parameters. 
    #deploymentMode: 'Incremental' # 'Validation' | 'Incremental' | 'Complete'. Required when action = Create Or Update Resource Group. Deployment Mode. Default: Incremental.
    #enableDeploymentPrerequisitesForCreate: false # boolean. Optional. Use when action = Create Or Update Resource Group. Enable Deployment Prerequisites. Default: false.
    #enableDeploymentPrerequisitesForSelect: false # boolean. Optional. Use when action = Select Resource Group. Enable Deployment Prerequisites. Default: false.
  # Output
    #outputVariable: # string. Resource Group.

입력

ConnectedServiceNameSelector - Azure 연결 유형
string. 허용되는 값: ConnectedServiceName (Azure Resource Manager), ConnectedServiceNameClassic (Azure 클래식). 기본값은 ConnectedServiceName입니다.

필수 사항입니다. 배포에 대한 Azure 구독이 포함된 서비스 연결을 선택합니다.

ConnectedServiceName - Azure 구독
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceName입니다.

필수 사항입니다. 배포에 대한 Azure 구독이 포함된 서비스 연결을 선택합니다.

ConnectedServiceNameClassic - Azure 클래식 구독
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceNameClassic입니다.

배포에 대한 Azure 클래식 구독을 선택합니다.

action - 작업
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceName입니다. 허용되는 값: Create Or Update Resource Group, , Select Resource GroupStart (Virtual Machines 시작), (Virtual Machines 중지), StopRestart (Virtual Machines 다시 시작), Delete (Virtual Machines 삭제), DeleteRG (리소스 그룹 삭제). 기본값은 Create Or Update Resource Group입니다.

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

actionClassic - 작업
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceNameClassic입니다. 허용되는 값: Select Resource Group (클라우드 서비스 선택). 기본값은 Select Resource Group입니다.

Azure 리소스 또는 클라우드 서비스에서 수행할 작업입니다.

resourceGroupName - 리소스 그룹
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceName입니다.

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

cloudService - 클라우드 서비스
string. 필요한 경우 ConnectedServiceNameSelector = ConnectedServiceNameClassic입니다.

클라우드 서비스의 이름을 제공합니다.

location - 위치
string. 필요한 경우 action = Create Or Update Resource Group입니다. 허용되는 값: Australia East, , Australia Southeast, Brazil South, Canada Central, Canada EastCentral India, Central US, Japan EastEast US 2 Japan WestNorth Central USEast USSoutheast AsiaEast AsiaSouth IndiaSouth Central USNorth Europe, . UK SouthUK WestWest Central USWest EuropeWest IndiaWest USWest US 2 기본값은 East US입니다.

리소스 그룹을 배포할 위치입니다. 리소스 그룹이 구독에 이미 있는 경우 이 값은 무시됩니다.

csmFile - 템플릿
string. 필요한 경우 action = Create Or Update Resource Group입니다.

Azure Resource Manager 템플릿을 가리키는 경로 또는 패턴을 지정합니다. Azure Resource Manager 템플릿에 대해 자세히 알아보세요. 즉시 시작하려면 이 샘플 템플릿을 사용합니다.

csmParametersFile - 템플릿 매개 변수
string. 선택 사항입니다. 을 사용할 때 action = Create Or Update Resource Group사용합니다.

매개 변수 파일의 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를 사용하도록 설정합니다.

overrideParameters - 템플릿 매개 변수 재정의
string. 선택 사항입니다. 을 사용할 때 action = Create Or Update 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입니다. 허용되는 값: Validation (유효성 검사에만 해당), Incremental, . Complete 기본값은 Incremental입니다.

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

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

경고

전체 모드는 템플릿에 지정되지 않은 리소스 그룹의 모든 기존 리소스를 삭제합니다. 배포하려는 리소스 그룹에 템플릿에 지정되지 않은 필요한 리소스가 포함되어 있지 않은지 검토합니다.

Validate 모드를 사용하면 실제 리소스를 만들기 전에 템플릿 문제를 찾을 수 있습니다.

참고

리소스가 배포되지 않더라도 모드는 Validate 항상 리소스 그룹을 만듭니다.

배포 모드에 대해 자세히 알아보세요.

enableDeploymentPrerequisitesForCreate - 배포 필수 구성 요소 사용
boolean. 선택 사항입니다. 을 사용할 때 action = Create Or Update Resource Group사용합니다. 기본값은 false입니다.

리소스 그룹에 가상 머신이 포함된 경우에만 적용됩니다.

배포 그룹 옵션을 선택하면 각 가상 머신에서 배포 그룹 에이전트가 구성됩니다.

WinRM 옵션을 선택하면 자체 서명된 인증서를 사용하여 포트 5986에서 HTTPS 프로토콜을 통해 WinRM(Windows 원격 관리) 수신기를 구성합니다. 이 구성은 Azure 머신에서 배포 작업을 수행하는 데 필요합니다. 대상 가상 머신이 부하 분산 장치에서 지원하는 경우 인바운드 NAT 규칙이 대상 포트(5986)에 대해 구성되어 있는지 확인합니다.

enableDeploymentPrerequisitesForSelect - 배포 필수 구성 요소 사용
boolean. 선택 사항입니다. 을 사용할 때 action = Select Resource Group사용합니다. 기본값은 false입니다.

리소스 그룹에 가상 머신이 포함된 경우에만 적용됩니다.

배포 그룹 옵션을 선택하면 각 가상 머신에서 배포 그룹 에이전트가 구성됩니다.

outputVariable - 리소스 그룹
string.

기존 리소스 그룹을 선택할 때 필요합니다. 리소스 그룹 변수의 이름을 제공합니다. 변수를 사용하여 $(variableName) 애플리케이션 배포를 위한 대상 컴퓨터의 PowerShell 작업과 같은 후속 작업의 리소스 그룹을 참조할 수 있습니다.

선택한 작업이 , 또는 Select인 Update경우에만 유효합니다Create.

작업 제어 옵션

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

출력 변수

없음

요구 사항

요구 사항	Description
파이프라인 유형	YAML, 클래식 빌드, 클래식 릴리스
실행 중	에이전트, DeploymentGroup
요청	자체 호스팅 에이전트에는 이 작업을 사용하는 작업을 실행하기 위한 다음 요구 사항과 일치하는 기능이 있어야 합니다. azureps
Capabilities	이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항	모두
Settable 변수	모두
에이전트 버전	1.103.0 이상
작업 범주	배포

다음을 통해 공유

AzureResourceGroupDeployment@1 - Azure 리소스 그룹 배포 v1 작업

Syntax

입력

작업 제어 옵션

출력 변수

요구 사항

피드백

추가 리소스