Migrar de la CLI clásica a la CLI de Azure Sphere
Si todavía usa la CLI clásica de Azure Sphere, le recomendamos que migre a la nueva CLI de Azure Sphere. Actualmente, ambas versiones de la CLI se pueden instalar y usar en paralelo, pero la CLI clásica ya no se actualiza ni se mantiene y se quitará del SDK en una fecha futura (no antes de finales de 2022). Le recomendamos que se familiarice con estas diferencias y migre sus procesos y scripts antes de finales de 2022 para evitar interrupciones.
Para actualizar al SDK más reciente, consulte Instalar azure Sphere SDK en Linux o Instalar un SDK de Azure Sphere para Windows.
Para usar la CLI de Azure Sphere en Windows, use PowerShell o un símbolo del sistema estándar de Windows. Para Linux, use cualquier shell de comandos. Para obtener más información, consulte Ejecutar la CLI de Azure Sphere.
En Windows, el símbolo del sistema para desarrolladores personalizados de Azure Sphere Classic (disponible como acceso directo en el menú Inicio en Azure Sphere) solo se puede usar con la CLI clásica de Azure Sphere. Para obtener más información, consulte Ejecutar la CLI clásica de Azure Sphere.
Diferencias clave
En la CLI clásica de Azure Sphere, se pueden usar varios parámetros para identificar cada tipo de objeto. En la CLI de Azure Sphere, se usa un parámetro único para identificar cada tipo de objeto. Esto significa que puede usar el nombre o id. para especificar el valor del parámetro. Esto se ha implementado para los
--device
parámetros ,--tenant
,--product
y--device-group
.Tipo de objeto Azure Sphere CLI CLI clásica de Azure Sphere (retirada) Dispositivo --device
--deviceid
,--deviceip
o bien--devicelocation
Grupo de dispositivos --device-group
--devicegroupid
O--devicegroupname
Producto --product
--productid
O--productname
Inquilino --tenant
--tenantid
La versión clásica admite un formulario breve para los comandos. En la CLI de Azure Sphere, le recomendamos que use la característica interactiva o finalización de tabulación para ver la lista de comandos disponibles. Por ejemplo, en la CLI clásica, puede usar cualquiera
azsphere device enable-development
deazsphere dev edv
los comandos, mientras que en la nueva CLI de Azure Sphere puede usar autocompletar para escribir rápidamente elazsphere device enable-development
comando.Algunos comandos permiten varios valores para un único parámetro. En la CLI de Azure Sphere puede proporcionar un parámetro único seguido de una lista de valores separados por espacios y, en la CLI clásica de Azure Sphere, la lista de valores se separa con comas. Por ejemplo:
azsphere image-package pack-application --package-directory myDirectory --destination myImagePackage --executables filepath-1 filepath-2
En la nueva CLI, el inquilino predeterminado no se selecciona automáticamente cuando se crea un inquilino. Tiene que ejecutar el comando azsphere tenant select para seleccionar el inquilino predeterminado que se usará para el usuario actual en el equipo. Esto es para garantizar que el espacio empresarial predeterminado sea el correcto al realizar una operación de pago único que no se puede deshacer como reclamar el dispositivo.
Al usar scripts, puede seleccionar el inquilino predeterminado con el
--tenant <tenant ID or tenant name>
parámetro.Establezca el inquilino predeterminado al principio del script con:
azsphere tenant select --tenant <tenant ID or tenant name>
También puede sobrescribir el inquilino predeterminado o especificar el inquilino necesario al ejecutar el comando. Por ejemplo:
azsphere get-support-data --destination logs.zip --tenant <tenant ID or tenant name>
-
El
--device-group
parámetro identifica el grupo de dispositivos. El id. de grupo de dispositivos proporciona un GUID, que identifica de forma única el grupo de dispositivos en todos los productos. Como alternativa, puedes usar el nombre del producto y el par de nombres de grupo de dispositivos en el <formato product-name>/<device-group-name> . Este par de nombres identifica de forma única un grupo de dispositivos para un producto determinado. Los siguientes comandos eran comandos compuestos en la CLI clásica. Esto significa que un comando ha realizado varias tareas. En la nueva CLI necesita ejecutar los dos comandos.
En la CLI clásica, el comando azsphere device-group deployment create cargó el paquete de imagen y creó una nueva implementación.
En la nueva CLI, debe:
- Cargue el paquete de imágenes en su inquilino de Azure Sphere usando azsphere image add.
- Cree una nueva implementación para un grupo de dispositivos para las imágenes cargadas con azsphere device-group deployment create.
En la CLI clásica, el comando azsphere device capability download --select downloaded and temporarily selected device capability configuration for the attached device.
En la nueva CLI, debe:
- Descargue el archivo de funcionalidad mediante la descarga de capacidad del dispositivo azsphere.
- Seleccione la funcionalidad mediante la selección de funcionalidad de dispositivo azsphere.
En la CLI clásica, azsphere device capability download --apply command downloaded and applied the device capability configuration for the attached device.
En la nueva CLI, debe:
- Descargue el archivo de funcionalidad mediante la descarga de capacidad del dispositivo azsphere.
- Aplique la funcionalidad mediante la actualización de la funcionalidad del dispositivo azsphere.
En la CLI clásica, el
-o
parámetro o--output
se usa para especificar una ruta de acceso y un nombre de archivo en los que guardar un archivo. En la nueva CLI de Azure Sphere, se usan parámetros específicos del contexto como--destination
especificar rutas de entrada y salida.En la CLI clásica, el
-d
parámetro o--debug
se utiliza en el comando azsphere device app start para iniciar la aplicación en modo de depuración. En la nueva CLI de Azure Sphere, el--debug-mode
parámetro se usa para iniciar la aplicación en modo de depuración y el--debug
parámetro se usa como parámetro global para aumentar el nivel de detalle de registro para mostrar todos los registros de depuración.En la CLI clásica no hay ningún control sobre el formato de salida. En la CLI de Azure Sphere, el
-o
parámetro o--output
se usa para especificar el formato de salida en el que se debe dar formato a la salida de la CLI.Desde la versión 21.02 en adelante, los números de versión explícita se han quitado de los nombres de producto de la CLI de Azure Sphere. Este cambio elimina la confusión al hacer referencia a las diferentes versiones del producto.
- Azure Sphere CLI v2 y versiones posteriores ahora se denominan solo "Azure Sphere CLI".
- Las versiones anteriores de la CLI de Azure Sphere (CLI v1 e inferior) ahora se denominan "CLI clásica de Azure Sphere".
Si usa scripts, es posible que no sean compatibles con la nueva CLI de Azure Sphere debido a las diferencias explicadas anteriormente. Realice las actualizaciones necesarias para que los scripts se ejecuten correctamente en la nueva CLI.