Snabbstart: Distribuera MedTech-tjänsten med hjälp av en Azure Resource Manager-mall och Azure PowerShell eller Azure CLI

Artikel
11/08/2023

Om du vill implementera infrastruktur som kod för dina Azure-lösningar använder du Azure Resource Manager-mallar (ARM-mallar). Mallen är en JSON-fil (JavaScript Object Notation) som definierar infrastrukturen och konfigurationen för ditt projekt. Mallen använder deklarativ syntax, som låter dig ange vad du vill distribuera utan att du behöver skriva sekvensen med programmeringskommandon för att skapa det. I mallen anger du de resurser som ska distribueras och egenskaperna för dessa resurser.

I den här snabbstarten får du lära dig hur du använder Azure PowerShell eller Azure CLI för att distribuera en instans av MedTech-tjänsten med hjälp av en Azure Resource Manager-mall (ARM-mall).

Dricks

Mer information om ARM-mallar finns i Vad är ARM-mallar?

Förutsättningar

För att påbörja distributionen och slutföra snabbstarten måste du ha följande förutsättningar:

Ett aktivt Azure-prenumerationskonto. Om du inte har en Azure-prenumeration kan du läsa Beslutsguide för prenumeration.
Rolltilldelningar för ägare eller deltagare och administratör för användaråtkomst i Azure-prenumerationen. Mer information finns i Vad är rollbaserad åtkomstkontroll i Azure (Azure RBAC)?
Resursprovidrar för Microsoft.HealthcareApis och Microsoft.EventHub registrerade med din Azure-prenumeration. Mer information om hur du registrerar resursprovidrar finns i Azure-resursprovidrar och typer.
Azure PowerShell och/eller Azure CLI installerat lokalt.

När du har dessa förutsättningar är du redo att distribuera ARM-mallen.

Granska ARM-mallen

ARM-mallen som används för att distribuera resurserna i den här snabbstarten är tillgänglig i Azure Snabbstartsmallar med hjälp av filen azuredeploy.json på GitHub.

Distribuera MedTech-tjänsten med Azure Resource Manager-mallen och Azure PowerShell

Utför följande fem steg för att distribuera MedTech-tjänsten med Hjälp av Azure PowerShell:

Logga in på Azure.
```
Connect-AzAccount
```
Ange distributionskontexten för din Azure-prenumeration med ditt prenumerations-ID. Information om hur du hämtar ditt prenumerations-ID finns i Hämta prenumerations- och klient-ID:t i Azure-portalen.
```
Set-AzContext <AzureSubscriptionId>
```
Exempelvis: Set-AzContext abcdef01-2345-6789-0abc-def012345678
Bekräfta den plats som du vill distribuera i. Se Webbplatsen Produkter som är tillgängliga per region för de aktuella Azure-regioner där Azure Health Data Services är tillgängligt.

Du kan också granska platsavsnittet i filen azuredeploy.json.

Om du behöver en lista över platsnamnen för Azure-regioner kan du använda den här koden för att visa en lista:
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
Om du inte redan har skapat en resursgrupp för den här snabbstarten kan du använda den här koden för att skapa en:
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
Exempelvis: New-AzResourceGroup -name ArmTestDeployment -location southcentralus

Viktigt!

För en lyckad distribution av MedTech-tjänsten måste du använda siffror och gemener som basnamn för dina resurser. Det minsta basename-kravet är tre tecken med högst 16 tecken.
Använd följande kod för att distribuera MedTech-tjänsten med hjälp av ARM-mallen:
```
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>
```
Exempelvis: 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
Viktigt!

Om du ska tillåta åtkomst från flera tjänster till händelsehubben rekommenderar vi starkt att varje tjänst har en egen konsumentgrupp för händelsehubben.

Konsumentgrupper gör det möjligt för flera förbrukande program att ha en separat vy över händelseströmmen och att läsa strömmen oberoende av varandra i sin egen takt och med sina egna förskjutningar. Mer information finns i Konsumentgrupper.

Exempel:
- Två MedTech-tjänster som har åtkomst till samma händelsehubb.
- En MedTech-tjänst och ett program för lagringsskrivare som kommer åt samma händelsehubb.

Distribuera MedTech-tjänsten med Azure Resource Manager-mallen och Azure CLI

Slutför följande fem steg för att distribuera MedTech-tjänsten med hjälp av Azure CLI:

Logga in på Azure.
```
az login
```
Ange distributionskontexten för din Azure-prenumeration med ditt prenumerations-ID. Information om hur du hämtar ditt prenumerations-ID finns i Hämta prenumerations- och klient-ID:t i Azure-portalen.
```
az account set <AzureSubscriptionId>
```
Exempelvis: az account set abcdef01-2345-6789-0abc-def012345678
Bekräfta den plats som du vill distribuera i. Se Webbplatsen Produkter som är tillgängliga per region för de aktuella Azure-regioner där Azure Health Data Services är tillgängligt.

