快速入門：使用 Bicep 檔案和 Azure PowerShell 或 Azure CLI 部署醫療技術服務

發行項
05/16/2024

Bicep 是使用宣告式語法來部署 Azure 資源的特定領域語言 (DSL)。在 Bicep 檔案中，您會定義要部署至 Azure 的基礎結構，然後在整個開發生命週期中使用該檔案，以重複部署您的基礎結構。 Bicep 提供簡潔的語法、可靠的型別安全，並支援程式碼重複使用，您的資源將以一致的方式部署。 Bicep 能夠為您在 Azure 中的基礎結構即程式碼解決方案，提供第一級的製作體驗。

在本快速入門中，您將瞭解如何使用 Azure PowerShell 或 Azure CLI，使用 Bicep 檔案來部署醫療技術服務執行個體。

提示

若要深入了解 Bicep，請參閱什麼是 Bicep？

必要條件

若要開始部署並完成本快速入門，您必須具備下列先決條件：

有效的 Azure 訂用帳戶。如果您沒有 Azure 訂用帳戶，請參閱訂用帳戶決策指南。
在 Azure 訂用帳戶中的擁有者或參與者和使用者存取系統管理員角色。如需詳細資訊，請參閱什麼是 Azure 角色型存取控制 (Azure RBAC)？
已在 Azure 訂用帳戶註冊的 Microsoft.HealthcareApis 和 Microsoft.EventHub 資源提供者。若要深入了解註冊資源提供者，請參閱 Azure 資源提供者和類型。
Azure PowerShell 和/或本機安裝的 Azure CLI。
- 針對 Azure PowerShell，請安裝 Bicep CLI，以部署本快速入門中使用的 Bicep 檔案。

當您具備這些必要條件時，即可部署 Bicep 檔案。

檢閱 Bicep 檔案

本快速入門中用來部署資源的 Bicep 檔案可在 Azure 快速入門範例使用 GitHub 上的 main.bicep 檔案來取得。

在本機儲存 Bicep 檔案

請在本機上將 Bicep 檔案儲存為 main.bicep。您必須擁有 Azure PowerShell 的工作目錄或 Azure CLI 控制台，指向儲存此檔案的位置。

使用 Bicep 檔案和 Azure PowerShell 部署醫療技術服務

完成下列五個步驟，以使用 Azure PowerShell 部署醫療技術服務：

登入 Azure。
```
Connect-AzAccount
```
使用訂用帳戶識別碼設定您的 Azure 訂用帳戶部署內容。若要了解如何取得訂用帳戶識別碼，請參閱 Azure 入口網站中的取得訂用帳戶和租用戶識別碼。
```
Set-AzContext <AzureSubscriptionId>
```
例如：Set-AzContext abcdef01-2345-6789-0abc-def012345678
確認您要部署的位置。如需 Azure 健康資料服務目前提供的 Azure 區域，請參閱依區域提供的產品網站。

您也可以檢閱 main.bicep 檔案本機儲存的位置區段。

如果您需要 Azure 區域位置名稱的清單，可使用此程式碼來顯示本清單：
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
如果您尚未為此快速入門建立資源群組，可使用此程式碼來建立：
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
例如：New-AzResourceGroup -name BicepTestDeployment -location southcentralus

重要

若要成功部署醫療技術服務，您必須針對資源的基底名稱使用數字和小寫字母。基底名稱需求下限為三個字元，最多 16 個字元。
使用下列程式碼，利用 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 部署醫療技術服務：

登入 Azure。
```
az login
```
使用訂用帳戶識別碼設定您的 Azure 訂用帳戶部署內容。若要了解如何取得訂用帳戶識別碼，請參閱 Azure 入口網站中的取得訂用帳戶和租用戶識別碼。
```
az account set <AzureSubscriptionId>
```
例如：az account set abcdef01-2345-6789-0abc-def012345678
確認您要部署的位置。如需 Azure 健康資料服務目前提供的 Azure 區域，請參閱依區域提供的產品網站。

您也可以檢閱 main.bicep 檔案本機儲存的位置區段。

如果您需要 Azure 區域位置名稱的清單，可使用此程式碼來顯示本清單：
```
az account list-locations -o table
```
如果您尚未為此快速入門建立資源群組，可使用此程式碼來建立：
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
例如：az group create --resource-group BicepTestDeployment --location southcentralus

重要

若要成功部署醫療技術服務，您必須針對資源的基底名稱使用數字和小寫字母。
使用下列程式碼，利用 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 FHIR® 服務。
具有必要系統指派受控識別角色的健康資料服務醫療技術服務服務：
- 針對事件中樞，Azure 事件中樞資料接收器角色會指派在事件中樞存取控制區段 (IAM)。
- 針對 FHIR 服務，FHIR 服務 FHIR 資料寫入器角色會在 FHIR 服務的存取控制區段 (IAM) 區段中指派。

重要

在本快速入門中，ARM 範本會設定醫療技術服務，以建立模式運作。系統會為每個傳送資料至 FHIR 服務的裝置建立病患資源和裝置資源。

若要深入了解醫療技術服務解析類型建立和查閱，請參閱設定目的地索引標籤。

部署後對應

成功部署醫療技術服務的執行個體之後，您仍然需要提供符合規範且有效的裝置和 FHIR 目的地對應。

若要瞭解裝置對應，請參閱裝置對應概觀。
若要了解 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 的許可下使用。

共用方式為