Compartir a través de

Creación de una implementación en la nube

  • Artículo

Para implementar las aplicaciones desde la nube, cargue imágenes de aplicación en un catálogo de Azure Sphere y cree una implementación para distribuir imágenes a dispositivos de Azure Sphere. Para crear una implementación, debe iniciar sesión en Azure Sphere y debe tener el rol Administrador. Además, los dispositivos deben estar preparados para recibir implementaciones en la nube.

Para que sea válido, una implementación debe seguir estas reglas:

  • El tamaño total de la implementación debe ser inferior a 1 MiB.
  • La implementación no puede tener más de un archivo de configuración de placa.

Preparación de dispositivos

Para que los dispositivos puedan recibir aplicaciones de la nube, deben tener un producto y pertenecer a un grupo de dispositivos y no pueden tener instalada la funcionalidad AppDevelopment.

Si aún no ha creado un producto para los dispositivos, deberá hacerlo antes de poder crear una implementación. Para crear un producto:

Uso del portal

  1. Inicie sesión en Azure Portal. Para buscar el servicio Azure Sphere, en la barra de búsqueda superior, escriba y seleccione Azure Sphere. Se muestra la página de Azure Sphere.
  2. Seleccione el catálogo en el que desea crear una implementación. Asegúrese de que el filtro de suscripción está configurado correctamente para ver todos los catálogos y grupos de recursos.
  3. Seleccione Administrar>productos en el lado izquierdo de la página del catálogo.
  4. Haga clic en + Crear en la parte superior de la página del catálogo.
  5. Escriba un nombre y una descripción para el producto. Marque la casilla para indicar si se deben crear grupos de dispositivos predeterminados. Si se marca, se crearán los siguientes grupos de dispositivos predeterminados: Desarrollo, Prueba de campo, Evaluación del sistema operativo de prueba de campo, Producción, Evaluación del sistema operativo de producción.
  6. Por último, haga clic en Crear en la parte inferior de la página.

Si decide no crear grupos de dispositivos predeterminados, se debe crear manualmente un grupo de dispositivos y asociarlo al producto:

  1. Seleccione Administrar>grupos de dispositivos en el lado izquierdo de la página.
  2. Haga clic en + Crear en la parte superior de la página.
  3. Seleccione el producto creado en los pasos anteriores.
  4. Escriba un nombre para el grupo de dispositivos y una breve descripción.
  5. Seleccione la fuente del sistema operativo (SO) para el grupo de dispositivos. La fuente RetailEval recibe versiones del sistema operativo de versión preliminar antes de la fuente Retail . Por lo tanto, no se recomienda RetailEval para dispositivos de producción. Seleccione la fuente Retail para dispositivos de producción.
  6. Seleccione la directiva de actualización para el grupo de dispositivos. UpdateAll significa que los dispositivos del grupo tomarán actualizaciones del sistema operativo y de la aplicación cuando estén disponibles. No3rdPartyAppUpdates significa que los dispositivos del grupo solo tomarán actualizaciones del sistema operativo.

Uso de la CLI

Sugerencia

Se recomienda configurar los valores predeterminados para los parámetros de suscripción, grupo de recursos y catálogo. Esto ayuda a reducir la redundancia y puede acortar significativamente la sintaxis de comandos de la CLI.

A menos que haya establecido la suscripción activa, el --subscription parámetro será necesario para todos los comandos. Puede establecer la suscripción activa mediante el comando az account set --subscription <subscription-name>.

Use el comando az sphere product create.

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog  --name MyProduct --description "My new product"

Use el az sphere device-group create comando para crear un grupo de dispositivos y asociarlo al producto.

az sphere device-group create --resource-group MyResourceGroup --catalog MyCatalog   --name "My Development Device Group" --product MyProduct -d "development device group for MyProduct"

Las implementaciones tienen como destino los grupos de dispositivos. Los dispositivos deberán asignarse a un grupo de dispositivos que tenga habilitadas las actualizaciones en la nube antes de que los dispositivos puedan recibir aplicaciones implementadas. De forma predeterminada, cada producto tiene cinco grupos de dispositivos: Producción, Prueba de campo, Desarrollo, Evaluación del sistema operativo de prueba de campo y Evaluación del sistema operativo de producción. Puede usar uno de estos grupos de dispositivos o crear unos propios. Para averiguar si un grupo de dispositivos acepta actualizaciones en la nube, use az sphere device-group show.

