Schnellstart: Wie Sie den Medizintechnikdienst mithilfe einer Azure Resource Manager-Vorlage und Azure PowerShell oder der Azure CLI bereitstellen

  • Artikel

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:

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:

  1. Melden Sie sich bei Azure an.

    Connect-AzAccount

  2. 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

  3. 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

  4. 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.

  5. 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:

  1. Melden Sie sich bei Azure an.

    az login

  2. 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

  3. 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

  4. 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.

  5. 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:

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.

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 Medizintechnikdienst

Hinweis

FHIR® ist eine eingetragene Marke von HL7 und wird mit Genehmigung von HL7 verwendet.