你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
快速入门:使用 Azure 资源管理器模板和 Azure PowerShell 或 Azure CLI 部署医疗技术服务
若要针对 Azure 解决方案实现基础结构即代码,请使用 Azure 资源管理器模板(ARM 模板)。 该模板是一个定义项目基础结构和配置的 JavaScript 对象表示法 (JSON) 文件。 该模板使用声明性语法,使你可以指明要部署的内容,而不需要编写一系列编程命令来创建内容。 在该模板中,指定要部署的资源以及这些资源的属性。
本快速入门介绍如何使用 Azure PowerShell 或 Azure CLI 通过 Azure 资源管理器模板(ARM 模板)部署医疗技术服务实例。
提示
若要详细了解 ARM 模板,请参阅什么是 ARM 模板?
先决条件
若要开始部署并完成本快速入门,必须满足以下先决条件:
一个有效的 Azure 订阅帐户。 如果没有 Azure 订阅,请参阅订阅决策指南。
Azure 订阅中的“所有者”、“参与者和用户访问管理员”角色分配。 有关详细信息,请参阅什么是 Azure 基于角色的访问控制 (Azure RBAC)?
已在 Azure 订阅中注册的 Microsoft.HealthcareApis 和 Microsoft.EventHub 资源提供程序。 若要详细了解如何注册资源提供程序,请参阅 Azure 资源提供程序和类型。
已在本地安装 Azure PowerShell 和/或 Azure CLI。
满足上述先决条件后,即可部署 ARM 模板。
查看 ARM 模板
本快速入门中用于部署资源的 ARM 模板在 Azure 快速入门模板中提供,获取方法是使用 GitHub 上的 azuredeploy.json文件。
使用 Azure 资源管理器模板和 Azure PowerShell 部署医疗技术服务
完成以下五个步骤,使用 Azure PowerShell 部署医疗技术服务:
登录 Azure。
Connect-AzAccount
使用订阅 ID 设置 Azure 订阅部署上下文。 若要了解如何获取订阅 ID,请参阅在 Azure 门户中获取订阅和租户 ID。
Set-AzContext <AzureSubscriptionId>
例如:
Set-AzContext abcdef01-2345-6789-0abc-def012345678
确认要部署的位置。 有关提供 Azure Health Data Services 的当前 Azure 区域,请参阅可用产品(按区域)。
还可以查看 azuredeploy.json 文件的“位置”部分。
如果需要 Azure 区域位置名称的列表,可以使用以下代码显示列表:
Get-AzLocation | Format-Table -Property DisplayName,Location
如果尚未为本快速入门创建资源组,可以使用以下代码创建一个:
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
例如:
New-AzResourceGroup -name ArmTestDeployment -location southcentralus
重要
为了成功部署医疗技术服务,需要对资源的基名称使用数字和小写字母。 最低 basename 要求为 3 个字符,最多为 16 个字符。
使用以下代码通过 ARM 模板部署医疗技术服务:
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json -basename <BaseName> -location <AzureRegion>
例如:
New-AzResourceGroupDeployment -ResourceGroupName ArmTestDeployment -TemplateUri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json -basename abc123 -location southcentralus
重要
如果要允许从多个服务访问事件中心,强烈建议每个服务建立自己的事件中心使用者组。
通过使用者组,多个消耗应用程序会有各自独立的事件流视图,并按自身节奏和偏移量独立读取流。 有关详细信息,请参阅使用者组。
示例:
访问同一事件中心的两个医疗技术服务。
医疗技术服务和存储编写器应用程序访问同一事件中心。
使用 Azure 资源管理器模板和 Azure CLI 部署医疗技术服务
完成以下五个步骤,使用 Azure CLI 部署医疗技术服务:
登录 Azure。
az login
使用订阅 ID 设置 Azure 订阅部署上下文。 若要了解如何获取订阅 ID,请参阅在 Azure 门户中获取订阅和租户 ID。
az account set <AzureSubscriptionId>
例如:
az account set abcdef01-2345-6789-0abc-def012345678
确认要部署的位置。 有关提供 Azure Health Data Services 的当前 Azure 区域,请参阅可用产品(按区域)。
还可以查看 azuredeploy.json 文件的“位置”部分。
如果需要 Azure 区域位置名称的列表,可以使用以下代码显示列表:
az account list-locations -o table
如果尚未为本快速入门创建资源组,可以使用以下代码创建一个:
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
例如:
az group create --resource-group ArmTestDeployment --location southcentralus
重要
若要成功部署医疗技术服务,需要对资源的 basename 使用数字和小写字母。
使用以下代码通过 ARM 模板部署医疗技术服务:
az deployment group create --resource-group <ResourceGroupName> --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json --parameters basename=<BaseName> location=<AzureRegion>
例如:
az deployment group create --resource-group ArmTestDeployment --template-uri https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.healthcareapis/workspaces/iotconnectors/azuredeploy.json --parameters basename=abc123 location=southcentralus
重要
如果要允许从多个服务访问事件中心,强烈建议每个服务建立自己的事件中心使用者组。
通过使用者组,多个消耗应用程序会有各自独立的事件流视图,并按自身节奏和偏移量独立读取流。 有关详细信息,请参阅使用者组。
示例:
访问同一事件中心的两个医疗技术服务。
医疗技术服务和存储编写器应用程序访问同一事件中心。
查看已部署的资源和访问权限
部署完成后,将在 ARM 模板部署中创建以下资源和访问角色:
Azure 事件中心命名空间和事件中心。 在此部署中,事件中心命名为 devicedata。
事件中心使用者组。 在此部署中,使用者组命名为$Default。
Azure 事件中心数据发送方角色。 在此部署中,发送方角色命名为devicedatasender,可用于使用共享访问签名 (SAS) 提供对事件中心的访问权限。 若要详细了解如何使用 SAS 进行授权,请参阅使用共享访问签名授权访问事件中心资源。
Health Data Services 工作区。
Health Data Services FHIR® 服务。
具有所需系统分配的托管标识角色的 Health Data Services 医疗技术服务:
对于事件中心,在事件中心的访问控制部分 (IAM) 中分配“Azure 事件中心数据接收方”角色。
对于 FHIR 服务,在 FHIR 服务的访问控制部分 (IAM) 中分配“FHIR 数据写入者”角色。
重要
在本快速入门中,ARM 模板将医疗技术服务配置为在“创建”模式下运行。 将为向 FHIR 服务发送数据的每台设备创建患者资源和设备资源。
若要详细了解医疗技术服务解决类型“创建”和“查找”,请参阅配置目标选项卡。
部署后的映射
成功部署医疗技术服务的实例后,仍需提供一致且有效的设备和 FHIR 目标映射。
若要了解设备映射,请参阅医疗技术服务设备映射概述。
若要了解 FHIR 目标映射,请参阅 FHIR 目标映射概述。
清理 Azure PowerShell 资源
不再需要资源组和已部署的 Bicep 文件资源时,可以删除资源组,这将删除资源组中的资源。
Remove-AzResourceGroup -Name <ResourceGroupName>
例如:Remove-AzResourceGroup -Name ArmTestDeployment
清理 Azure CLI 资源
不再需要资源组和已部署的 Bicep 文件资源时,可以删除资源组,这将删除资源组中的资源。
az group delete --name <ResourceGroupName>
例如:az group delete --resource-group ArmTestDeployment
提示
有关引导你完成 ARM 模板创建过程的分步教程,请参阅教程:创建和部署第一个 ARM 模板。
后续步骤
注意
FHIR® 是 HL7 的注册商标,经 HL7 许可使用。