Tutorial: Creación de una implementación en la nube

En este inicio rápido se muestra cómo crear la primera implementación de aplicaciones basada en la nube. La implementación basada en la nube proporciona una aplicación mediante una implementación asignada a un grupo de dispositivos en el producto de destino.

En este tutorial aprenderá a:

  • Creación de un producto
  • Habilitación de la implementación basada en la nube para el dispositivo
  • Creación de la implementación
  • Implementación de desencadenador
  • Volver a habilitar el desarrollo y la depuración

Requisitos previos

Creación de un producto

Un producto identifica un modelo de Azure Sphere que realiza una función específica y ejecuta una aplicación determinada.

Si aún no dispone de un producto, cree uno mediante el comando azsphere product create.

azsphere product create --name MyProduct --description "My First Product"

Los nombres de producto deben ser únicos dentro de Azure Sphere inquilino y no distinguen mayúsculas de minúsculas. Si el nombre contiene espacios, escríbalo entre comillas dobles en los comandos, como en el ejemplo.

El comando azsphere product create crea automáticamente cinco grupos de dispositivos predeterminados para el nuevo producto: Development, Field Test, Production, Field Test OS Evaluation y Production OS Evaluation. Los grupos de dispositivos proporcionan una manera de organizar los dispositivos según cómo los use.

Habilitación de la implementación basada en la nube para el dispositivo

Antes de probar el proceso de implementación basado en la nube, el dispositivo de Azure Sphere debe estar listo para aceptar actualizaciones de aplicaciones basadas en la nube. Use el comando azsphere device enable-cloud-test para preparar el dispositivo:

azsphere device enable-cloud-test --product MyProduct

Este comando:

  • Identifica el dispositivo como el modelo MyProduct, que se creó en el paso anterior.
  • Asigna el dispositivo al grupo de dispositivos Prueba de campo, que permite actualizaciones de aplicaciones basadas en la nube.
  • Deshabilita la capacidad del SDK para cargar aplicaciones en el dispositivo, de modo que solo se puedan cargar aplicaciones basadas en la nube.

El servicio de seguridad de Azure Sphere usa el grupo de dispositivos y el producto para determinar si se debe actualizar la aplicación en el dispositivo.

Creación de la implementación

Una implementación es un conjunto de imágenes que se pueden implementar desde el servicio en la nube de Azure Sphere hasta los dispositivos de un grupo de dispositivos determinado.

Para crear una implementación:

  1. Upload el paquete de imagen al inquilino Azure Sphere mediante azsphere image add.
  2. Cree una nueva implementación para un grupo de dispositivos para las imágenes cargadas mediante azsphere device-group deployment create.
  1. Upload el paquete de imagen:
azsphere image add --image <path-to-image>

La salida debe mostrar algo parecido a lo siguiente:

Uploading image from file 'Blink.imagepackage':
 --> Image ID:       <image-ID>
 --> Component ID:   <component-ID>
 --> Component name: 'Blink'
Removing temporary state for uploaded image.
Successfully uploaded image with ID '<image-id>' and name 'Blink' to component with ID '<component-id>'.

Usará el id. de imagen en el paso siguiente.

  1. Cree una nueva implementación para un grupo de dispositivos:
azsphere device-group deployment create --device-group <device-group-ID> --images <image-ID>

o

azsphere device-group deployment create --device-group '<product-name>/<device-group-name>' --images <image-ID>

Para el producto MyProduct y la prueba de campo del grupo de dispositivos, puede usar este segundo formulario para crear la implementación fácilmente:

azsphere device-group deployment create --device-group "MyProduct/Field Test" --images <image-ID>

Para proporcionar varios valores --images para, escriba una lista de valores separados por espacios.

El --device-group parámetro identifica el grupo de dispositivos. El identificador del grupo de dispositivos proporciona un GUID, que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puede usar el nombre del producto y el par de nombres del grupo de dispositivos con el <product-name> / <device-group-name> formato . Este par de nombres identifica de manera única un grupo de dispositivos para un producto determinado.

Especifique el grupo de dispositivos Prueba de campo y el nombre del producto que creó en Crear un producto.

Reemplace <image-ID> por el identificador de imagen del paquete de imágenes que creó en Tutorial: Compilación de una aplicación de alto nivel. Para Azure Sphere cli, consulte azsphere device-group deployment create para obtener información sobre cómo obtener el identificador de imagen.

Para comprobar que la implementación está configurada, use el comando azsphere device image list-targeted.

Desencadenamiento de la implementación

Los pasos anteriores configuran todos los elementos de implementación necesarios. Para desencadenar la descarga inmediatamente, presione el botón Restablecer en el dispositivo de Azure Sphere. La aplicación debe descargarse e iniciarse dentro de unos minutos y debe ver que la LED comienza a parpadear.

Para comprobar que la aplicación se instaló en el dispositivo, use el comando azsphere device image list-installed. Es posible que no vea los resultados de la implementación inmediatamente. Si la implementación no aparece al ejecutar el comando, inténtelo de nuevo en unos minutos. El LED comenzará a parpadear en el Azure Sphere en cuanto se complete la implementación.

Volver a implementar el desarrollo y la depuración

A medida que continúe desarrollando y probando aplicaciones, quizás le interese transferirlas localmente hasta que esté listo para implementarlas de forma más general. Para invertir el comando azsphere device enable-cloud-test y habilitar el dispositivo para el desarrollo y la depuración, use azsphere device enable-development:

azsphere device enable-development

Este comando asigna el dispositivo al grupo de dispositivos de desarrollo predeterminado para su producto y agrega la funcionalidad del dispositivo para aceptar aplicaciones para la depuración. El grupo de dispositivos desarrollo no permite la carga en la nube de aplicaciones.

Pasos siguientes

Avance al siguiente artículo para obtener información sobre:

Si no está listo para compilar aplicaciones en tiempo real, es posible que también desee: