연습 - 가상 명령을 사용하여 변경 내용 미리 보기
참고
처음으로 샌드박스를 활성화하고 약관에 동의하면 Microsoft 계정이 Microsoft Learn 샌드박스라는 새로운 Azure 디렉터리와 연결됩니다. 또한 Concierge Subscription이라는 특수 구독에도 추가됩니다.
장난감 회사의 디자인 팀이 가상 네트워크를 구성하는 템플릿을 업데이트해 줄 것을 요청했습니다. 이 단원에서는 what-if를 사용하여 업데이트된 템플릿 배포의 효과를 확인합니다.
프로세스 중에 다음을 수행합니다.
- 초기 템플릿을 만들고 배포합니다.
- 약간 다른 템플릿을 배포할 준비를 하고 가상 작업을 사용하여 예상 변경 내용을 검토합니다.
- 전체 배포를 사용하여 빈 템플릿을 배포하고 what-if 작업을 사용하여 예상 변경 내용을 검토합니다.
이 연습에서는 Visual Studio Code용 Azure Resource Manager 도구를 사용합니다. Visual Studio Code에서 해당 확장을 설치해야 합니다.
이 연습에서는 Visual Studio Code용 Bicep 확장을 사용합니다. Visual Studio Code에서 해당 확장을 설치해야 합니다.
시작 템플릿 만들기
팀에서 사용 중인 기존 템플릿으로 시작합니다. 템플릿은 가상 네트워크를 만듭니다.
Visual Studio Code를 엽니다.
azuredeploy.json이라는 새 파일을 만듭니다.
Visual Studio Code에서 ARM 템플릿 도구가 로드되도록 빈 파일을 저장합니다.
파일>다른 이름으로 저장을 선택해도 되고 Windows에서 Ctrl+S(macOS는 ⌘+S) 키를 눌러도 됩니다. 파일을 저장한 위치를 기억해야 합니다. 예를 들어 파일을 저장할 scripts 폴더를 만들 수 있습니다.
다음 코드를 azuredeploy.json에 복사합니다.
{ "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "1.0.0.0", "parameters": {}, "variables": {}, "resources": [ { "apiVersion": "2018-10-01", "type": "Microsoft.Network/virtualNetworks", "name": "vnet-001", "location": "[resourceGroup().location]", "tags": { "CostCenter": "12345", "Owner": "Team A" }, "properties": { "addressSpace": { "addressPrefixes": [ "10.0.0.0/16" ] }, "enableVmProtection": false, "enableDdosProtection": false, "subnets": [ { "name": "subnet001", "properties": { "addressPrefix": "10.0.0.0/24" } }, { "name": "subnet002", "properties": { "addressPrefix": "10.0.1.0/24" } } ] } } ] }템플릿을 저장하는 경우
Visual Studio Code를 엽니다.
main.bicep이라는 새 파일을 만듭니다.
Visual Studio Code에서 Bicep 도구가 로드되도록 빈 파일을 저장합니다.
파일>다른 이름으로 저장을 선택해도 되고 Windows에서 Ctrl+S(macOS는 ⌘+S) 키를 눌러도 됩니다. 파일을 저장한 위치를 기억해야 합니다. 예를 들어 파일을 저장할 scripts 폴더를 만들 수 있습니다.
다음 코드를 main.bicep에 복사합니다.
resource vnet 'Microsoft.Network/virtualNetworks@2018-10-01' = { name: 'vnet-001' location: resourceGroup().location tags: { 'CostCenter': '12345' 'Owner': 'Team A' } properties: { addressSpace: { addressPrefixes: [ '10.0.0.0/16' ] } enableVmProtection: false enableDdosProtection: false subnets: [ { name: 'subnet001' properties: { addressPrefix: '10.0.0.0/24' } } { name: 'subnet002' properties: { addressPrefix: '10.0.1.0/24' } } ] } }템플릿을 저장하는 경우
Azure에 템플릿 배포
이 템플릿을 Azure에 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인합니다. Azure PowerShell을 설치했고 샌드박스를 활성화한 것과 동일한 계정에 로그인했는지 확인합니다.
터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창의 오른쪽에 표시된 셸이 powershell 또는 pwsh이면 올바른 셸이 열리고 다음 섹션으로 건너뛸 수 있습니다.
powershell 또는 pwsh 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 PowerShell을 선택합니다.
터미널 셸 목록에서 powershell 또는 pwsh를 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
Set-Location -Path templates
Bicep CLI 설치
Azure PowerShell에서 Bicep을 사용하려면 Bicep CLI를 설치합니다.
Azure PowerShell을 사용하여 Azure에 로그인
Visual Studio Code 터미널에서 다음 명령을 실행합니다.
Connect-AzAccountAzure 계정에 로그인할 수 있도록 브라우저가 열립니다.
Azure에 로그인하면 터미널에 계정과 연결된 구독 목록이 표시됩니다.
샌드박스를 활성화한 경우 ‘컨시어지 구독’이라는 구독이 표시됩니다. 나머지 연습에서 해당 구독을 사용합니다.
이 세션에서 실행하는 모든 Azure PowerShell 명령의 기본 구독을 설정합니다.
$context = Get-AzSubscription -SubscriptionName 'Concierge Subscription' Set-AzContext $context참고
최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다. 이전 명령이 성공했고 ‘컨시어지 구독’ 한 개만 표시되는 경우에는 다음 두 단계를 건너뜁니다.
구독 ID를 복사합니다. 다음 명령을 실행하면 구독 및 해당 ID가 나열됩니다.
Concierge Subscription을 찾은 다음 두 번째 열에서 ID를 복사합니다.cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0과 같이 표시됩니다.Get-AzSubscription활성 구독을 ‘컨시어지 구독’으로 변경합니다. {Your subscription ID}를 방금 복사한 항목으로 바꿔야 합니다.
$context = Get-AzSubscription -SubscriptionId {Your subscription ID} Set-AzContext $context
기본 리소스 그룹 설정
기본 리소스 그룹을 설정하고 이 연습의 나머지 Azure PowerShell 명령에서 매개 변수를 생략할 수 있습니다. 이 기본값을 샌드박스 환경에서 생성된 리소스 그룹으로 설정합니다.
Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>
Azure에 해당 템플릿을 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인해야 합니다. Azure CLI가 설치되어 있어야 하며, 샌드박스를 활성화할 때 사용한 것과 동일한 계정으로 로그인해야 합니다.
터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창의 오른쪽에 표시된 셸이 bash이면 올바른 셸이 열리고 다음 섹션으로 건너뛸 수 있습니다.
bash 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 Git Bash를 선택합니다.
터미널 셸 목록에서 bash를 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
cd templates
Bicep 설치
다음 명령을 실행하여 최신 버전의 Bicep이 있는지 확인합니다.
az bicep install && az bicep upgrade
Azure에 로그인
Visual Studio Code 터미널에서 다음 명령을 실행하여 Azure에 로그인합니다.
az login열리는 브라우저에서 Azure 계정에 로그인합니다.
Visual Studio Code 터미널에 이 계정과 연결된 구독 목록이 표시됩니다.
이 세션에서 실행하는 모든 Azure CLI 명령의 기본 구독을 설정합니다.
az account set --subscription "Concierge Subscription"참고
최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다. 이전 명령이 성공했고 ‘컨시어지 구독’ 한 개만 표시되는 경우에는 다음 두 단계를 건너뜁니다.
컨시어지 구독 ID를 가져옵니다.
az account list \ --refresh \ --query "[?contains(name, 'Concierge Subscription')].id" \ --output table구독 ID를 사용하여 기본 구독을 설정합니다. {your subscription ID}를 최신 Concierge Subscription ID로 바꿉니다.
az account set --subscription {your subscription ID}
기본 리소스 그룹 설정
Azure CLI를 사용하는 경우 기본 리소스 그룹을 설정하고 이 연습의 나머지 Azure CLI 명령에서 매개 변수를 생략할 수 있습니다. 기본값을 샌드박스 환경에서 생성된 리소스 그룹으로 설정합니다.
az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"
Azure에 해당 템플릿을 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인합니다. Azure PowerShell을 설치했고 샌드박스를 활성화한 것과 동일한 계정에 로그인했는지 확인합니다.
터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창의 오른쪽에 표시된 셸이 powershell 또는 pwsh이면 올바른 셸이 열리고 다음 섹션으로 건너뛸 수 있습니다.
powershell 또는 pwsh 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 PowerShell을 선택합니다.
터미널 셸 목록에서 powershell 또는 pwsh를 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
Set-Location -Path templates
Azure PowerShell을 사용하여 Azure에 로그인
Visual Studio Code 터미널에서 다음 명령을 실행합니다.
Connect-AzAccountAzure 계정에 로그인할 수 있도록 브라우저가 열립니다.
Azure에 로그인하면 터미널에 계정과 연결된 구독 목록이 표시됩니다.
샌드박스를 활성화한 경우 ‘컨시어지 구독’이라는 구독이 표시됩니다. 나머지 연습에서 해당 구독을 사용합니다.
이 세션에서 실행하는 모든 Azure PowerShell 명령의 기본 구독을 설정합니다.
$context = Get-AzSubscription -SubscriptionName 'Concierge Subscription' Set-AzContext $context참고
최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다. 이전 명령이 성공했고 ‘컨시어지 구독’ 한 개만 표시되는 경우에는 다음 두 단계를 건너뜁니다.
구독 ID를 복사합니다. 다음 명령을 실행하면 구독 및 해당 ID가 나열됩니다.
Concierge Subscription을 찾은 다음 두 번째 열에서 ID를 복사합니다.cf49fbbc-217c-4eb6-9eb5-a6a6c68295a0과 같이 표시됩니다.Get-AzSubscription활성 구독을 ‘컨시어지 구독’으로 변경합니다. {Your subscription ID}를 방금 복사한 항목으로 바꿔야 합니다.
$context = Get-AzSubscription -SubscriptionId {Your subscription ID} Set-AzContext $context
기본 리소스 그룹 설정
기본 리소스 그룹을 설정하고 이 연습의 나머지 Azure PowerShell 명령에서 매개 변수를 생략할 수 있습니다. 이 기본값을 샌드박스 환경에서 생성된 리소스 그룹으로 설정합니다.
Set-AzDefault -ResourceGroupName <rgn>[sandbox resource group name]</rgn>
Azure에 해당 템플릿을 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인해야 합니다. Azure CLI가 설치되어 있어야 하며, 샌드박스를 활성화할 때 사용한 것과 동일한 계정으로 로그인해야 합니다.
터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창의 오른쪽에 표시된 셸이 bash이면 올바른 셸이 열리고 다음 섹션으로 건너뛸 수 있습니다.
bash 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 Git Bash를 선택합니다.
터미널 셸 목록에서 bash를 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
cd templates
Azure에 로그인
Visual Studio Code 터미널에서 다음 명령을 실행하여 Azure에 로그인합니다.
az login열리는 브라우저에서 Azure 계정에 로그인합니다.
Visual Studio Code 터미널에 이 계정과 연결된 구독 목록이 표시됩니다.
이 세션에서 실행하는 모든 Azure CLI 명령의 기본 구독을 설정합니다.
az account set --subscription "Concierge Subscription"참고
최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다. 이전 명령이 성공했고 ‘컨시어지 구독’ 한 개만 표시되는 경우에는 다음 두 단계를 건너뜁니다.
컨시어지 구독 ID를 가져옵니다.
az account list \ --refresh \ --query "[?contains(name, 'Concierge Subscription')].id" \ --output table구독 ID를 사용하여 기본 구독을 설정합니다. {your subscription ID}를 최신 Concierge Subscription ID로 바꿉니다.
az account set --subscription {your subscription ID}
기본 리소스 그룹 설정
Azure CLI를 사용하는 경우 기본 리소스 그룹을 설정하고 이 연습의 나머지 Azure CLI 명령에서 매개 변수를 생략할 수 있습니다. 기본값을 샌드박스 환경에서 생성된 리소스 그룹으로 설정합니다.
az configure --defaults group="<rgn>[sandbox resource group name]</rgn>"
Azure PowerShell을 사용하여 템플릿 배포
템플릿을 배포하려면 New-AzResourceGroupDeployment를 실행합니다.
New-AzResourceGroupDeployment -TemplateFile main.bicep
터미널에 실행 중...이라는 텍스트가 나타납니다. 배포를 완료하는 데 1~2분 정도가 소요됩니다.
Azure PowerShell을 사용하여 템플릿 배포
템플릿을 배포하려면 New-AzResourceGroupDeployment를 실행합니다.
New-AzResourceGroupDeployment -TemplateFile azuredeploy.json
터미널에 실행 중...이라는 텍스트가 나타납니다. 배포를 완료하는 데 1~2분 정도가 소요됩니다.
Azure CLI를 사용하여 템플릿 배포
템플릿을 배포하려면 az deployment group create를 실행합니다.
az deployment group create --template-file main.bicep
배포를 완료하는 데 1~2분 정도가 소요됩니다.
Azure CLI를 사용하여 템플릿 배포
템플릿을 배포하려면 az deployment group create를 실행합니다.
az deployment group create --template-file azuredeploy.json
배포를 완료하는 데 1~2분 정도가 소요됩니다.
배포 확인
배포가 만들어지고 Azure로 전송되었는지 확인하려면 Azure Portal로 이동하여 샌드박스 구독에 포함되어 있는지 확인합니다.
페이지의 위쪽 모서리에서 아바타를 선택합니다.
디렉터리 전환을 선택합니다. 목록에서 Microsoft Learn 샌드박스 디렉터리를 선택합니다.
리소스 그룹을 선택합니다.
[샌드박스 리소스 그룹 이름] 을 선택합니다.개요에 성공한 배포 하나가 표시됩니다.
‘1 성공’을 선택하여 배포 세부 정보를 확인합니다.
main 배포를 선택하여 배포된 리소스를 확인합니다. 이 경우 두 개의 서브넷이 있는 하나의 가상 네트워크(주소 공간 10.0.0.0/16)가 배포되었습니다.
나중에 배포를 다시 확인할 수 있도록 브라우저에서 페이지를 열어 둡니다.
템플릿 수정
Visual Studio Code의 azuredeploy.json 파일에서
Owner라는 태그와 해당 값을 삭제합니다. 완료한 후 가상 네트워크의tags속성은 다음과 같습니다."tags": { "CostCenter": "12345" },addressPrefixes를 업데이트하여/16에서/15로 변경합니다. 완료한 후 가상 네트워크의addressSpace속성은 다음과 같습니다."addressSpace": { "addressPrefixes": [ "10.0.0.0/15" ] },subnet001이라는 서브넷을 삭제합니다. 전체 서브넷 개체를 삭제해야 합니다. 완료한 후 가상 네트워크의subnets속성은 다음과 같습니다."subnets": [ { "name": "subnet002", "properties": { "addressPrefix": "10.0.1.0/24" } } ]템플릿을 저장하는 경우
Visual Studio Code의 main.bicep 파일에서
Owner라는 태그와 해당 값을 삭제합니다. 완료한 후 가상 네트워크의tags속성은 다음과 같습니다.tags: { 'CostCenter': '12345' }addressPrefixes를 업데이트하여/16에서/15로 변경합니다. 완료한 후 가상 네트워크의addressSpace속성은 다음과 같습니다.addressSpace: { addressPrefixes: [ '10.0.0.0/15' ] }subnet001이라는 서브넷을 삭제합니다. 전체 서브넷 개체를 삭제해야 합니다. 완료한 후 가상 네트워크의subnets속성은 다음과 같습니다.subnets: [ { name: 'subnet002' properties: { addressPrefix: '10.0.1.0/24' } } ]템플릿을 저장하는 경우
수정된 템플릿을 사용하여 가상 명령 실행
-WhatIf 플래그와 함께 New-AzResourceGroupDeployment를 실행하여 가상 작업을 수행합니다.
New-AzResourceGroupDeployment `
-WhatIf `
-TemplateFile main.bicep
-WhatIf 플래그와 함께 New-AzResourceGroupDeployment를 실행하여 가상 작업을 수행합니다.
New-AzResourceGroupDeployment `
-WhatIf `
-TemplateFile azuredeploy.json
az deployment group what-if를 실행하여 가상 작업을 수행합니다.
az deployment group what-if \
--template-file main.bicep
az deployment group what-if를 실행하여 가상 작업을 수행합니다.
az deployment group what-if \
--template-file azuredeploy.json
다음과 유사하게 가상 출력이 표시됩니다.
접두사가 있는 것 외에 결과가 색으로 구분되는 것을 알 수 있습니다.
- 자주색 및 ~ - 모든 수정 사항
- 녹색 및 + - 만들려는 새 리소스
- 주황색 및 - - 삭제
템플릿의 리소스 제거
Visual Studio Code에서 azuredeploy.json 파일을 업데이트하고
resources배열의 내용을 모두 제거합니다. 완료했을 때 템플릿은 다음과 같습니다.{ "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#", "contentVersion": "1.0.0.0", "resources": [ ] }템플릿을 저장하는 경우
Visual Studio Code의 main.bicep 파일에서 파일의 내용을 모두 삭제하지만 파일 자체는 삭제하지 않습니다.
템플릿을 저장하는 경우
전체 모드 및 확인 옵션을 사용하여 배포
다음 단계에서는 기존 환경에 빈 템플릿을 배포합니다.
경고
실제로 이 작업을 수행하면 클라우드에 있는 항목이 ‘제거됩니다’. 다음 코드는 지적 실험으로 흥미롭지만 이 모드를 사용할 때는 주의해야 합니다. 제안된 변경 내용이 마음에 들지 않는 경우 이 작업을 중지할 수 있도록 최소한 -Confirm 플래그를 사용합니다.
경고
실제로 이 작업을 수행하면 클라우드에 있는 항목이 ‘제거됩니다’. 다음 코드는 지적 실험으로 흥미롭지만 이 모드를 사용할 때는 주의해야 합니다. 제안된 변경 내용이 마음에 들지 않는 경우 이 작업을 중지할 수 있도록 최소한 --confirm-with-what-if 플래그를 사용합니다.
-Mode Complete플래그와 함께New-AzResourceGroupDeployment를 실행하여 전체 모드에서 배포를 실행합니다.New-AzResourceGroupDeployment ` -Mode Complete ` -Confirm ` -TemplateFile main.bicep출력은 다음과 유사하게 표시됩니다.
출력의 마지막 줄이 확인임에 유의하세요. 이 줄은 계속하려면 y 또는 n을 선택할 것을 요청합니다.
[A] 모두 예에 A를 입력하여 배포를 실행하고 환경을 정리합니다.
-Mode Complete플래그와 함께New-AzResourceGroupDeployment를 실행하여 전체 모드에서 배포를 실행합니다.New-AzResourceGroupDeployment ` -Mode Complete ` -Confirm ` -TemplateFile azuredeploy.json출력은 다음과 유사하게 표시됩니다.
출력의 마지막 줄이 확인임에 유의하세요. 이 줄은 계속하려면 y 또는 n을 선택할 것을 요청합니다.
[A] 모두 예에 A를 입력하여 배포를 실행하고 환경을 정리합니다.
--mode Complete플래그와 함께az deployment group create을 실행하여 전체 모드에서 배포를 만듭니다.az deployment group create \ --mode Complete \ --confirm-with-what-if \ --template-file main.bicep출력은 다음과 유사하게 표시됩니다.
출력의 마지막 줄이 확인임에 유의하세요. 이 줄은 계속하려면 y 또는 n을 선택할 것을 요청합니다.
“예”에 해당하는 y를 입력하여 배포를 실행하고 환경을 정리합니다.
--mode Complete플래그와 함께az deployment group create을 실행하여 전체 모드에서 배포를 만듭니다.az deployment group create \ --mode Complete \ --confirm-with-what-if \ --template-file azuredeploy.json출력은 다음과 유사하게 표시됩니다.
출력의 마지막 줄이 확인임에 유의하세요. 이 줄은 계속하려면 y 또는 n을 선택할 것을 요청합니다.
“예”에 해당하는 y를 입력하여 배포를 실행하고 환경을 정리합니다.
배포 확인
앞에서 사용한 열려 있는 브라우저로 돌아갑니다. 다음 스크린샷에 나온 것처럼 가상 네트워크가 더 이상 존재하지 않는지 확인합니다.
