de una implementación

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 debe tener un GUID único. Si basa la aplicación en un ejemplo Azure Sphere, recuerde 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, probablemente haya agregado esta funcionalidad con el comando azsphere device enable-development (denominado 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 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. Para obtener más información, vea deployment create.

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:

  1. Upload el paquete de imagen:

    azsphere image add --image <path-to-image>
    
  2. 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 --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.

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.

Por ejemplo:

azsphere image add --image my-app.imagepackage
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álida, una implementación debe seguir estas reglas:

  • El tamaño total de la implementación debe ser menor que 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.