다음을 통해 공유

자습서: 첫 번째 ARM 템플릿 만들기 및 배포

이 자습서에서는 ARM 템플릿(Azure Resource Manager 템플릿)을 소개합니다. 시작 템플릿을 만들고 Azure에 배포하는 방법을 보여줍니다. 템플릿 구조와 템플릿을 사용하는 데 필요한 도구에 대해 설명합니다. 이 명령을 완료하는 데 12분 이 걸리지만 실제 완료 시간은 설치해야 하는 도구 수에 따라 달라집니다.

이 자습서는 시리즈의 첫 번째 자습서입니다. 계열을 진행하면서 ARM 템플릿의 모든 핵심 부분을 탐색할 때까지 시작 템플릿을 단계별로 수정합니다. 이러한 요소는 더 복잡한 템플릿의 구성 요소입니다. 시리즈가 끝날 때까지 고유한 템플릿을 만들고 템플릿을 사용하여 배포를 자동화할 준비가 되어 있기를 바랍니다.

템플릿 사용의 이점과 템플릿을 사용하여 배포를 자동화해야 하는 이유에 대해 알아보려면 ARM 템플릿 개요를 참조하세요. 학습 모듈의 안내 집합을 통해 ARM 템플릿에 대해 알아보려면 JSON ARM 템플릿을 사용하여 Azure에서 리소스 배포 및 관리를 참조하세요.

Microsoft Azure 구독이 없는 경우 시작하기 전에 체험 계정을 만듭니 다.

팁 (조언)

ARM 템플릿을 처음 접하는 경우에는 대신 Bicep을 학습하는 것을 고려할 수 있습니다. Bicep은 ARM 템플릿과 동일한 기능을 제공하지만 사용하기 쉬운 구문을 제공하는 새로운 언어입니다. Bicep 학습을 시작하려면 빠른 시작: Visual Studio Code를 사용하여 Bicep 파일 만들기를 참조하세요.

도구 가져오기

먼저 템플릿을 만들고 배포하는 데 필요한 도구가 있는지 확인합니다. 로컬 컴퓨터에 이러한 도구를 설치합니다.

Editor

템플릿은 JSON(JavaScript Object Notation) 파일입니다. 템플릿을 만들려면 Visual Studio Code를 사용할 수 있습니다.

명령줄 배포

템플릿을 배포하려면 Azure PowerShell 또는 Azure Command-Line 인터페이스(CLI)도 필요합니다. Azure CLI를 사용하는 경우 버전 2.37.0 이상이 있어야 합니다. 설치 지침은 다음을 참조하세요.

Azure PowerShell 또는 Azure CLI를 설치한 후 처음으로 로그인해야 합니다. 도움말은 로그인 - PowerShell 또는 로그인 - Azure CLI를 참조하세요.

중요합니다

Azure CLI를 사용하는 경우 버전 2.37.0 이상이 있는지 확인합니다. Azure PowerShell을 사용하는 경우 버전 7.2.4 이상이 있는지 확인합니다. 이 자습서에 표시된 명령은 이전 버전을 사용하는 경우 작동하지 않습니다. 설치된 버전을 확인하려면 다음 az --version을 사용합니다.

이제 템플릿에 대한 학습을 시작할 준비가 된 것입니다.

첫 번째 템플릿 만들기

  1. Visual Studio Code를 엽니다.

  2. 파일 메뉴에서 새 파일을 선택하여 새 파일을 만듭니다.

  3. 파일 메뉴에서 다른 이름으로 저장을 선택합니다.

  4. 파일 이름을 azuredeploy 로 지정하고 json 파일 확장명을 선택합니다. 파일의 전체 이름이 azuredeploy.json.

  5. 파일을 워크스테이션에 저장합니다. 나중에 템플릿을 배포할 때 해당 경로를 제공해야 하므로 기억하기 쉬운 경로를 선택합니다.

  6. 다음 JSON을 복사하여 파일에 붙여넣습니다.

    {
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": []
}

    Visual Studio Code 환경은 다음과 같습니다.

    편집기에서 JSON 구조가 있는 빈 ARM 템플릿을 표시하는 Visual Studio Code의 스크린샷

    이 템플릿은 리소스를 배포하지 않습니다. 빈 템플릿부터 시작하여 문제가 발생할 가능성을 최소화하면서 템플릿을 배포하는 단계에 익숙해질 수 있습니다.

    JSON 파일에는 다음과 같은 요소가 있습니다.

    • $schema: JSON 스키마 파일의 위치를 지정합니다. 스키마 파일은 템플릿 내에서 사용할 수 있는 속성을 설명합니다. 예를 들어 스키마는 템플릿에 대한 유효한 속성 중 하나로 정의합니다 resources . 스키마의 날짜가 2019-04-01이라는 것을 걱정하지 마세요. 이 스키마 버전은 최신 버전이며 모든 최신 기능을 포함합니다. 스키마 날짜는 도입 이후 주요 변경 내용이 없으므로 변경되지 않았습니다.
    • contentVersion: 템플릿의 버전(예: 1.0.0.0)을 지정합니다. 이 요소에 대한 값을 제공할 수 있습니다. 이 값을 사용하여 템플릿의 중요한 변경 내용을 문서화합니다. 템플릿을 사용하여 리소스를 배포할 때 이 값을 사용하여 올바른 템플릿을 사용하고 있는지 확인할 수 있습니다.
    • resources: 배포하거나 업데이트하려는 리소스를 포함합니다. 현재는 비어 있지만 나중에 리소스를 추가할 수 있습니다.

  7. 파일을 저장합니다.

