Crear 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 los dispositivos de Azure Sphere. Para crear una implementación, debe haber iniciado sesión en Azure Sphere y debe tener el rol de administrador. Además, los dispositivos deben estar preparados para recibir implementaciones en la nube.

Para ser válida, 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.

Preparar dispositivos

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

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

Usar el portal

    • 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 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 desde 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 SO de prueba de campo, Producción y Evaluación del SO de producción.
  6. Por último, haga clic en Crear en la parte inferior de la página.

Si elegiste no crear un grupo de dispositivos predeterminado, debe crearse manualmente un grupo de dispositivos y asociarlo al producto:

  1. Selecciona 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. Selecciona el producto creado a partir de los pasos anteriores.
  4. Escribe un nombre para el grupo de dispositivos y una breve descripción.
  5. Seleccione la fuente de sistema operativo (SO) para el grupo de dispositivos. La fuente RetailEval recibe versiones preliminares del sistema operativo antes de la fuente Retail . Por lo tanto, retailEval no se recomienda para dispositivos de producción. Seleccione La fuente comercial para dispositivos de producción.
  6. Selecciona la directiva de actualización para el grupo de dispositivos. UpdateAll significa que los dispositivos del grupo recibirán actualizaciones del sistema operativo y de las aplicaciones cuando estén disponibles. No3rdPartyAppUpdates significa que los dispositivos del grupo solo recibirán actualizaciones del sistema operativo.

Usar la CLI

Propina

Le recomendamos que configure 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 az sphere product create comando.

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

Usa el az sphere device-group create comando para crear un grupo de dispositivos y asociarlo con el 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 se dirigen a grupos de dispositivos. Los dispositivos tendrán que asignarse a un grupo de dispositivos que tenga habilitadas las actualizaciones en la nube para 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 SO de prueba de campo y Evaluación del SO de producción. Puede usar uno de estos grupos de dispositivos o crear uno propio. 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 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:

Usar la CLI

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

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

Crear una implementación para un grupo de dispositivos

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

Usar el portal

    • 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 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 en la lista. Selecciona el producto para el que quieres crear una implementación.
  5. Una tabla muestra todos los grupos de dispositivos asociados con el producto elegido. Selecciona el grupo de dispositivos para el que quieres 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.

Usar la CLI

Completa los pasos de Preparar dispositivos antes de continuar y, a continuación:

  1. Cargue un paquete de imagen, tomando nota del imageId devuelto por el comando:

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

  2. Usa el azsphere image-package show comando para obtener el imageId del paquete de imagen:

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

    Nota

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

    El comando devuelve información sobre el paquete de imagen, incluido el id. de imagen:

    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. Crear 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 de identificadores de imagen separados por espacios.

Para enumerar los grupos de dispositivos en 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, debe crearse una nueva implementación. Repita los pasos de la sección anterior y actualice los parámetros cuando sea necesario.