Schnellstart: Wie Sie den Medizintechnikdienst mithilfe einer Azure Resource Manager-Vorlage und Azure PowerShell oder der Azure CLI bereitstellen
Verwenden Sie Azure Resource Manager-Vorlagen (ARM-Vorlagen), um Infrastructure-as-Code für Ihre Azure-Lösungen zu implementieren. Die Vorlage ist eine JSON-Datei (JavaScript Object Notation), in der die Infrastruktur und die Konfiguration für Ihr Projekt definiert sind. Für die Vorlage wird deklarative Syntax verwendet. Hiermit können Sie angeben, was Sie bereitstellen möchten, ohne dass Sie die Folge der Programmierbefehle für die Erstellung schreiben müssen. In der Vorlage geben Sie die bereitzustellenden Ressourcen und die Eigenschaften für diese Ressourcen an.
In dieser Schnellstartanleitung erfahren Sie, wie Sie Azure PowerShell oder die Azure CLI verwenden, um eine Instanz des Medizintechnikdiensts mithilfe einer Azure Resource Manager-Vorlage (ARM-Vorlage) bereitzustellen.
Tipp
Informationen zu ARM-Vorlagen finden Sie unter Was sind ARM-Vorlagen?
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 Azure CLI lokal installiert.
Wenn Sie über diese Voraussetzungen verfügen, können Sie die ARM-Vorlage bereitstellen.
Überprüfen der ARM-Vorlage
Die ARM-Vorlage, die zum Bereitstellen der Ressourcen in dieser Schnellstartanleitung verwendet wird, steht in Azure-Schnellstartvorlagen mithilfe der Datei azuredeploy.json auf GitHub zur Verfügung.
Bereitstellen des Medizintechnikdiensts mit der Azure Resource Manager-Vorlage und Azure PowerShell
Führen Sie die folgenden fünf Schritte aus, um den Medizintechnikdienst 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 Seite Verfügbare Produkte nach Region für die aktuelle Azure-Regionen an, in denen Azure Health Data Services verfügbar ist.
Sie können auch den Speicherort-Abschnitt der Datei azuredeploy.json ü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 ArmTestDeployment -location southcentralus
Wichtig
Für eine erfolgreiche Bereitstellung des Medizintechnikdiensts müssen Sie Zahlen und Kleinbuchstaben für den Basisnamen Ihrer Ressourcen verwenden. Die Mindestanforderung für einen Basisnamen ist drei Zeichen und die maximale Länge beträgt 16 Zeichen.
Verwenden Sie den folgenden Code, um den Medizintechnikdienst mithilfe der ARM-Vorlage bereitzustellen:
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>
Beispiel:
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
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 Medizintechnikdienst und eine Storage Writer-Anwendung, die auf denselben Event Hub zugreift.
Bereitstellen des Medizintechnikdiensts mit der Azure Resource Manager-Vorlage 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 Seite Verfügbare Produkte nach Region für die aktuelle Azure-Regionen an, in denen Azure Health Data Services verfügbar ist.
Sie können auch den Speicherort-Abschnitt der Datei azuredeploy.json ü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 ArmTestDeployment --location southcentralus
Wichtig
Für eine erfolgreiche Bereitstellung des Medizintechnikdiensts müssen Sie Zahlen und Kleinbuchstaben für den Basisnamen Ihrer Ressourcen verwenden.
Verwenden Sie den folgenden Code, um den Medizintechnikdienst mithilfe der ARM-Vorlage bereitzustellen:
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>
Beispiel:
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
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 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 ARM-Vorlagenbereitstellung 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.
Azure Event Hubs Data Receiver-Rolle. In dieser Bereitstellung heißt die Absenderrolle devicedatasender und kann verwendet werden, um den Zugriff auf den Event Hub mithilfe einer freigegebenen Zugriffssignatur (Shared Access Signature, SAS) bereitzustellen. 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 Medizintechnikdiensts erfolgreich bereitgestellt haben, müssen Sie weiterhin konforme und gültige Geräte- und FHIR-Zielzuordnungen bereitstellen.
Weitere Informationen zur Gerätezuordnung finden Sie unter Übersicht über die Zuordnung von Medizintechnikdienstgeräten.
Weitere Informationen zur FHIR-Zielzuordnung finden Sie unter Übersicht über die FHIR-Zielzuordnung.
Bereinigen von Azure PowerShell-Ressourcen
Wenn Ihre Ressourcengruppe und die bereitgestellten Bicep-Dateiressourcen nicht mehr benötigt werden, löschen Sie die Ressourcengruppe, wodurch die Ressourcen in der Ressourcengruppe gelöscht werden.
Remove-AzResourceGroup -Name <ResourceGroupName>
Beispiel: Remove-AzResourceGroup -Name ArmTestDeployment
Bereinigen der Azure CLI-Ressourcen
Wenn Ihre Ressourcengruppe und die bereitgestellten Bicep-Dateiressourcen nicht mehr benötigt werden, löschen Sie die Ressourcengruppe, wodurch die Ressourcen in der Ressourcengruppe gelöscht werden.
az group delete --name <ResourceGroupName>
Beispiel: az group delete --resource-group ArmTestDeployment
Tipp
Ein Schritt-für-Schritt-Tutorial mit Anleitungen zum Erstellen einer Vorlage finden Sie unter Tutorial: Erstellen und Bereitstellen Ihrer ersten ARM-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.