축하합니다. 첫 번째 템플릿을 만들었습니다.

Azure에 로그인

Azure PowerShell 또는 Azure CLI 작업을 시작하려면 Azure 자격 증명으로 로그인합니다.

다음 코드 섹션에서 탭을 선택하여 Azure PowerShell과 Azure CLI 중에서 선택합니다. 이 문서의 CLI 예제는 Bash 셸용으로 작성되었습니다.

Connect-AzAccount

여러 Azure 구독이 있는 경우 사용하려는 구독을 선택합니다. SubscriptionName을 구독 이름으로 바꿉니다. 구독 이름 대신 구독 ID를 사용할 수도 있습니다.

Set-AzContext SubscriptionName

리소스 그룹 만들기

템플릿을 배포할 때 리소스를 포함할 리소스 그룹을 지정할 수 있습니다. 배포 명령을 실행하기 전에 Bash Azure CLI 또는 Azure PowerShell을 사용하여 리소스 그룹을 만듭니다.

비고

Azure CLI에 대한 샘플은 bash 셸용으로 작성됩니다. Windows PowerShell 또는 명령 프롬프트에서 이 샘플을 실행하려면 백슬래시를 제거하고 명령을 다음과 같은 한 줄로 작성해야 할 수 있습니다.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

템플릿 배포

템플릿을 배포하려면 Azure CLI 또는 Azure PowerShell을 사용합니다. 만든 리소스 그룹을 사용합니다. 배포 기록에서 쉽게 식별할 수 있도록 배포에 이름을 지정합니다. 편의를 위해 템플릿 파일의 경로를 저장하는 변수도 만듭니다. 이 변수를 사용하면 배포할 때마다 경로를 다시 입력할 필요가 없으므로 배포 명령을 더 쉽게 실행할 수 있습니다. {provide-the-path-to-the-template-file} 및 중괄호 {}를 템플릿 파일의 경로로 교체하십시오.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

배포 명령은 결과를 반환합니다. ProvisioningState을 찾아 배포가 성공했는지 확인합니다.

비고

배포가 실패하면 스위치를 verbose 사용하여 생성되는 리소스에 대한 정보를 가져옵니다. 스위치를 debug 사용하여 디버깅에 대한 자세한 정보를 가져옵니다.

배포 확인

Azure Portal에서 리소스 그룹을 탐색하여 배포를 확인할 수 있습니다.

  1. Azure Portal에 로그인합니다.

  2. 왼쪽 메뉴에서 리소스 그룹을 선택합니다.

  3. myResourceGroup 왼쪽에 있는 확인란을 선택하고 myResourceGroup을 선택합니다.

  4. 이전 절차에서 만든 리소스 그룹을 선택합니다. 기본 이름은 myResourceGroup입니다. 빈 템플릿을 배포했기 때문에 리소스 그룹에는 아직 리소스가 없습니다.

  5. 개요의 중간에 있는 Essentials 섹션에서는 페이지가 Deployments 옆에 배포 상태를 표시합니다. 1 성공을 선택합니다.

    리소스 그룹의 Essentials 섹션에 있는 배포 상태를 보여 주는 Azure Portal의 스크린샷

  6. 리소스 그룹에 대한 배포 기록이 표시됩니다. blanktemplate의 왼쪽에 있는 확인란을 선택하고 blanktemplate을 선택합니다.

    blanktemplate 배포가 선택된 배포 기록을 표시하는 Azure Portal의 스크린샷.

  7. 배포에 대한 요약이 표시됩니다. 이 경우 리소스가 배포되지 않으므로 볼 것이 많지 않습니다. 이 시리즈의 뒷부분에서는 배포 기록의 요약을 검토하는 것이 유용할 수 있습니다. 왼쪽에서 배포에서 사용한 입력, 출력 및 템플릿을 볼 수 있습니다.

    blanktemplate 배포에 대한 배포 요약을 보여 주는 Azure Portal의 스크린샷

자원을 정리하세요

다음 자습서로 이동하는 경우 리소스 그룹을 삭제할 필요가 없습니다.

지금 중지하는 경우 리소스 그룹을 삭제할 수 있습니다.

  1. Azure Portal의 왼쪽 메뉴에서 리소스 그룹을 선택합니다.

  2. 필드에 대한 필터... 텍스트 필드에 리소스 그룹 이름을 입력합니다.

  3. myResourceGroup 옆의 확인란을 선택하고 myResourceGroup 또는 리소스 그룹 이름을 선택합니다.

  4. 위쪽 메뉴에서 리소스 그룹 삭제를 선택합니다.

    리소스 그룹 보기에서 리소스 그룹 삭제 옵션이 강조 표시된 Azure Portal의 스크린샷

다음 단계

Azure에 배포할 간단한 템플릿을 만들었습니다. 다음 자습서에서는 템플릿에 스토리지 계정을 추가하고 리소스 그룹에 배포하는 방법을 알아볼 수 있습니다.

리소스 추가

  • Last updated on