Démarrage rapide : Déployer le service MedTech à l’aide d’un modèle Azure Resource Manager et d’Azure PowerShell ou d’Azure CLI

Article
11/18/2023

Pour implémenter une infrastructure en tant que code pour vos solutions Azure, utilisez des modèles Azure Resource Manager (modèles ARM). Le modèle est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative, qui vous permet d’indiquer ce que vous envisagez de déployer sans avoir à écrire la séquence de commandes de programmation pour le créer. Dans le modèle, vous spécifiez les ressources à déployer et les propriétés de ces ressources.

Dans ce guide de démarrage rapide, découvrez comment utiliser Azure PowerShell ou Azure CLI pour déployer une instance du service MedTech à l’aide d’un modèle Azure Resource Manager (modèle ARM).

Conseil

Pour en savoir plus sur les modèles ARM, consultez Que sont les modèles ARM ?

Prérequis

Pour commencer votre déploiement et suivre ce guide de démarrage rapide, vous devez préalablement disposer des éléments suivants :

Un compte d’abonnement Azure actif. Si vous n’avez pas d’abonnement Azure, consultez le Guide de décision de l’abonnement.
Attributions de rôle Propriétaire ou Contributeur et Administrateur d’accès utilisateur dans l’abonnement Azure. Pour plus d’informations, consultez Qu’est-ce que le contrôle d’accès en fonction du rôle Azure (Azure RBAC) ?
Les fournisseurs de ressources Microsoft.HealthcareApis et Microsoft.EventHub inscrits auprès de votre abonnement Azure. Pour en savoir plus sur l’inscription de fournisseurs de ressources, consultez Fournisseurs et types de ressources Azure.
Azure PowerShell et/ou Azure CLI installés en local.

Lorsque vous remplissez ces conditions préalables, vous êtes prêt à déployer le modèle ARM.

Examiner le modèle ARM

Le modèle ARM utilisé pour déployer les ressources de ce guide de démarrage rapide est disponible dans les Modèles de démarrage rapide Azure à l’aide du fichier azuredeploy.json sur GitHub.

Déployer le service MedTech avec le modèle Azure Resource Manager et Azure PowerShell

Effectuez les cinq étapes suivantes pour déployer le service MedTech à l’aide d’Azure PowerShell :

Connectez-vous à Azure.
```
Connect-AzAccount
```
Définissez votre contexte de déploiement d’abonnement Azure à l’aide de votre ID d’abonnement. Pour savoir comment obtenir votre ID d’abonnement, consultez Obtenir les ID d’abonnement et de locataire sur le portail Azure.
```
Set-AzContext <AzureSubscriptionId>
```
Par exemple : Set-AzContext abcdef01-2345-6789-0abc-def012345678
Confirmez l’emplacement dans lequel vous souhaitez effectuer le déploiement. Consultez le site Produits disponibles par région pour les régions Azure actuelles où Services de données de santé Azure est disponible.

Vous pouvez également consulter la section emplacement du fichier azuredeploy.json.

Si vous avez besoin d’une liste des noms d’emplacements des régions Azure, vous pouvez utiliser ce code pour afficher une liste :
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
Si vous n’avez pas encore créé de groupe de ressources pour ce guide de démarrage rapide, vous pouvez utiliser ce code pour en créer un :
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
Par exemple : New-AzResourceGroup -name ArmTestDeployment -location southcentralus

Important

Pour un déploiement réussi du service MedTech, vous devez utiliser des chiffres et des lettres minuscules pour le nom de base de vos ressources. Le nom de base doit contenir au moins trois caractères avec un maximum de 16 caractères.
Utilisez le code suivant pour déployer le service MedTech en utilisant le modèle ARM :
```
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>
```
Par exemple : 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
Important

Si vous souhaitez autoriser l’accès à partir de plusieurs services au hub d’événements, il est fortement recommandé que chaque service dispose de son propre groupe de consommateurs Event Hub.

Les groupes de consommateurs permettent à plusieurs applications consommatrices d’avoir une vue distincte du flux d’événements et de lire le flux indépendamment, à leur propre rythme et avec leurs propres décalages. Pour plus d’informations, consultez Groupes de consommateurs.

Exemples :
- Deux services MedTech accédant au même hub d’événements.
- Un service MedTech et une application enregistreur de stockage qui accèdent au même hub d’événements.

Déployer le service MedTech avec le modèle Azure Resource Manager et Azure CLI

Effectuez les cinq étapes suivantes pour déployer le service MedTech à l’aide d’Azure CLI :

Connectez-vous à Azure.
```
az login
```
Définissez votre contexte de déploiement d’abonnement Azure à l’aide de votre ID d’abonnement. Pour savoir comment obtenir votre ID d’abonnement, consultez Obtenir les ID d’abonnement et de locataire sur le portail Azure.
```
az account set <AzureSubscriptionId>
```
Par exemple : az account set abcdef01-2345-6789-0abc-def012345678
Confirmez l’emplacement dans lequel vous souhaitez effectuer le déploiement. Consultez le site Produits disponibles par région pour les régions Azure actuelles où Services de données de santé Azure est disponible.

Vous pouvez également consulter la section emplacement du fichier azuredeploy.json.

Si vous avez besoin d’une liste des noms d’emplacements des régions Azure, vous pouvez utiliser ce code pour afficher une liste :
```
az account list-locations -o table
```
Si vous n’avez pas encore créé de groupe de ressources pour ce guide de démarrage rapide, vous pouvez utiliser ce code pour en créer un :
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
Par exemple : az group create --resource-group ArmTestDeployment --location southcentralus

Important

Pour un déploiement réussi du service MedTech, vous devez utiliser des chiffres et des lettres minuscules pour le nom de base de vos ressources.
Utilisez le code suivant pour déployer le service MedTech en utilisant le modèle ARM :
```
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>
```
Par exemple : 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
Important

Si vous souhaitez autoriser l’accès à partir de plusieurs services au hub d’événements, il est fortement recommandé que chaque service dispose de son propre groupe de consommateurs Event Hub.

Les groupes de consommateurs permettent à plusieurs applications consommatrices d’avoir une vue distincte du flux d’événements et de lire le flux indépendamment, à leur propre rythme et avec leurs propres décalages. Pour plus d’informations, consultez Groupes de consommateurs.

Exemples :
- Deux services MedTech accédant au même hub d’événements.
- Un service MedTech et une application enregistreur de stockage qui accèdent au même hub d’événements.

Passez en revue les ressources déployées et les autorisations d’accès

Une fois le déploiement terminé, les ressources et les rôles d’accès suivants sont créés dans le déploiement du modèle ARM :

Espace de noms et hub d’événements Azure Event Hubs. Dans ce déploiement, le hub d’événements est nommé devicedata.
- Groupe de consommateurs Event Hub. Dans ce déploiement, le groupe de consommateurs est nommé $Default.
- Rôle Expéditeur de données Azure Event Hubs. Dans ce déploiement, le rôle d’expéditeur est nommé devicedatasender et peut être utilisé pour fournir l’accès au hub d’événements à l’aide d’une signature d’accès partagé (SAP). Pour en savoir plus sur l’autorisation de l’accès à l’aide d’une SAP, consultez Autoriser l’accès aux ressources Event Hubs à l’aide de signatures d’accès partagé.
Espace de travail Services de données de santé.
Service FHIR® des Services de données de santé.
Le service MedTech de Services de données de santé avec les rôles d’identité managée affectée par le système requis :
- Pour le hub d’événements, le rôle Récepteur de données Azure Event Hubs est attribué dans la section Contrôle d’accès (IAM) du hub d’événements.
- Pour le service FHIR, le rôle Enregistreur de données FHIR est attribué dans la section Contrôle d’accès (IAM) du service FHIR.

Important

Dans ce guide de démarrage rapide, le modèle ARM configure le service MedTech pour qu’il fonctionne dans le mode Créer. Une ressource patient et une ressource d’appareil sont créées pour chaque appareil qui envoie des données à votre service FHIR.

Pour en savoir plus sur les types de résolution de service MedTech Créer et Rechercher, consultez Configurer l’onglet Destination.

Mappages post-déploiement

Une fois que vous avez déployé avec succès une instance du service MedTech, vous devez toujours fournir des mappages d’appareil et de destination FHIR conformes et valides.

Pour en savoir plus sur le mappage des appareils, consultez Vue d’ensemble du mappage des appareils du service MedTech.
Pour en savoir plus sur le mappage de destination FHIR, consultez Vue d’ensemble du mappage de destination FHIR.

Nettoyer les ressources Azure PowerShell

Lorsque votre groupe de ressources et vos ressources de fichier Bicep déployées ne sont plus nécessaires, supprimez le groupe de ressources, ce qui supprime les ressources du groupe de ressources.

Remove-AzResourceGroup -Name <ResourceGroupName>

Par exemple : Remove-AzResourceGroup -Name ArmTestDeployment

Nettoyer les ressources Azure CLI

Lorsque votre groupe de ressources et vos ressources de fichier Bicep déployées ne sont plus nécessaires, supprimez le groupe de ressources, ce qui supprime les ressources du groupe de ressources.

az group delete --name <ResourceGroupName>

Par exemple : az group delete --resource-group ArmTestDeployment

Conseil

Pour obtenir un tutoriel pas à pas vous guidant tout au long du processus de création d’un modèle ARM, consultez :Tutoriel : Créer et déployer votre premier modèle ARM.