Quickstart: De MedTech-service implementeren met behulp van een Azure Resource Manager-sjabloon en Azure PowerShell of de Azure CLI
Als u infrastructuur wilt implementeren als code voor uw Azure-oplossingen, gebruikt u Azure Resource Manager-sjablonen (ARM-sjablonen). De sjabloon is een JavaScript Object Notation-bestand (JSON) dat de infrastructuur en configuratie van uw project definieert. De sjabloon gebruikt een declaratieve syntaxis. Dit is een syntaxis waarmee u kunt aangeven wat u wilt implementeren zonder hiervoor de nodige reeks programmeeropdrachten te hoeven maken. In de sjabloon geeft u de resources op die moeten worden geïmplementeerd en de eigenschappen voor deze resources.
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 Arm-sjabloon (Azure Resource Manager).
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.
Wanneer u aan deze vereisten voldoet, kunt u de ARM-sjabloon implementeren.
De ARM-sjabloon controleren
De ARM-sjabloon die wordt gebruikt om de resources in deze quickstart te implementeren, is beschikbaar in Azure Quickstart-sjablonen met behulp van het azuredeploy.json-bestand op GitHub.
De MedTech-service implementeren met de Azure Resource Manager-sjabloon 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 azuredeploy.json-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 ArmTestDeployment -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 de ARM-sjabloon:
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>
Bijvoorbeeld:
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
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 de Azure Resource Manager-sjabloon 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 azuredeploy.json-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 ArmTestDeployment --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 de ARM-sjabloon:
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>
Bijvoorbeeld:
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
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.
Geïmplementeerde resources en toegangsmachtigingen controleren
Wanneer de implementatie is voltooid, worden de volgende resources en toegangsrollen gemaakt in de ARM-sjabloonimplementatie:
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 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.
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 ArmTestDeployment
De 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 ArmTestDeployment
Tip
Zie Zelfstudie: Uw eerste ARM-sjabloon maken en implementeren voor een stapsgewijze zelfstudie die u begeleidt bij het maken van een ARM-sjabloon.
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.