Inicio rápido: Implementación del servicio de tecnologías médicas mediante la plantilla de Azure Resource Manager y Azure PowerShell o la CLI de Azure

Artículo
11/22/2023

Para implementar la infraestructura como código para las soluciones de Azure, use las plantillas de Azure Resource Manager (plantillas de ARM). La plantilla es un archivo de notación de objetos JavaScript (JSON) que contiene la infraestructura y la configuración del proyecto. La plantilla usa sintaxis declarativa, lo que permite establecer lo que pretende implementar sin tener que escribir la secuencia de comandos de programación para crearla. En la plantilla se especifican los recursos que se van a implementar y las propiedades de esos recursos.

En este inicio rápido, aprenderá a usar Azure PowerShell o la CLI de Azure para implementar una instancia del servicio de tecnologías médicas mediante la plantilla de Azure Resource Manager (plantilla de ARM).

Sugerencia

Consulte ¿Qué son las plantillas de Resource Manager? para obtener más información sobre las plantillas de ARM.

Requisitos previos

Para comenzar la implementación y completar el inicio rápido, debe cumplir con los siguientes requisitos previos:

Una cuenta de suscripción a Azure activa. Si no tiene una suscripción de Azure, consulte Guía de decisión de suscripción.
Asignaciones de roles de propietario o colaborador y administrador de acceso de usuario en la suscripción de Azure. Para obtener más información, consulte ¿Qué es el control de acceso basado en roles (RBAC) de Azure?
Los proveedores de recursos Microsoft.HealthcareApis y Microsoft.EventHub registrados en la suscripción de Azure. Para más información sobre el registro de proveedores de recursos, consulte Tipos y proveedores de recursos de Azure.
Instalación local de Azure PowerShell y/o la CLI de Azure.

Cuando cumpla con estos requisitos previos, estará listo para implementar la plantilla de ARM.

Revisión de la plantilla de ARM

La plantilla de ARM que se usa para implementar los recursos de este inicio rápido está disponible en las Plantillas de inicio rápido de Azure mediante el archivo azuredeploy.json en GitHub.

Implementación del servicio de tecnologías médicas mediante la plantilla de Azure Resource Manager y Azure PowerShell

Complete los cinco pasos siguientes para implementar el servicio de tecnologías médicas mediante Azure PowerShell:

Inicie sesión en Azure.
```
Connect-AzAccount
```
Establezca el contexto de implementación de la suscripción de Azure mediante el id. de suscripción. Para obtener información sobre cómo obtener el id. de suscripción, consulte Obtención de los id. de suscripción e inquilino en Azure Portal.
```
Set-AzContext <AzureSubscriptionId>
```
Por ejemplo: Set-AzContext abcdef01-2345-6789-0abc-def012345678
Confirme la ubicación en la que desea realizar la implementación. Consulte el sitio Productos disponibles por región para ver las regiones de Azure actuales en las que Azure Health Data Services está disponible.

También puede revisar la sección ubicación del archivo azuredeploy.json.

Si necesita una lista de los nombres de ubicación de las regiones de Azure, puede usar este código para mostrar una lista:
```
Get-AzLocation | Format-Table -Property DisplayName,Location
```
Si aún no tiene un grupo de recursos creado para este inicio rápido, puede usar este código para crear uno:
```
New-AzResourceGroup -name <ResourceGroupName> -location <AzureRegion>
```
Por ejemplo: New-AzResourceGroup -name ArmTestDeployment -location southcentralus

Importante

Para una implementación correcta del servicio de tecnologías médicas, deberá usar números y letras minúsculas para el nombre base de los recursos. El requisito mínimo de nombre base es de tres caracteres con un máximo de 16 caracteres.
Use el código siguiente para implementar el servicio de tecnologías médicas mediante la plantilla de 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>
```
Por ejemplo: 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
Importante

Si va a permitir el acceso desde varios servicios al centro de eventos, es muy recomendable que cada servicio tenga su propio grupo de consumidores del centro de eventos.

Los grupos de consumidores habilitan varias aplicaciones consumidoras para tener una vista separada del flujo de eventos y para leer el flujo de forma independiente a su propio ritmo y con sus propios desplazamientos. Para obtener más información, consulte los grupos de consumidores.

Ejemplos:
- Dos servicios de tecnologías médicas que acceden al mismo centro de eventos.
- Un servicio de tecnologías médicas y una aplicación de escritura de almacenamiento que acceden al mismo centro de eventos.

Implementación del servicio de tecnologías médicas mediante la plantilla de Azure Resource Manager y la CLI de Azure

Complete los cinco pasos siguientes para implementar el servicio de tecnologías médicas mediante la CLI de Azure:

Inicie sesión en Azure.
```
az login
```
Establezca el contexto de implementación de la suscripción de Azure mediante el id. de suscripción. Para obtener información sobre cómo obtener el id. de suscripción, consulte Obtención de los id. de suscripción e inquilino en Azure Portal.
```
az account set <AzureSubscriptionId>
```
Por ejemplo: az account set abcdef01-2345-6789-0abc-def012345678
Confirme la ubicación en la que desea realizar la implementación. Consulte el sitio Productos disponibles por región para ver las regiones de Azure actuales en las que Azure Health Data Services está disponible.

También puede revisar la sección ubicación del archivo azuredeploy.json.

Si necesita una lista de los nombres de ubicación de las regiones de Azure, puede usar este código para mostrar una lista:
```
az account list-locations -o table
```
Si aún no tiene un grupo de recursos creado para este inicio rápido, puede usar este código para crear uno:
```
az group create --resource-group <ResourceGroupName> --location <AzureRegion>
```
Por ejemplo: az group create --resource-group ArmTestDeployment --location southcentralus

Importante

Para una implementación correcta del servicio de tecnologías médicas, deberá usar números y letras minúsculas para el nombre base de los recursos.
Use el código siguiente para implementar el servicio de tecnologías médicas mediante la plantilla de 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>
```
Por ejemplo: 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
Importante

