Tutorial: Creación de una implementación en la nube
Importante
Esta es la documentación de Azure Sphere (heredado). Azure Sphere (heredado) se retira el 27 de septiembre de 2027 y los usuarios deben migrar a Azure Sphere (integrado) en este momento. Use el selector de versiones situado encima de la TOC para ver la documentación de Azure Sphere (integrado).
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:
- Crear un producto
- Habilitación de la implementación basada en la nube para el dispositivo
- Creación de la implementación
- Implementación del desencadenador
- Volver a habilitar el desarrollo y la depuración
Requisitos previos
- El dispositivo de Azure Sphere está conectado al equipo y a Internet.
- Ha completado el Tutorial: Compilar una aplicación de alto nivel y tener un archivo de paquete de imagen para la aplicación.
Crear un producto
Un producto identifica un modelo de dispositivo 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 en el inquilino de Azure Sphere y no distinguen mayúsculas de minúsculas. Si el nombre contiene espacios, escríbalo entre comillas dobles en 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, Field Test OS Evaluation y Production OS Evaluation. Los grupos de dispositivos proporcionan una manera de organizar los dispositivos de acuerdo con cómo los usa.
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 De prueba de campo, que habilita las actualizaciones de aplicaciones basadas en la nube.
- Deshabilita la capacidad de que el SDK cargue 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:
- Cargue el paquete de imágenes en el inquilino de Azure Sphere mediante azsphere image add.
- Cree una nueva implementación para un grupo de dispositivos para las imágenes cargadas mediante azsphere device-group deployment create.
- Cargue el paquete de imágenes:
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 identificador de imagen en el paso siguiente.
- 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 el grupo de dispositivos Field Test, 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 para --images especificar 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 nombre del grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de manera única un grupo de dispositivos para un producto determinado.
Especifique el grupo de dispositivos De 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 la CLI de Azure Sphere, 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 dispositivo de Azure Sphere tan pronto como se complete la implementación.
Pasos siguientes
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.
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:
- Explore los ejemplos de Azure Sphere en GitHub.
- Más información sobre los conceptos básicos de implementación de Azure Sphere
Solución de problemas
Si tiene problemas con las operaciones anteriores, consulte la guía de solución de problemas.