Creación de una implementación
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).
Para implementar las aplicaciones desde la nube, cargue las imágenes de las aplicaciones en el inquilino de Azure Sphere y cree una implementación para distribuir las imágenes a los 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.
Nota:
Cada componente de una implementación de debe tener un GUID único. Si la aplicación se basa en un ejemplo de Azure Sphere, no olvide crear un GUID único para la aplicación antes de crear una implementación para evitar posibles conflictos.
Preparación de los 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 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:
azsphere product create --name <product-name>
Reemplace <product-name> por un nombre para el producto, como DW100. Consulte azsphere product para más información sobre este comando.
Las implementaciones se dirigen a los grupos de dispositivos, por lo que también necesita asignar sus dispositivos a un grupo de dispositivos que permite las actualizaciones en la nube antes de poder recibir las 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 azsphere device-group show.
Los dispositivos también se deben preparar para la carga en la nube, lo que significa que no cuentan con la funcionalidad appDevelopment. Cuando se envían desde fábrica, los dispositivos no tienen esta funcionalidad. Sin embargo, si ha usado un dispositivo para el desarrollo de aplicaciones, es probable que haya agregado esta funcionalidad con el comando azsphere device enable-development (denominada azsphere device prep-debug en versiones preliminares anteriores del SDK).
Para quitar la funcionalidad, use azsphere device enable-cloud-test:
azsphere device enable-cloud-test --device-group <device-group-ID> or '<product-name>/<device-group-name>'
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. Para obtener más información, consulte Creación de implementación.
Creación de una implementación para un grupo de dispositivos
Las implementaciones pueden contener aplicaciones y configuraciones de paneles y ambas se administran de la misma manera cuando se crea una implementación. Las implementaciones son conjuntos de imágenes que se van a distribuir a todos los dispositivos de un grupo de dispositivos. 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.
Para crear una implementación:
Cargue el paquete de imágenes:
azsphere image add --image <path-to-image> --regional-data-boundary <value>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 '<product-name>/<device-group-name>' --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.
El --images parámetro proporciona el identificador de imagen del archivo de paquete de imagen para la aplicación. La imagen se carga en el inquilino actual.
El --regional-data-boundary parámetro especifica el límite de datos regional de esta imagen. Los valores permitidos son EU y None. El valor predeterminado es None. Si no se especifica ningún valor, se usará el valor predeterminado.
Por ejemplo:
azsphere image add --image my-app.imagepackage --regional-data-boundary "None"
azsphere device-group deployment create --device-group "DW100/Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc
Reglas para una implementación válida
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.
Actualizar una implementación
Para actualizar una implementación, use los comandos azsphere image add y azsphere device-group deployment create de nuevo, como se describe en la sección anterior y especifique la ruta de acceso al archivo de aplicación actualizado.