Quickstart: De MedTech-service implementeren met behulp van een Bicep-bestand en Azure PowerShell of de Azure CLI

Artikel
11/08/2023

Bicep is een domeinspecifieke taal (DSL) die declaratieve syntaxis gebruikt om Azure-resources te implementeren. In een Bicep-bestand definieert u de infrastructuur die u wilt implementeren in Azure en gebruikt u dat bestand vervolgens gedurende de ontwikkelingslevenscyclus om uw infrastructuur herhaaldelijk te implementeren. Uw resources worden op een consistente manier geïmplementeerd door Bicep en biedt beknopte syntaxis, betrouwbare typeveiligheid en ondersteuning voor hergebruik van code. Bicep biedt een eersteklas ontwerpervaring voor uw infrastructuur als code-oplossingen in Azure.

In deze quickstart leert u hoe u Azure PowerShell of de Azure CLI gebruikt om een exemplaar van de MedTech-service te implementeren met behulp van een Bicep-bestand.

Tip

Zie Wat is Bicep voor meer informatie over Bicep?

Vereisten

Als u de implementatie wilt starten en de quickstart wilt voltooien, moet u aan de volgende vereisten voldoen:

Een actief Azure-abonnementsaccount. Als u geen Azure-abonnement hebt, raadpleegt u de handleiding voor abonnementsbeslissing.
Roltoewijzingen eigenaar of inzender of inzender en rolbeheerder voor gebruikerstoegang in het Azure-abonnement. Zie Wat is op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC)?
De resourceproviders Microsoft.HealthcareApis en Microsoft.EventHub die zijn geregistreerd bij uw Azure-abonnement. Zie Azure-resourceproviders en -typen voor meer informatie over het registreren van resourceproviders.
Azure PowerShell en/of de Azure CLI lokaal geïnstalleerd.
- Installeer voor Azure PowerShell de Bicep CLI om het Bicep-bestand te implementeren dat in deze quickstart wordt gebruikt.

Wanneer u aan deze vereisten voldoet, kunt u het Bicep-bestand implementeren.

Het Bicep-bestand controleren

Het Bicep-bestand dat wordt gebruikt om de resources in deze quickstart te implementeren, is beschikbaar in Azure Quickstart-sjablonen met behulp van het bestand main.bicep op GitHub.

Het Bicep-bestand lokaal opslaan

Sla het Bicep-bestand lokaal op als main.bicep. U moet de werkmap van uw Azure PowerShell of de Azure CLI-console hebben die verwijst naar de locatie waar dit bestand is opgeslagen.

De MedTech-service implementeren met het Bicep-bestand en Azure PowerShell

Voer de volgende vijf stappen uit om de MedTech-service te implementeren met behulp van Azure PowerShell:

Meld u aan bij Azure.
```
Connect-AzAccount
```
Stel de implementatiecontext van uw Azure-abonnement in met behulp van uw abonnements-id. Zie Abonnements- en tenant-id's ophalen in De Azure-portal voor meer informatie over het ophalen van uw abonnements-id.
```
Set-AzContext <AzureSubscriptionId>
```
Bijvoorbeeld: Set-AzContext abcdef01-2345-6789-0abc-def012345678
Bevestig de locatie waarin u wilt implementeren. Zie de producten die beschikbaar zijn per regiosite voor de huidige Azure-regio's waar Azure Health Data Services beschikbaar is.

U kunt ook de locatiesectie van het lokaal opgeslagen main.bicep-bestand bekijken.

Als u een lijst met de locatienamen van Azure-regio's nodig hebt, kunt u deze code gebruiken om een lijst weer te geven:
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
Als u nog geen resourcegroep hebt gemaakt voor deze quickstart, kunt u deze code gebruiken om er een te maken:
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
Bijvoorbeeld: New-AzResourceGroup -name BicepTestDeployment -location southcentralus

Belangrijk

Voor een succesvolle implementatie van de MedTech-service moet u cijfers en kleine letters gebruiken voor de basisnaam van uw resources. De minimale basisnaamvereiste is drie tekens met maximaal 16 tekens.
Gebruik de volgende code om de MedTech-service te implementeren met behulp van het Bicep-bestand:
```
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>
```
Bijvoorbeeld: New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -basename abc123 -location southcentralus
Belangrijk

Als u toegang van meerdere services naar de Event Hub wilt toestaan, wordt het ten zeerste aanbevolen dat elke service een eigen Event Hub-consumentengroep heeft.

Met consumentengroepen kunnen meerdere verbruikende toepassingen een afzonderlijke weergave van de gebeurtenisstroom hebben en de stroom onafhankelijk in hun eigen tempo en met hun eigen offsets lezen. Zie Consumentengroepen voor meer informatie.

Voorbeelden:
- Twee MedTech-services die toegang hebben tot dezelfde Event Hub.
- Een MedTech-service en een opslagschrijvertoepassing die toegang heeft tot dezelfde Event Hub.

De MedTech-service implementeren met het Bicep-bestand en de Azure CLI

Voer de volgende vijf stappen uit om de MedTech-service te implementeren met behulp van de Azure CLI:

