Teilen über

Schnellstart: Bereitstellen des MedTech-Diensts mit einer Bicep-Datei und Azure PowerShell oder der Azure CLI

  • Artikel

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:

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:

  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, in 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

  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 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. Die Mindestanforderungen für den Basisnamen ist drei Zeichen mit maximal 16 Zeichen.

  5. 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 MedTech-Dienste, 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:

  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, in 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

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

  5. 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 MedTech-Dienste, die auf denselben Event Hub zugreifen.

    • Ein MedTech-Dienst 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 MedTech-Dienst mit den erforderlichen vom System zugewiesenen verwalteten Identitätsrollen:

Wichtig

In dieser Schnellstartanleitung konfiguriert die ARM-Vorlage den MedTech-Dienst so, dass er im Erstellungsmodus 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 MedTech-Dienstauflösungstypen Erstellen und Nachschlagen, 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.

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 MedTech-Dienst

Übersicht über die Datenverarbeitungsphasen des MedTech-Dienstgeräts

Häufig gestellte Fragen zum MedTech-Service

Hinweis

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