Los dispositivos del grupo de dispositivos deben estar preparados para la carga en la nube. Esto significa que no deben tener la funcionalidad appDevelopment . Los dispositivos enviados directamente desde la fábrica normalmente no tienen la funcionalidad appDevelopment . La funcionalidad se agrega cuando se usa el comando az sphere device enable-development.

Para quitar la funcionalidad appDevelopment, use az sphere device enable-cloud-test:

Uso de la CLI

Use el comando az sphere device enable-cloud-test.

az sphere device enable-cloud-test --resource-group MyResourceGroup --catalog MyCatalog

Creación de una implementación para un grupo de dispositivos

Las implementaciones son conjuntos de imágenes que se van a distribuir a todos los dispositivos de un grupo de dispositivos. Una implementación puede contener tanto aplicaciones como configuraciones de placa. Cada implementación se vincula a un grupo de dispositivos específico dentro de un producto específico. Debe incluir el nombre del producto y el nombre del grupo de dispositivos (como se muestra en el ejemplo siguiente) o el identificador del grupo de dispositivos al crear la implementación.

Uso del portal

  1. Inicie sesión en Azure Portal. Para buscar el servicio Azure Sphere, en la barra de búsqueda superior, escriba y seleccione Azure Sphere. Se muestra la página de Azure Sphere.
  2. Seleccione el catálogo en el que desea crear una implementación. Asegúrese de que el filtro de suscripción está configurado correctamente para ver todos los catálogos y grupos de recursos.
  3. Seleccione Administrar>productos en el lado izquierdo de la página.
  4. En la página siguiente se muestra una tabla con todos los productos creados enumerados. Seleccione el producto para el que desea crear una implementación.
  5. En una tabla se muestran todos los grupos de dispositivos asociados al producto elegido. Seleccione el grupo de dispositivos para el que desea crear una implementación.
  6. Seleccione la pestaña Implementaciones .
  7. Haga clic en +Crear debajo de la pestaña Implementaciones.
  8. En la vista que aparece, seleccione y la imagen existente o haga clic en +Agregar para cargar una nueva imagen.
  9. En la parte inferior de la vista, haga clic en +Crear.

Uso de la CLI

Complete los pasos descritos en Preparación de dispositivos antes de continuar y, a continuación, siga estos pasos:

  1. Cargue un paquete de imagen y tome nota del valor imageId devuelto por el comando :

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

  2. Use el azsphere image-package show comando para obtener el imageId del paquete de imágenes:

    azsphere image-package show --image-package myImage.imagepackage

    Nota:

    image-package show actualmente no se admite en la extensión de la CLI de Azure.

    El comando devuelve información sobre el paquete de imágenes, incluido imageId:

    Image package metadata:
  Section: Identity
   Image Type: Application
   Component ID: 1689d8b2-c835-2e27-27ad-e894d6d15fa9
   Image ID: be3f90bd-849f-487e-a170-7fe1ff03fe2d
  Section: Signature
   Signing Type: ECDsa256
   Cert: a8d5cc6958f48710140d7a26160fc1cfc31f5dfO
  Section: Debug 
   Image Name:       myImage
   Built On (UTC):   02/21/22 16:21:58
   Built On (Local): 02/21/22 16:21:58
  Section: Temporary Image

  3. Cree una nueva implementación para un grupo de dispositivos:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product MyProduct --device-group MyDeviceGroup --images <imageId returned from previous step>

Se pueden proporcionar varias imágenes al --images parámetro mediante una lista separada por espacios de identificadores de imagen.

Para enumerar los grupos de dispositivos de un catálogo, use az sphere device-group list.

Para enumerar todas las imágenes de un catálogo, use az sphere image list.

Actualizar una implementación

No es posible actualizar una implementación. En su lugar, se debe crear una nueva implementación. Repita los pasos de la sección anterior y actualice los parámetros cuando sea necesario.