Si va a permitir el acceso desde varios servicios al centro de eventos, es muy recomendable que cada servicio tenga su propio grupo de consumidores del centro de eventos.

Los grupos de consumidores habilitan varias aplicaciones consumidoras para tener una vista separada del flujo de eventos y para leer el flujo de forma independiente a su propio ritmo y con sus propios desplazamientos. Para obtener más información, consulte los grupos de consumidores.

Ejemplos:
- Dos servicios de tecnologías médicas que acceden al mismo centro de eventos.
- Un servicio de tecnologías médicas y una aplicación de escritura de almacenamiento que acceden al mismo centro de eventos.

Revisión de los recursos implementados y los permisos de acceso

Una vez completada la implementación, se crean los siguientes recursos y roles de acceso en la implementación de plantillas de ARM:

Espacio de nombres y centro de eventos de Azure Event Hubs. En esta implementación, el centro de eventos se denomina devicedata.
- Grupo de consumidores del centro de eventos. En esta implementación, el grupo de consumidores se denomina $Default.
- Emisor de datos de Azure Event Hubs. En esta implementación, el rol de emisor se denomina devicedatasender y se puede usar para proporcionar acceso al centro de eventos mediante una firma de acceso compartido (SAS). Para obtener más información sobre la autorización mediante SAS, consulte Autorización del acceso a recursos de Event Hubs mediante firmas de acceso compartido.
Área de trabajo de Health Data Services.
Servicio FHIR® de Health Data Services.
Servicio de tecnologías médicas de Health Data Services con los roles de identidad administrada asignada por el sistema:
- Para el centro de eventos, se asigna el rol Receptor de datos de Azure Events Hubs en la sección Control de acceso (IAM) del centro de eventos.
- Para el servicio FHIR, se asigna el rol Escritor de datos de FHIR en la sección Control de acceso (IAM) del servicio FHIR.

Importante

En este inicio rápido, la plantilla de ARM configura el servicio de tecnologías médicas para que funcione en el modo Crear. Se crea un recurso del paciente y un recurso del dispositivo para cada dispositivo que envía datos al servicio FHIR.

Para obtener más información sobre los tipos de resolución de servicios de tecnologías médicas Crear y Búsqueda, consulte Configurar la pestaña Destino.

Asignaciones posteriores a la implementación

Después de implementar correctamente una instancia del servicio de tecnologías médicas, deberá proporcionar asignaciones de destino de dispositivo y FHIR tanto válidas como conformes.

Para obtener más información sobre la asignación de dispositivos, consulte Información general de la asignación de dispositivos del servicio de tecnologías médicas.
Para obtener más información sobre la asignación de destino de FHIR, consulte Información general sobre la asignación de destino de FHIR.

Limpieza de recursos de Azure PowerShell

Cuando el grupo de recursos y los recursos de archivo de Bicep implementados ya no sean necesarios, elimine el grupo de recursos, que elimina los recursos del grupo de recursos.

Remove-AzResourceGroup -Name <ResourceGroupName>

Por ejemplo: Remove-AzResourceGroup -Name ArmTestDeployment

Limpieza de los recursos de la CLI de Azure

Cuando el grupo de recursos y los recursos de archivo de Bicep implementados ya no sean necesarios, elimine el grupo de recursos, que elimina los recursos del grupo de recursos.

az group delete --name <ResourceGroupName>

Por ejemplo: az group delete --resource-group ArmTestDeployment

Sugerencia

Para ver un tutorial paso a paso que le puede guiar por el proceso de creación de una plantilla de ARM, consulte Tutorial: Creación e implementación de la primera plantilla de ARM.