빠른 시작: Bicep 파일 및 Azure PowerShell 또는 Azure CLI를 사용하여 MedTech 서비스 배포

  • 아티클

Bicep은 선언적 구문을 사용하여 Azure 리소스를 배포하는 DSL(도메인 특정 언어)입니다. Bicep 파일에서 Azure에 배포하려는 인프라를 정의한 다음, 개발 수명 주기 내내 해당 파일을 사용하여 인프라를 반복적으로 배포합니다. 리소스는 Bicep이 간결한 구문, 신뢰할 수 있는 형식 안전성 및 코드 재사용 지원을 제공하는 일관된 방식으로 배포됩니다. Bicep은 Azure에서 코드형 인프라 솔루션에 대한 최고의 제작 환경을 제공합니다.

이 빠른 시작에서는 Bicep 파일을 사용하여 MedTech 서비스의 인스턴스를 배포하는 데 Azure PowerShell 또는 Azure CLI를 사용하는 방법을 알아봅니다.

팁

Bicep에 대한 자세한 내용은 Bicep이란?을 참조하세요.

필수 조건

배포를 시작하고 빠른 시작을 완료하려면 다음 필수 구성 요소가 있어야 합니다.

이러한 필수 구성 요소가 있으면 Bicep 파일을 배포할 준비가 된 것입니다.

Bicep 파일 검토

이 빠른 시작에서 리소스를 배포하는 데 사용되는 Bicep 파일은 GitHub의 main.bicep 파일을 사용하여 Azure 빠른 시작 템플릿에서 사용할 수 있습니다.

Bicep 파일을 로컬로 저장

Bicep 파일을 main.bicep으로 로컬로 저장합니다. 이 파일이 저장된 위치를 가리키는 Azure PowerShell 또는 Azure CLI 콘솔의 작업 디렉터리가 있어야 합니다.

Bicep 파일 및 Azure PowerShell을 사용하여 MedTech 서비스 배포

Azure PowerShell을 사용하여 MedTech 서비스를 배포하려면 다음 다섯 단계를 완료하세요.

  1. Azure에 로그인합니다.

    Connect-AzAccount

  2. 구독 ID를 사용하여 Azure 구독 배포 컨텍스트를 설정합니다. 구독 ID를 가져오는 방법을 알아보려면 Azure Portal에서 구독 및 테넌트 ID 가져오기를 참조하세요.

    Set-AzContext <AzureSubscriptionId>

    예: Set-AzContext abcdef01-2345-6789-0abc-def012345678

  3. 배포할 위치를 확인합니다. Azure Health Data Services를 사용할 수 있는 현재 Azure 지역에 대해서는 지역별 사용 가능한 제품 사이트를 참조하세요.

    로컬로 저장된 main.bicep 파일의 위치 섹션을 살펴볼 수도 있습니다.

    Azure 지역 위치 이름 목록이 필요한 경우 이 코드를 사용하여 목록을 표시할 수 있습니다.

    Get-AzLocation | Format-Table -Property DisplayName,Location

  4. 이 빠른 시작에 대한 리소스 그룹을 아직 만들지 않았으면 이 코드를 사용하여 만들 수 있습니다.

    New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>

    예: New-AzResourceGroup -name BicepTestDeployment -location southcentralus

    Important

    MedTech 서비스를 성공적으로 배포하려면 리소스의 기본 이름에 숫자와 소문자를 사용해야 합니다. 최소 기본 이름 요구 사항은 3자이고, 최대 16자입니다.

  5. Bicep 파일을 사용하여 MedTech 서비스를 배포하려면 다음 코드를 사용합니다.

    New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>

    예: New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -basename abc123 -location southcentralus

    Important

    여러 서비스에서 이벤트 허브로의 액세스를 허용하려는 경우 각 서비스에 자체 이벤트 허브 소비자 그룹이 있는 것이 좋습니다.

    소비자 그룹을 사용하면 여러 소비 애플리케이션이 이벤트 스트림에 대한 별도의 보기를 가지며 자체 속도와 자체 오프셋을 사용하여 독립적으로 스트림을 읽을 수 있습니다. 자세한 내용은 소비자 그룹을 참조하세요.

    예:

    • 동일한 이벤트 허브에 액세스하는 두 개의 MedTech 서비스.

    • 동일한 이벤트 허브에 액세스하는 MedTech 서비스 및 스토리지 기록기 애플리케이션.

Bicep 파일 및 Azure CLI를 사용하여 MedTech 서비스 배포

