快速入门:使用 Bicep 文件和 Azure PowerShell 或 Azure CLI 部署医疗技术服务

重要说明

自 2025 年 2 月 26 日起,医疗技术服务将不再在以下区域提供:英国西部、阿联酋北部、南非北部、卡塔尔中部。

Bicep 是一种特定于域的语言 (DSL),使用声明性语法来部署 Azure 资源。 在 Bicep 文件中,定义要部署到 Azure 的基础结构,然后在整个开发生命周期中使用该文件重复部署基础结构。 你的资源以一致的方式部署。Bicep 提供简明的语法、可靠的类型安全性以及对代码重用的支持。 Bicep 会针对你的 Azure 基础结构即代码解决方案提供一流创作体验。

本快速入门介绍如何使用 Azure PowerShell 或 Azure CLI 通过 Bicep 文件部署医疗技术服务实例。

提示

若要详细了解 Bicep,请参阅什么是 Bicep?

先决条件

若要开始部署并完成本快速入门,必须满足以下先决条件:

满足上述先决条件后,即可部署 Bicep 文件。

查阅 Bicep 文件

本快速入门中用于部署资源的 Bicep 文件在 Azure 快速入门模板中提供,可通过使用 GitHub 上的 main.bicep 文件获取。

在本地保存 Bicep 文件

在本地将 Bicep 文件的保存为 main.bicep。 需要让 Azure PowerShell 或 Azure CLI 控制台的工作目录指向保存此文件的位置。

使用 Bicep 文件和 Azure PowerShell 部署医疗技术服务

完成以下五个步骤,使用 Azure PowerShell 部署医疗技术服务:

  1. 登录 Azure。

    Connect-AzAccount
    
  2. 使用订阅 ID 设置 Azure 订阅部署上下文。 若要了解如何获取订阅 ID,请参阅在 Azure 门户中获取订阅和租户 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

    重要说明

    为了成功部署医疗技术服务,需要对资源的基名称使用数字和小写字母。 基名称至少需要 3 个字符,最多为 16 个字符。

  5. 使用以下代码通过 Bicep 文件部署医疗技术服务:

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

    例如:New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -basename abc123 -___location southcentralus

    重要说明

    如果要允许从多个服务访问事件中心,强烈建议每个服务建立自己的事件中心使用者组。

    通过使用者组,多个消耗应用程序会有各自独立的事件流视图,并按自身节奏和偏移量独立读取流。 有关详细信息,请参阅使用者组

    示例:

    • 访问同一事件中心的两个医疗技术服务。

    • 访问同一事件中心的医疗技术服务和存储编写器应用程序。

使用 Bicep 文件和 Azure CLI 部署医疗技术服务

完成以下五个步骤,使用 Azure CLI 部署医疗技术服务:

  1. 登录 Azure。

    az login
    
  2. 使用订阅 ID 设置 Azure 订阅部署上下文。 若要了解如何获取订阅 ID,请参阅在 Azure 门户中获取订阅和租户 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

    重要说明

    为了成功部署医疗技术服务,需要对资源的基名称使用数字和小写字母。

  5. 使用以下代码通过 Bicep 文件部署医疗技术服务:

    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

    重要说明

    如果要允许从多个服务访问设备消息事件中心,强烈建议每个服务建立自己的事件中心使用者组。

    通过使用者组,多个消耗应用程序会有各自独立的事件流视图,并按自身节奏和偏移量独立读取流。 有关详细信息,请参阅使用者组

    示例:

    • 访问同一事件中心的两个医疗技术服务。

    • 访问同一事件中心的医疗技术服务和存储编写器应用程序。

查看已部署的资源和访问权限

部署完成后,将在 Bicep 文件部署中创建以下资源和访问角色:

  • 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 目标映射。

清理 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 文件

后续步骤

为医疗技术服务选择部署方法

医疗技术服务设备数据处理阶段概述

有关医疗技术服务的常见问题解答

注意

FHIR® 是 HL7 的注册商标,经 HL7 许可使用。