Du kan också granska platsavsnittet i filen azuredeploy.json.

Om du behöver en lista över platsnamnen för Azure-regioner kan du använda den här koden för att visa en lista:
```
az account list-locations -o table
```
Om du inte redan har skapat en resursgrupp för den här snabbstarten kan du använda den här koden för att skapa en:
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
Exempelvis: az group create --resource-group ArmTestDeployment --location southcentralus

Viktigt!

För en lyckad distribution av MedTech-tjänsten måste du använda siffror och gemener som basnamn för dina resurser.
Använd följande kod för att distribuera MedTech-tjänsten med hjälp av ARM-mallen:
```
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>
```
Exempelvis: 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
Viktigt!

Om du ska tillåta åtkomst från flera tjänster till händelsehubben rekommenderar vi starkt att varje tjänst har en egen konsumentgrupp för händelsehubben.

Konsumentgrupper gör det möjligt för flera förbrukande program att ha en separat vy över händelseströmmen och att läsa strömmen oberoende av varandra i sin egen takt och med sina egna förskjutningar. Mer information finns i Konsumentgrupper.

Exempel:
- Två MedTech-tjänster som har åtkomst till samma händelsehubb.
- En MedTech-tjänst och ett program för lagringsskrivare som kommer åt samma händelsehubb.

Granska distribuerade resurser och åtkomstbehörigheter

När distributionen är klar skapas följande resurser och åtkomstroller i ARM-malldistributionen:

Azure Event Hubs-namnrymd och händelsehubb. I den här distributionen heter händelsehubben devicedata.
- Konsumentgrupp för händelsehubb. I den här distributionen heter konsumentgruppen $Default.
- Azure Event Hubs Data Sender-roll . I den här distributionen heter avsändarrollen devicedatasender och kan användas för att ge åtkomst till händelsehubben med hjälp av en signatur för delad åtkomst (SAS). Mer information om hur du auktoriserar åtkomst med hjälp av en SAS finns i Auktorisera åtkomst till Event Hubs-resurser med signaturer för delad åtkomst.
Arbetsytan Hälsodatatjänster.
Health Data Services FHIR-tjänst®.
Health Data Services MedTech-tjänsten med nödvändiga systemtilldelade hanterade identitetsroller :
- För händelsehubben tilldelas rollen Azure Events Hubs Data Receiver i avsnittet Åtkomstkontroll (IAM) för händelsehubben.
- För FHIR-tjänsten tilldelas rollen FHIR Data Writer i avsnittet Åtkomstkontroll (IAM) för FHIR-tjänsten.

Viktigt!

I den här snabbstarten konfigurerar ARM-mallen MedTech-tjänsten så att den fungerar i läget Skapa . En patientresurs och en enhetsresurs skapas för varje enhet som skickar data till din FHIR-tjänst.

Mer information om MedTech-tjänstmatchningstyperna Skapa och leta upp finns i Konfigurera fliken Mål.

Mappningar efter distributionen

När du har distribuerat en instans av MedTech-tjänsten måste du fortfarande tillhandahålla överensstämmelse och giltiga enhets- och FHIR-målmappningar.

Mer information om enhetsmappning finns i Översikt över enhetsmappningen för MedTech-tjänsten.
Mer information om FHIR-målmappningen finns i Översikt över FHIR-målmappningen.

Rensa Azure PowerShell-resurser

När din resursgrupp och distribuerade Bicep-filresurser inte längre behövs tar du bort resursgruppen, som tar bort resurserna i resursgruppen.

Remove-AzResourceGroup -Name <ResourceGroupName>

Exempelvis: Remove-AzResourceGroup -Name ArmTestDeployment

Rensa Azure CLI-resurserna

När din resursgrupp och distribuerade Bicep-filresurser inte längre behövs tar du bort resursgruppen, som tar bort resurserna i resursgruppen.

az group delete --name <ResourceGroupName>

Exempelvis: az group delete --resource-group ArmTestDeployment

Dricks

En stegvis självstudiekurs som vägleder dig genom processen att skapa en ARM-mall finns i Självstudie: Skapa och distribuera din första ARM-mall.

Nästa steg

Välj en distributionsmetod för MedTech-tjänsten

Översikt över databearbetningsstegen för MedTech-tjänstens enhet

Vanliga frågor och svar om MedTech-tjänsten

Kommentar

FHIR® är ett registrerat varumärke som tillhör HL7 och används med tillstånd av HL7.

Dela via