연습 - 자식 리소스 정의

10분

참고

처음으로 샌드박스를 활성화하고 약관에 동의하면 Microsoft 계정이 Microsoft Learn 샌드박스라는 새로운 Azure 디렉터리와 연결됩니다. 또한 Concierge Subscription이라는 특수 구독에도 추가됩니다.

여러분은 R&D 팀의 요청을 해결하기 위한 작업을 시작하고, 장난감 드론의 테스트 데이터를 저장하기 위한 Azure Cosmos DB 데이터베이스부터 빌드하기로 결정합니다. 이 연습에서는 Azure Cosmos DB 계정과 두 개의 자식 리소스를 만듭니다. 하나는 parent 속성을 사용하여 만들고 다른 하나는 중첩 리소스를 사용하여 만듭니다.

프로세스 중에 다음을 수행합니다.

Cosmos DB 계정을 배포하는 Bicep 파일을 만듭니다.
Cosmos DB 계정의 자식 리소스인 데이터베이스 및 컨테이너를 추가합니다.
템플릿을 배포하고 배포를 확인합니다.

이 연습에서는 Visual Studio Code용 Bicep 확장을 사용합니다. Visual Studio Code에서 해당 확장을 설치해야 합니다.

Azure Cosmos DB 계정을 포함하는 Bicep 템플릿 만들기

먼저 Azure Cosmos DB 계정을 사용하여 새 Bicep 템플릿을 만듭니다. 이를 수행하려면:

Visual Studio Code를 엽니다.
main.bicep이라는 새 파일을 만듭니다.
Visual Studio Code에서 Bicep 도구가 로드되도록 빈 파일을 저장합니다.

파일>다른 이름으로 저장을 선택해도 되고 Windows에서 Ctrl+S(macOS는 ⌘+S) 키를 눌러도 됩니다. 파일을 저장한 위치를 기억해 두세요. 예를 들어 파일을 저장할 scripts 폴더를 만들 수 있습니다.
파일에 다음 내용을 추가합니다. 복사하여 붙여넣는 대신 수동으로 입력하는 것이 좋습니다. 이렇게 하면 도구가 Bicep 파일 작성을 어떻게 도와주는지 살펴볼 수 있습니다.
```
param cosmosDBAccountName string = 'toyrnd-${uniqueString(resourceGroup().id)}'
param location string = resourceGroup().location

resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2024-05-15' = {
  name: cosmosDBAccountName
  location: location
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
  }
}
```
팁

Bicep은 줄 바꿈 위치에 대해 엄격하므로 여기에 표시된 위치에만 줄 바꿈을 추가해야 합니다.

이 Bicep 템플릿은 다음 섹션에서 빌드할 부모 리소스인 Azure Cosmos DB 계정을 배포합니다.
변경 내용을 파일에 저장합니다.

데이터베이스 추가

다음으로 Azure Cosmos DB 계정의 자식 리소스인 데이터베이스를 만듭니다.

파일의 맨 위에서 두 개의 기존 매개 변수 사이에 다음 매개 변수를 추가합니다.
```
param cosmosDBDatabaseThroughput int = 400
```
매개 변수 선언 아래에서 다음 변수를 추가합니다.
```
var cosmosDBDatabaseName = 'FlightTests'
```
파일 맨 아래의 Azure Cosmos DB 계정 리소스 정의 아래에 다음 리소스 정의를 추가합니다.
```
resource cosmosDBDatabase 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-05-15' = {
  parent: cosmosDBAccount
  name: cosmosDBDatabaseName
  properties: {
    resource: {
      id: cosmosDBDatabaseName
    }
    options: {
      throughput: cosmosDBDatabaseThroughput
    }
  }
}
```
이 코드는 parent 속성을 사용하여 자식 리소스인 데이터베이스를 배포합니다. 또한 코드는 명시적으로 지정된 API 버전과 함께 정규화된 리소스 종류를 사용합니다.
변경 내용을 파일에 저장합니다.

컨테이너 추가

이제 다른 자식 리소스를 추가합니다. 이번에는 parent 속성을 사용하는 대신 중첩된 리소스로 추가합니다.

