Crear una implementación

Para implementar las aplicaciones desde la nube, cargue las imágenes de la aplicación en el catálogo 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 haber iniciado sesión en Azure y debe tener los permisos RBAC adecuados concedidos. 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 una muestra de Azure Sphere, recuerde crear un GUID único para la aplicación antes de crear una implementación para evitar posibles conflictos.

Preparar 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 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:

az sphere product create --resource-group MyResourceGroup --catalog MyCatalog --name MyProduct --description MyDescription

Reemplace <MyProduct> por un nombre para el producto, como DW100. Consulte az sphere product para obtener más información sobre este comando.

Las implementaciones tienen como destino grupos de dispositivos, por lo que también tendrás que asignar los dispositivos a un grupo de dispositivos que habilite las actualizaciones en la nube para que puedan recibir las 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 también deben estar preparados para la carga en la nube, lo que significa que no tienen la funcionalidad appDevelopment . Cuando se envían desde fábrica, los dispositivos no tienen esta capacidad. Sin embargo, si ha usado un dispositivo para el desarrollo de aplicaciones, probablemente haya agregado esta funcionalidad con el comando az sphere device enable-development .

Para quitar la funcionalidad, use az sphere device enable-cloud-test:

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

Para obtener más información, vea Creación de implementación.

Crear una implementación para un grupo de dispositivos

Las implementaciones pueden contener configuraciones de placa y aplicaciones, y ambas se controlan de la misma manera al crear una implementación. Las implementaciones son conjuntos de imágenes que se van a distribuir a todos los dispositivos dentro de un grupo de dispositivos. 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.

Para crear una implementación:

  1. Cargue el paquete de imagen:

    az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path <path-to-image> --regional-data-boundary <value>
    
  2. Crear una nueva implementación para un grupo de dispositivos:

    az sphere deployment create --resource-group MyResourceGroup --catalog MyCatalog --product <product-name> --device-group <device-group-ID> --images <image-ID>
    

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

El --images parámetro proporciona el id. de imagen del archivo de paquete de imagen para la aplicación. La imagen se carga en el catálogo actual.

El --regional-data-boundary parámetro especifica el límite de datos regional para 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 (algunos parámetros eliminados por brevedad):

az sphere image add --image my-app.imagepackage --regional-data-boundary "None"
az sphere deployment create --product "DW100" --device-group "Field Test" --images e3769536-dc4b-48d9-afd4-22ed321ba4bc

Reglas para una implementación válida

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.

Actualizar una implementación

Para actualizar una implementación, utilice az sphere image add y az sphere deployment create commands de nuevo, como se describe en la sección anterior, y especifique la ruta de acceso al archivo de aplicación actualizado.