Azure CLI를 사용하여 MedTech 서비스를 배포하려면 다음 다섯 단계를 완료하세요.

  1. Azure에 로그인합니다.

    az login

  2. 구독 ID를 사용하여 Azure 구독 배포 컨텍스트를 설정합니다. 구독 ID를 가져오는 방법을 알아보려면 Azure Portal에서 구독 및 테넌트 ID 가져오기를 참조하세요.

    az account set <AzureSubscriptionId>

    예: az account set abcdef01-2345-6789-0abc-def012345678

  3. 배포할 위치를 확인합니다. Azure Health Data Services를 사용할 수 있는 현재 Azure 지역에 대해서는 지역별 사용 가능한 제품 사이트를 참조하세요.

    로컬로 저장된 main.bicep 파일의 위치 섹션을 살펴볼 수도 있습니다.

    Azure 지역 위치 이름 목록이 필요한 경우 이 코드를 사용하여 목록을 표시할 수 있습니다.

    az account list-locations -o table

  4. 이 빠른 시작에 대한 리소스 그룹을 아직 만들지 않았으면 이 코드를 사용하여 만들 수 있습니다.

    az group create --resource-group <ResourceGroupName> --location <AzureRegion>

    예: az group create --resource-group BicepTestDeployment --location southcentralus

    Important

    MedTech 서비스를 성공적으로 배포하려면 리소스의 기본 이름에 숫자와 소문자를 사용해야 합니다.

  5. Bicep 파일을 사용하여 MedTech 서비스를 배포하려면 다음 코드를 사용합니다.

    az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>

    예: az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus

    Important

    여러 서비스에서 디바이스 메시지 이벤트 허브로의 액세스를 허용하려는 경우 각 서비스에 자체 이벤트 허브 소비자 그룹이 있는 것이 좋습니다.

    소비자 그룹을 사용하면 여러 소비 애플리케이션이 이벤트 스트림에 대한 별도의 보기를 가지며 자체 속도와 자체 오프셋을 사용하여 독립적으로 스트림을 읽을 수 있습니다. 자세한 내용은 소비자 그룹을 참조하세요.

    예:

    • 동일한 이벤트 허브에 액세스하는 두 개의 MedTech 서비스.

    • 동일한 이벤트 허브에 액세스하는 MedTech 서비스 및 스토리지 기록기 애플리케이션.

배포된 리소스 및 액세스 권한 검토

배포가 완료되면 Bicep 파일 배포에서 다음 리소스 및 액세스 역할이 만들어집니다.

  • Azure Event Hubs 네임스페이스 및 이벤트 허브. 이 배포에서 이벤트 허브의 이름은 devicedata입니다.

    • 이벤트 허브 소비자 그룹 이 배포에서 소비자 그룹의 이름은 $Default입니다.

    • Azure Event Hubs 데이터 보낸 사람 역할. 이 배포에서 보낸 사람 역할의 이름은 devicedatasender이며 SAS(공유 액세스 서명)를 사용하여 디바이스 이벤트 허브에 대한 액세스를 제공하는 데 사용할 수 있습니다. SAS를 사용하여 액세스 권한을 부여하는 방법에 대한 자세한 내용은 공유 액세스 서명을 사용하여 Event Hubs 리소스에 대한 액세스 권한 부여를 참조하세요.

  • Health Data Services 작업 영역.

  • Health Data Services FHIR® 서비스.

  • 필수 시스템이 할당한 관리 ID 역할을 가진 Health Data Services MedTech 서비스:

    • 이벤트 허브의 경우 이벤트 허브의 IAM(액세스 제어 섹션)에서 Azure Events Hubs 데이터 받는 사람 역할이 할당됩니다.

    • FHIR 서비스의 경우, FHIR 서비스의 IAM(액세스 제어 섹션)에서 FHIR 데이터 쓰기 권한자 역할이 할당됩니다.

Important

이 빠른 시작에서 ARM 템플릿은 MedTech 서비스가 만들기 모드에서 작동하도록 구성합니다. FHIR 서비스로 데이터를 보내는 각 디바이스에 대해 환자 리소스 및 디바이스 리소스가 만들어집니다.

MedTech 서비스 해결 유형 만들기 및 조회에 대한 자세한 내용은 대상 탭 구성을 참조하세요.

배포 후 매핑

MedTech 서비스 인스턴스를 성공적으로 배포한 후에도 준수하고 유효한 디바이스 및 FHIR 대상 매핑을 제공해야 합니다.

Azure PowerShell 배포 리소스 정리

리소스 그룹 및 배포된 Bicep 파일 리소스가 더 이상 필요하지 않은 경우 리소스 그룹을 삭제하여 리소스 그룹의 리소스를 삭제합니다.

Remove-AzResourceGroup -Name <ResourceGroupName>

예: Remove-AzResourceGroup -Name BicepTestDeployment

Azure CLI 배포 리소스 정리

리소스 그룹 및 배포된 Bicep 파일 리소스가 더 이상 필요하지 않은 경우 리소스 그룹을 삭제하여 리소스 그룹의 리소스를 삭제합니다.

az group delete --name <ResourceGroupName>

예: az group delete --resource-group BicepTestDeployment

팁

Bicep 파일 만들기 프로세스를 안내하는 단계별 자습서는 첫 번째 Bicep 템플릿 빌드를 참조하세요.

다음 단계

MedTech 서비스에 대한 배포 방법 선택

MedTech 서비스 디바이스 데이터 처리 단계 개요

MedTech 서비스에 대한 질문과 대답

참고 항목

FHIR®은 HL7의 등록 상표이며, HL7의 사용 허가 하에 사용됩니다.