파일의 위쪽 근처에서 cosmosDBDatabaseName 변수 정의 아래에 다음 변수를 추가합니다.
```
var cosmosDBContainerName = 'FlightTests'
var cosmosDBContainerPartitionKey = '/droneId'
```

파일 맨 아래에서, 데이터베이스 리소스 정의 내부의 닫는 중괄호(}) 앞에 다음과 같은 중첩 리소스 정의를 추가합니다.

resource container 'containers' = {
  name: cosmosDBContainerName
  properties: {
    resource: {
      id: cosmosDBContainerName
      partitionKey: {
        kind: 'Hash'
        paths: [
          cosmosDBContainerPartitionKey
        ]
      }
    }
    options: {}
  }
}

리소스가 부모 리소스 종류에 속한다는 것을 Bicep이 알고 있으므로 여기서는 짧은 리소스 종류인 containers를 사용했습니다. Bicep은 정규화된 리소스 종류가 Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers라는 것을 알고 있습니다. API 버전을 지정하지 않았으므로 Bicep는 부모 리소스인 2020-04-01의 버전을 사용합니다.

모두 마친 후 최종 Bicep 템플릿은 다음 예와 같습니다.

param cosmosDBAccountName string = 'toyrnd-${uniqueString(resourceGroup().id)}'
param cosmosDBDatabaseThroughput int = 400
param location string = resourceGroup().location

var cosmosDBDatabaseName = 'FlightTests'
var cosmosDBContainerName = 'FlightTests'
var cosmosDBContainerPartitionKey = '/droneId'

resource cosmosDBAccount 'Microsoft.DocumentDB/databaseAccounts@2024-11-15' = {
  name: cosmosDBAccountName
  location: location
  properties: {
    databaseAccountOfferType: 'Standard'
    locations: [
      {
        locationName: location
      }
    ]
  }
}

resource cosmosDBDatabase 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases@2024-11-15' = {
  parent: cosmosDBAccount
  name: cosmosDBDatabaseName
  properties: {
    resource: {
      id: cosmosDBDatabaseName
    }
    options: {
      throughput: cosmosDBDatabaseThroughput
    }
  }

  resource container 'containers' = {
    name: cosmosDBContainerName
    properties: {
      resource: {
        id: cosmosDBContainerName
        partitionKey: {
          kind: 'Hash'
          paths: [
            cosmosDBContainerPartitionKey
          ]
        }
      }
      options: {}
    }
  }
}

변경 내용을 파일에 저장합니다.

Azure에 템플릿 배포

Azure에 해당 템플릿을 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인해야 합니다. Azure CLI가 설치되어 있어야 하며, 샌드박스를 활성화할 때 사용한 것과 동일한 계정으로 로그인해야 합니다.

터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창 오른쪽에 bash가 표시되면 올바른 셸이 이미 열려 있다는 의미입니다. 또는 오른쪽에 bash 셸 아이콘이 표시되면 선택하여 셸을 시작할 수 있습니다.

bash 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 Git Bash를 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
```
cd templates
```

Bicep 설치

다음 명령을 실행하여 최신 버전의 Bicep이 있는지 확인합니다.

az bicep install && az bicep upgrade

Visual Studio Code 터미널에서 다음 명령을 실행하여 Azure에 로그인합니다.
```
az login
```
열리는 브라우저에서 Azure 계정에 로그인합니다. Visual Studio Code 터미널에는 이 계정과 연결된 구독 목록이 표시됩니다. 안내자 구독이라는 구독을 선택합니다.

최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다.
1. 컨시어지 구독 ID를 가져옵니다.
```
  az account list \
   --refresh \
   --query "[?contains(name, 'Concierge Subscription')].id" \
   --output table
```
2. 구독 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에 Bicep 템플릿을 배포합니다. 성공적인 배포를 확인하기 전에 이 작업을 완료하는 데 1~2분 정도 걸릴 수 있습니다.

az deployment group create --template-file main.bicep

