Snabbstart: Distribuera MedTech-tjänsten med hjälp av en Bicep-fil och Azure PowerShell eller Azure CLI

Artikel
11/08/2023

Bicep är ett domänspecifikt språk (DSL) som använder deklarativ syntax för att distribuera Azure-resurser. I en Bicep-fil definierar du den infrastruktur som du vill distribuera till Azure och använder sedan filen under hela utvecklingslivscykeln för att distribuera infrastrukturen upprepade gånger. Dina resurser distribueras på ett konsekvent sätt som Bicep ger koncis syntax, tillförlitlig typsäkerhet och stöd för återanvändning av kod. Bicep erbjuder en förstklassig redigeringsupplevelse för dina infrastruktur-som-kod-lösningar i Azure.

I den här snabbstarten lär du 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 Bicep-fil.

Dricks

Mer information om Bicep finns i Vad är Bicep?

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.
- För Azure PowerShell installerar du Bicep CLI för att distribuera Bicep-filen som används i den här snabbstarten.

När du har dessa förutsättningar är du redo att distribuera Bicep-filen.

Granska Bicep-filen

Bicep-filen som används för att distribuera resurserna i den här snabbstarten är tillgänglig i Azure-snabbstartsmallar med hjälp av filen main.bicep på GitHub.

Spara Bicep-filen lokalt

Spara Bicep-filen lokalt som main.bicep. Du måste ha arbetskatalogen för Azure PowerShell eller Azure CLI-konsolen som pekar på platsen där filen sparas.

Distribuera MedTech-tjänsten med Bicep-filen 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 den lokalt sparade main.bicep-filen.

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 BicepTestDeployment -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 Bicep-filen:
```
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>
```
Exempelvis: New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -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 Bicep-filen 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 den lokalt sparade main.bicep-filen.

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 BicepTestDeployment --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 Bicep-filen:
```
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>
```
Exempelvis: az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus
Viktigt!

Om du ska tillåta åtkomst från flera tjänster till händelsehubben för enhetsmeddelanden 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 Bicep-fildistributionen:

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 enhetens händelsehubb 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.
Mer information om FHIR-målmappningen finns i Översikt över FHIR-målmappningen.

Rensa azure PowerShell-distribuerade 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 BicepTestDeployment

Rensa de Azure CLI-distribuerade 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 BicepTestDeployment

Dricks

En stegvis självstudiekurs som vägleder dig genom processen att skapa en Bicep-fil finns i Skapa din första Bicep-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