Add image

This workflow allows you to upload a new application image to a catalog. Application images can be added to a catalog and used in a deployment. Images are distributed to devices in the device group associated with a deployment.

Use the portal

1. Sign in to the Azure Portal. To locate the Azure Sphere service, in the top search bar, enter and select Azure Sphere. The Azure Sphere page is displayed.
2. Select a catalog name from the list. Ensure your subscription filter is set appropriately to see all catalogs and resource groups.
3. Select Manage > Images in the menu on the left side of the page.
4. Click Add from the menu at the top of the page.
5. Select the search box or file icon to browse to a local destination on your computer to add the image file. Only files with the extension .imagepackage is accepted.
6. Optionally specify any regional data boundary restrictions. Data boundary restrictions allow image use only in specified regions. Possible region restrictions are EU or None (the default).
7. Click Add.

Use the CLI

Use the az sphere image add command.

az sphere image add --resource-group MyResourceGroup --catalog MyCatalog --image-path myImage.imagepackage

Tip

We recommend that you configure the default values for the subscription, resource group, and catalog parameters. This helps reduce redundancy and can significantly shorten CLI command syntax.

Unless you have set the active subscription, the --subscription parameter will be required for all commands. You can set the active subscription using the command az account set --subscription <subscription-name>.