Meld u aan bij Azure.
```
az login
```
Stel de implementatiecontext van uw Azure-abonnement in met behulp van uw abonnements-id. Zie Abonnements- en tenant-id's ophalen in De Azure-portal voor meer informatie over het ophalen van uw abonnements-id.
```
az account set <AzureSubscriptionId>
```
Bijvoorbeeld: az account set abcdef01-2345-6789-0abc-def012345678
Bevestig de locatie waarin u wilt implementeren. Zie de producten die beschikbaar zijn per regiosite voor de huidige Azure-regio's waar Azure Health Data Services beschikbaar is.

U kunt ook de locatiesectie van het lokaal opgeslagen main.bicep-bestand bekijken.

Als u een lijst met de locatienamen van Azure-regio's nodig hebt, kunt u deze code gebruiken om een lijst weer te geven:
```
az account list-locations -o table
```
Als u nog geen resourcegroep hebt gemaakt voor deze quickstart, kunt u deze code gebruiken om er een te maken:
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
Bijvoorbeeld: az group create --resource-group BicepTestDeployment --location southcentralus

Belangrijk

Voor een succesvolle implementatie van de MedTech-service moet u cijfers en kleine letters gebruiken voor de basisnaam van uw resources.
Gebruik de volgende code om de MedTech-service te implementeren met behulp van het Bicep-bestand:
```
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>
```
Bijvoorbeeld: az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus
Belangrijk

Als u toegang van meerdere services naar de Event Hub voor apparaatberichten toestaat, wordt het ten zeerste aanbevolen dat elke service een eigen Event Hub-consumentengroep heeft.

Met consumentengroepen kunnen meerdere verbruikende toepassingen een afzonderlijke weergave van de gebeurtenisstroom hebben en de stroom onafhankelijk in hun eigen tempo en met hun eigen offsets lezen. Zie Consumentengroepen voor meer informatie.

Voorbeelden:
- Twee MedTech-services die toegang hebben tot dezelfde Event Hub.
- Een MedTech-service en een opslagschrijvertoepassing die toegang heeft tot dezelfde Event Hub.

Geïmplementeerde resources en toegangsmachtigingen controleren

Wanneer de implementatie is voltooid, worden de volgende resources en toegangsrollen gemaakt in de bicep-bestandsimplementatie:

Azure Event Hubs-naamruimte en Event Hub. In deze implementatie heeft de Event Hub de naam devicedata.
- Event Hub-consumentengroep. In deze implementatie krijgt de consumentengroep de naam $Default.
- De rol Azure Event Hubs-gegevenszender . In deze implementatie heet de afzenderrol devicedatasender en kan deze worden gebruikt om toegang te bieden tot de Event Hub van het apparaat met behulp van een Shared Access Signature (SAS). Zie Toegang tot Event Hubs-resources autoriseren met Shared Access Signatures voor meer informatie over het autoriseren van toegang met behulp van een SAS.
Health Data Services-werkruimte.
Health Data Services FHIR-service®.
Health Data Services MedTech-service met de vereiste door het systeem toegewezen beheerde identiteitsrollen :
- Voor de Event Hub wordt de rol Azure Events Hubs-gegevensontvanger toegewezen in de sectie Toegangsbeheer (IAM) van de Event Hub.
- Voor de FHIR-service wordt de rol FHIR Data Writer toegewezen in de sectie Toegangsbeheer (IAM) van de FHIR-service.

Belangrijk

In deze quickstart configureert de ARM-sjabloon de MedTech-service voor gebruik in de modus Maken . Er worden een patiëntresource en een apparaatresource gemaakt voor elk apparaat dat gegevens naar uw FHIR-service verzendt.

Zie Het tabblad Bestemming configureren voor meer informatie over de typen Oplossingen voor medTech-services maken en opzoeken.

Toewijzingen na implementatie

Nadat u een exemplaar van de MedTech-service hebt geïmplementeerd, moet u nog steeds conforme en geldige apparaat- en FHIR-doeltoewijzingen opgeven.

Geïmplementeerde Azure PowerShell-resources opschonen

Wanneer uw resourcegroep en geïmplementeerde Bicep-bestandsresources niet meer nodig zijn, verwijdert u de resourcegroep, waarmee de resources in de resourcegroep worden verwijderd.

Remove-AzResourceGroup -Name <ResourceGroupName>

Bijvoorbeeld: Remove-AzResourceGroup -Name BicepTestDeployment

De geïmplementeerde Azure CLI-resources opschonen

Wanneer uw resourcegroep en geïmplementeerde Bicep-bestandsresources niet meer nodig zijn, verwijdert u de resourcegroep, waarmee de resources in de resourcegroep worden verwijderd.

az group delete --name <ResourceGroupName>

Bijvoorbeeld: az group delete --resource-group BicepTestDeployment

Tip

Zie Uw eerste Bicep-sjabloon bouwen voor een stapsgewijze zelfstudie die u begeleidt bij het maken van een Bicep-bestand.

Volgende stappen

Een implementatiemethode kiezen voor de MedTech-service

Overzicht van de verwerkingsfasen van het MedTech-serviceapparaat

Veelgestelde vragen over de MedTech-service

Notitie

FHIR® is een geregistreerd handelsmerk van HL7 en wordt gebruikt met de machtiging HL7.

Delen via