Schnellstart: Bereitstellen des MedTech-Diensts mit einer Bicep-Datei und Azure PowerShell oder der Azure CLI
Bicep ist eine domänenspezifische Sprache (DSL), die deklarative Syntax zum Bereitstellen von Azure-Ressourcen verwendet. In einer Bicep-Datei definieren Sie die Infrastruktur, die Sie in Azure bereitstellen möchten, und verwenden diese Datei dann während des gesamten Entwicklungslebenszyklus, um Ihre Infrastruktur wiederholt zu implementieren. Ihre Ressourcen werden auf konsistente Weise bereitgestellt, die Bicep bietet präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet die beste Form der Dokumenterstellung für Ihre Infrastructure-as-Code-Lösungen in Azure.
In dieser Schnellstartanleitung erfahren Sie, wie Sie Azure PowerShell oder die Azure CLI verwenden, um eine Instanz des MedTech-Dienstes mithilfe einer Bicep-Datei bereitzustellen.
Tipp
Weitere Informationen zu Bicep finden Sie unter Was ist Bicep?
Voraussetzungen
Um mit der Bereitstellung zu beginnen und die Schnellstartanleitung abzuschließen, müssen Sie über die folgenden Voraussetzungen verfügen:
Ein Konto mit einem aktiven Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, lesen Sie den Leitfaden für die Abonnemententscheidung.
Besitzer- oder Mitwirkender- und Benutzerzugriffsadministrator-Rollenzuweisungen im Azure-Abonnement. Weitere Informationen finden Sie unter Was ist die rollenbasierte Zugriffssteuerung von Azure (Azure Role-Based Access Control, Azure RBAC)?
Die bei Ihrem Azure-Abonnement registrierten Microsoft.HealthcareApis- und Microsoft.EventHub-Ressourcenanbieter. Weitere Informationen zum Registrieren von Ressourcenanbietern finden Sie unter Azure-Ressourcenanbieter und -Typen.
Azure PowerShell und/oder die lokal installierte Azure CLI.
- Installieren Sie für Azure PowerShell die Bicep CLI, um die in dieser Schnellstartanleitung verwendete Bicep-Datei bereitzustellen.
Wenn Sie über diese Voraussetzungen verfügen, können Sie die Bicep-Datei bereitstellen.
Überprüfen der Bicep-Datei
Die Bicep-Datei, die zum Bereitstellen der Ressourcen in dieser Schnellstartanleitung verwendet wird, ist in Azure-Schnellstartvorlagen mithilfe der Datei main.bicep auf GitHub verfügbar.
Lokales Speichern der Bicep-Datei
Speichern Sie die Bicep-Datei lokal als main.bicep. Sie müssen über das Arbeitsverzeichnis Ihrer Azure PowerShell oder die Azure CLI-Konsole verfügen, die auf den Speicherort dieser Datei zeigt.
Bereitstellen des MedTech-Diensts mit der Bicep-Datei und Azure PowerShell
Führen Sie die folgenden fünf Schritte aus, um den MedTech-Dienst mit Azure PowerShell bereitzustellen:
Melden Sie sich bei Azure an.
Connect-AzAccount
Legen Sie ihren Azure-Abonnementbereitstellungskontext mithilfe Ihrer Abonnement-ID fest. Informationen zum Abrufen Ihrer Abonnement-ID finden Sie unter Abrufen von Abonnement- und Mandanten-IDs im Azure-Portal.
Set-AzContext <AzureSubscriptionId>
Beispiel:
Set-AzContext abcdef01-2345-6789-0abc-def012345678
Bestätigen Sie den Speicherort, an dem Sie bereitstellen möchten. Sehen Sie sich die Produktverfügbarkeit nach Region für Azure Health Data Services auf der Website für die aktuellen Azure-Regionen an.
Sie können auch den Speicherortabschnitt der lokal gespeicherten Datei main.bicep überprüfen.
Wenn Sie eine Liste der Azure-Regionsstandortnamen benötigen, können Sie diesen Code verwenden, um eine Liste anzuzeigen:
Get-AzLocation | Format-Table -Property DisplayName,Location
Wenn Sie noch keine Ressourcengruppe für diese Schnellstartanleitung erstellt haben, können Sie diesen Code verwenden, um eine zu erstellen:
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
Beispiel:
New-AzResourceGroup -name BicepTestDeployment -location southcentralus
Wichtig
Für eine erfolgreiche Bereitstellung des Medizintechnikdiensts müssen Sie Zahlen und Kleinbuchstaben für den Basisnamen Ihrer Ressourcen verwenden. Die Mindestanforderungen für den Basisnamen ist drei Zeichen mit maximal 16 Zeichen.
Verwenden Sie den folgenden Code, um den MedTech-Dienst mithilfe der Bicep-Datei bereitzustellen:
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>
Beispiel:
New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -basename abc123 -location southcentralus
Wichtig
Wenn Sie den Zugriff von mehreren Diensten auf den Event Hub zulassen möchten, wird dringend empfohlen, dass jeder Dienst über eine eigene Event Hub-Consumergruppe verfügt.
Mithilfe von Consumergruppen können mehrere verarbeitende Anwendungen eine separate Ansicht des Ereignisdatenstroms aufweisen und den Datenstrom unabhängig voneinander in einem unabhängigen Tempo und mit eigenen Offsets lesen. Weitere Informationen finden Sie unter Consumergruppen.
Beispiele:
Zwei Medizintechnikdienste, die auf denselben Event Hub zugreifen.
Ein MedTech-Dienst und eine Storage Writer-Anwendung, die auf denselben Event Hub zugreift.
Bereitstellen des MedTech-Diensts mit der Bicep-Datei und der Azure CLI
Führen Sie die folgenden fünf Schritte aus, um den MedTech-Dienst mithilfe der Azure CLI bereitzustellen:
Melden Sie sich bei Azure an.
az login
Legen Sie ihren Azure-Abonnementbereitstellungskontext mithilfe Ihrer Abonnement-ID fest. Informationen zum Abrufen Ihrer Abonnement-ID finden Sie unter Abrufen von Abonnement- und Mandanten-IDs im Azure-Portal.
az account set <AzureSubscriptionId>
Beispiel:
az account set abcdef01-2345-6789-0abc-def012345678
Bestätigen Sie den Speicherort, an dem Sie bereitstellen möchten. Sehen Sie sich die Produktverfügbarkeit nach Region für Azure Health Data Services auf der Website für die aktuellen Azure-Regionen an.
Sie können auch den Speicherortabschnitt der lokal gespeicherten Datei main.bicep überprüfen.
Wenn Sie eine Liste der Azure-Regionsstandortnamen benötigen, können Sie diesen Code verwenden, um eine Liste anzuzeigen:
az account list-locations -o table
Wenn Sie noch keine Ressourcengruppe für diese Schnellstartanleitung erstellt haben, können Sie diesen Code verwenden, um eine zu erstellen:
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
Beispiel:
az group create --resource-group BicepTestDeployment --location southcentralus
Wichtig
Für eine erfolgreiche Bereitstellung des MedTech-Diensts müssen Sie Zahlen und Kleinbuchstaben für den Basisnamen Ihrer Ressourcen verwenden.
Verwenden Sie den folgenden Code, um den MedTech-Dienst mithilfe der Bicep-Datei bereitzustellen:
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>
Beispiel:
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus
Wichtig
Wenn Sie den Zugriff von mehreren Diensten auf den Event Hub für Gerätenachrichten zulassen möchten, wird dringend empfohlen, dass jeder Dienst über eine eigene Event Hub-Consumergruppe verfügt.
Mithilfe von Consumergruppen können mehrere verarbeitende Anwendungen eine separate Ansicht des Ereignisdatenstroms aufweisen und den Datenstrom unabhängig voneinander in einem unabhängigen Tempo und mit eigenen Offsets lesen. Weitere Informationen finden Sie unter Consumergruppen.
Beispiele:
Zwei Medizintechnikdienste, die auf denselben Event Hub zugreifen.
Ein Medizintechnikdienst und eine Storage Writer-Anwendung, die auf denselben Event Hub zugreift.
Überprüfen der bereitgestellten Ressourcen und Zugriffsberechtigungen
Nach Abschluss der Bereitstellung werden die folgenden Ressourcen und Zugriffsrollen in der Bicep-Dateibereitstellung erstellt:
Azure Event Hubs: Namespace und Event Hub. In dieser Bereitstellung heißt der Event Hub devicedata.
Event Hub-Consumergruppe. In dieser Bereitstellung wird die Consumergruppe $Default genannt.
Rolle des Azure Event Hubs-Datensenders. In dieser Bereitstellung heißt die Senderrolle devicedatasender und kann verwendet werden, um den Zugriff auf den Geräte-Event Hub mithilfe einer freigegebenen Zugriffssignatur (SAS) zu ermöglichen. Weitere Informationen zum Autorisieren des Zugriffs mithilfe einer SAS finden Sie unter Autorisieren des Zugriffs auf Event Hubs-Ressourcen mit freigegebenen Zugriffssignaturen.
Health Data Services-Arbeitsbereich.
Health Data Services-FHIR®-Dienst.
Health Data Services-Medizintechnikdienst mit den erforderlichen Rollen für vom System zugewiesenen verwalteten Identitäten:
Für den Event Hub wird die Rolle Azure Events Hubs Data Receiver im Abschnitt „Zugriffssteuerung“ (IAM) des Event Hubs zugewiesen.
Für den FHIR-Dienst wird die Rolle FHIR Data Writer im Abschnitt „Zugriffssteuerung“ (IAM) des FHIR-Diensts zugewiesen.
Wichtig
In dieser Schnellstartanleitung konfiguriert die ARM-Vorlage den Medizintechnikdienst so, dass er im Erstellen-Modus ausgeführt wird. Für jedes Gerät, das Daten an Ihren FHIR-Dienst sendet, wird eine Patientenressource und eine Geräteressource erstellt.
Weitere Informationen zu den Medizintechnikdienstauflösungstypen Erstellen und Lookup finden Sie auf der Registerkarte „Ziel konfigurieren“.
Zuordnungen nach der Bereitstellung
Nachdem Sie eine Instanz des MedTech-Diensts erfolgreich bereitgestellt haben, müssen Sie weiterhin konforme und gültige Geräte- und FHIR-Zielzuordnungen bereitstellen.
Informationen zur Gerätezuordnung finden Sie unter Übersicht über die Gerätezuordnung.
Weitere Informationen zur FHIR-Zielzuordnung finden Sie unter Übersicht über die FHIR-Zielzuordnung.
Bereinigen von durch Azure PowerShell bereitgestellten Ressourcen
Wenn Ihre Ressourcengruppe und die bereitgestellten Bicep-Dateiressourcen nicht mehr benötigt werden, löschen Sie die Ressourcengruppe, was die Ressourcen in der Ressourcengruppe löscht.
Remove-AzResourceGroup -Name <ResourceGroupName>
Beispiel: Remove-AzResourceGroup -Name BicepTestDeployment
Bereinigen der bereitgestellten Ressourcen der Azure CLI
Wenn Ihre Ressourcengruppe und die bereitgestellten Bicep-Dateiressourcen nicht mehr benötigt werden, löschen Sie die Ressourcengruppe, was die Ressourcen in der Ressourcengruppe löscht.
az group delete --name <ResourceGroupName>
Beispiel: az group delete --resource-group BicepTestDeployment
Tipp
Ein schrittweises Tutorial, das Sie durch das Erstellen einer Bicep-Datei führt, finden Sie unter Erstellen Ihrer ersten Bicep-Vorlage.
Nächste Schritte
Auswählen einer Bereitstellungsmethode für den Medizintechnikdienst
Übersicht über die Datenverarbeitungsphasen des Medizintechnikdienstgeräts
Häufig gestellte Fragen zum MedTech-Dienst
Hinweis
FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.