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

Artículo
11/22/2023

Bicep es un lenguaje específico del dominio (DSL) que usa sintaxis declarativa para implementar recursos de Azure. En un archivo Bicep, defina la infraestructura que desea implementar en Azure y, a continuación, use ese archivo durante todo el ciclo de vida de desarrollo para implementar repetidamente la infraestructura. Sus recursos se implementan de forma coherente. Bicep ofrece sintaxis concisa, seguridad de tipos confiable y compatibilidad con la reutilización de código. Bicep ofrece la mejor experiencia de creación para sus soluciones de infraestructura como código en Azure.

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 un archivo Bicep.

Sugerencia

Para más información sobre Bicep, consulte ¿Qué es Bicep?

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 la CLI de Azure.
- Para Azure PowerShell, instale la CLI de Bicep para implementar el archivo de Bicep que se usa en este inicio rápido.

Cuando cumpla con estos requisitos previos, estará listo para implementar el archivo Bicep.

Revisión del archivo de Bicep

El archivo Bicep 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 main.bicep en GitHub.

Guardar una copia local del archivo Bicep

Guarde una copia local del archivo Bicep como main.bicep. Debe tener el directorio de trabajo de Azure PowerShell o la consola de la CLI de Azure apuntando a la ubicación donde se guarda este archivo.

Implementación del servicio de tecnologías médicas con el archivo Bicep 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 de la copia local guardada del archivo main.bicep.

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 BicepTestDeployment -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 el archivo Bicep:
```
New-AzResourceGroupDeployment -ResourceGroupName <ResourceGroupName> -TemplateFile main.bicep -basename <BaseName> -location <AzureRegion>
```
Por ejemplo: New-AzResourceGroupDeployment -ResourceGroupName BicepTestDeployment -TemplateFile main.bicep -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 con el archivo Bicep 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 de la copia local guardada del archivo main.bicep.

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 BicepTestDeployment --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 el archivo Bicep:
```
az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=<BaseName> location=<AzureRegion>
```
Por ejemplo: az deployment group create --resource-group BicepTestDeployment --template-file main.bicep --parameters basename=abc location=southcentralus
Importante

Si va a permitir el acceso desde varios servicios al centro de eventos de mensajes de dispositivo, 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 del archivo Bicep:

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.
- Rol 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 de dispositivo mediante una firma de acceso compartido (SAS). Para 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 más información sobre la asignación de dispositivos, consulte Introducción a la asignación de dispositivos.
Para más información sobre la asignación de destinos de FHIR, consulte Introducción a la asignación de destinos de FHIR.

Limpieza de los recursos implementados con Azure PowerShell

Cuando el grupo de recursos y los recursos del archivo Bicep implementados ya no sean necesarios, elimine el grupo de recursos, lo cual eliminará los recursos del grupo de recursos.

Remove-AzResourceGroup -Name <ResourceGroupName>

Por ejemplo: Remove-AzResourceGroup -Name BicepTestDeployment

Limpieza de los recursos implementados con la CLI de Azure

Cuando el grupo de recursos y los recursos del archivo Bicep implementados ya no sean necesarios, elimine el grupo de recursos, lo cual eliminará los recursos del grupo de recursos.

az group delete --name <ResourceGroupName>

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

Sugerencia

Para obtener un tutorial detallado que le guíe en el proceso de creación de un archivo de Bicep, consulte Compilación de la primera plantilla de Bicep:

Pasos siguientes

Elección de un método de implementación para el servicio de tecnologías médicas

Información general sobre las fases de procesamiento de datos de dispositivos del servicio de tecnologías médicas

Preguntas más frecuentes sobre el servicio de tecnologías médicas

Nota:

FHIR® es una marca registrada de HL7 y se usa con su permiso.