이 템플릿을 Azure에 배포하려면 Visual Studio Code 터미널에서 Azure 계정에 로그인합니다. Azure PowerShell을 설치했고 샌드박스를 활성화한 것과 동일한 계정에 로그인했는지 확인합니다.

터미널 메뉴에서 새 터미널을 선택합니다. 터미널 창은 일반적으로 화면의 아래쪽 절반에서 열립니다.
터미널 창 오른쪽에 pwsh 또는powershell이 표시될 경우 올바른 셸이 이미 열려 있다는 의미입니다. 또는 오른쪽에 PowerShell 셸 아이콘이 표시되면 선택하여 셸을 시작할 수 있습니다.

pwsh 또는 powershell 이외의 셸이 나타나면 셸 드롭다운 화살표를 선택한 다음 PowerShell을 선택합니다.
터미널에서 템플릿을 저장한 디렉터리로 이동합니다. 예를 들어, templates 폴더에 템플릿을 저장한 경우 다음 명령을 사용할 수 있습니다.
```
Set-Location -Path templates
```

Bicep CLI 설치

Azure PowerShell에서 Bicep을 사용하려면 Bicep CLI를 설치합니다.

Visual Studio Code 터미널에서 다음 명령을 실행합니다.
```
Connect-AzAccount
```
Azure 계정에 로그인할 수 있도록 브라우저가 열립니다. 브라우저가 백그라운드에서 열릴 수 있습니다.
Azure에 로그인하면 터미널에 계정과 연결된 구독 목록이 표시됩니다. 샌드박스를 활성화한 경우 ‘컨시어지 구독’이라는 구독이 표시됩니다. 나머지 연습을 위해 이를 선택합니다.

최근에 샌드박스를 두 개 이상 사용한 경우에는 터미널에 ‘컨시어지 구독’ 인스턴스가 두 개 이상 표시될 수 있습니다. 이 경우 다음 두 단계를 사용하여 하나를 기본 구독으로 설정합니다.
1. 구독 ID를 복사합니다. 다음 명령을 실행하면 구독 및 해당 ID가 나열됩니다. Concierge Subscription을 찾은 다음 두 번째 열에서 ID를 복사합니다. aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e과 같이 표시됩니다.
```
Get-AzSubscription
```
2. 활성 구독을 ‘컨시어지 구독’으로 변경합니다. {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에 템플릿 배포

터미널에서 다음 Azure PowerShell 명령을 사용하여 템플릿을 Azure에 배포합니다. 성공적인 배포를 확인하기 전에 이 작업을 완료하는 데 1~2분 정도 걸릴 수 있습니다.

New-AzResourceGroupDeployment -TemplateFile main.bicep

배포 확인

Azure Portal로 이동하여 샌드박스 구독에 있는지 확인합니다.
1. 페이지의 오른쪽 위에 있는 아바타를 선택합니다.
2. 디렉터리 전환을 선택합니다. 목록에서 Microsoft Learn 샌드박스 디렉터리를 선택합니다.
홈페이지에서 리소스 그룹을 선택합니다. 리소스 그룹 창이 나타납니다.
[샌드박스 리소스 그룹 이름]을 선택합니다.
개요에 성공한 배포 하나가 표시될 것입니다.
‘1 성공’을 선택하여 배포 세부 정보를 확인합니다.
main이라는 배포를 선택하여 어떤 리소스가 배포되었는지 확인한 다음, 배포 정보를 선택하여 확장합니다. 이 경우 Cosmos DB 계정, 데이터베이스 및 컨테이너가 나열됩니다.
나중에 배포를 다시 확인할 수 있도록 브라우저에서 페이지를 열어 둡니다.

연습 - 자식 리소스 정의

Azure Cosmos DB 계정을 포함하는 Bicep 템플릿 만들기

데이터베이스 추가

컨테이너 추가

Azure에 템플릿 배포

Bicep 설치

Azure에 로그인

기본 리소스 그룹 설정

Azure에 템플릿 배포

Bicep CLI 설치

Azure PowerShell을 사용하여 Azure에 로그인

기본 리소스 그룹 설정

Azure에 템플릿 배포

배포 확인

피드백