Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Nozioni di base su Software Package Catalog
È possibile creare e gestire il AWS IoT Device Management Software Package Catalog tramite le Console di gestione AWS operazioni AWS IoT Core API e AWS Command Line Interface (AWS CLI).
**Nota**
L'abilitazione dell'indicizzazione AWS IoT della flotta è un requisito per utilizzare Software Package Catalog. Le operazioni di base, come la creazione di una versione del pacchetto software nel comando API Console di gestione AWS e l'utilizzo del comando `CreatePackage` API, avranno esito negativo senza l'indicizzazione del AWS IoT parco veicoli abilitata.
Per ulteriori informazioni sull'utilizzo dell'indicizzazione del AWS IoT parco veicoli con Software Package Catalog, vedere. [Preparazione dell'indicizzazione del parco istanze](preparing-fleet-indexing.md)
**Utilizzo della console**
Per utilizzare il Console di gestione AWS, accedi al tuo AWS account e vai a. [AWS IoT Core](https://console.aws.amazon.com/iot/home) Nel riquadro di navigazione, scegli **Pacchetti software**. Quindi, puoi creare e gestire i pacchetti e le relative versioni da questa sezione.
**Utilizzo delle operazioni API o CLI**
È possibile utilizzare le operazioni AWS IoT Core API per creare e gestire le funzionalità del Software Package Catalog. Per ulteriori informazioni, consulta [AWS IoT API Reference AWS](https://docs.aws.amazon.com/iot/latest/apireference/) [SDKs and Toolkits](https://aws.amazon.com/developer/tools/). I AWS CLI comandi gestiscono anche il tuo catalogo. Per ulteriori informazioni, consulta la pagina di [Riferimento ai comandi CLI AWS IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).
**Topics**
+ [Creazione di un pacchetto software e di una versione del pacchetto](creating-package-and-version.md)
+ [Distribuzione di una versione del pacchetto tramite job AWS IoT](deploying-package-version.md)
+ [Associare una versione del pacchetto a un oggetto AWS IoT](associating-package-version.md)
# Creazione di un pacchetto software e di una versione del pacchetto
Puoi utilizzare i seguenti passaggi per creare un pacchetto e un oggetto della versione iniziale tramite la Console di gestione AWS.
**Per creare un pacchetto software**
1. Accedi al tuo AWS account e accedi alla [AWS IoT console](https://console.aws.amazon.com/iot/home).
1. Nel riquadro di navigazione, scegli **Pacchetti software**.
1. Nella pagina del **pacchetto software AWS IoT **, scegli **Crea pacchetto**. Viene visualizzata la finestra di dialogo **Abilita dipendenze per la gestione dei pacchetti**.
1. In **Indicizzazione del parco istanze**, seleziona **Aggiungi pacchetti software del dispositivo e versione**. Ciò è richiesto per Software Package Catalog e fornisce l'indicizzazione del parco istanze e i parametri relativi al parco istanze.
1. [Facoltativo] Se desideri che i AWS IoT job aggiornino lo shadow denominato riservato quando i lavori vengono completati correttamente, seleziona **Aggiorna automaticamente le ombre dai lavori**. Se non desideri che i AWS IoT lavori effettuino questo aggiornamento, lascia questa casella di controllo deselezionata.
1. [Facoltativo] Per concedere ai AWS IoT lavori il diritto di aggiornare l'ombra denominata riservata, in **Seleziona ruolo**, scegli **Crea** ruolo. Se non desideri che i AWS IoT lavori effettuino questo aggiornamento, questo ruolo non è obbligatorio.
1. Crea o seleziona un ruolo.
1. Se **non disponi di un ruolo** per questo scopo: quando viene visualizzata la finestra di dialogo **Crea ruolo**, inserisci un **Nome di ruolo**, quindi scegli **Crea**.
1. Se **disponi di un ruolo** per questo scopo: in **Seleziona ruolo**, scegli il ruolo, quindi assicurati che la casella di controllo **Collega policy al ruolo IAM** sia selezionata.
1. Scegli **Conferma**. Viene visualizzata la pagina **Crea nuovo pacchetto**.
1. In **Dettagli del pacchetto**, inserisci un **Nome del pacchetto**.
1. In **Descrizione pacchetto**, inserisci le informazioni per facilitare l'identificazione e la gestione di questo pacchetto.
1. [Facoltativo] Puoi usare i tag per facilitare la classificazione e la gestione di questo pacchetto. Per aggiungere tag, espandi **Tag**, scegli **Aggiungi tag** e inserisci una coppia chiave-valore. Puoi inserire fino a 50 tag. Per ulteriori informazioni, consulta [Taggare le AWS IoT risorse](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**Per aggiungere una versione del pacchetto durante la creazione di un nuovo pacchetto**
1. In **Versione iniziale**, inserisci un **nome per la versione**.
Ti consigliamo di utilizzare il [SemVer formato](https://semver.org/) (ad esempio,`1.0.0.0`) per identificare in modo univoco la versione del pacchetto. Puoi anche utilizzare una strategia di formattazione diversa più appropriata per il tuo caso d'uso. Per ulteriori informazioni, consulta [Ciclo di vita della versione del pacchetto](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. In **Descrizione versione**, inserisci le informazioni per facilitare l'identificazione e la gestione di questa versione del pacchetto.
**Nota**
La casella di controllo **Versione predefinita** è disattivata perché le versioni dei pacchetti vengono create in uno stato `draft`. È possibile assegnare un nome alla versione predefinita dopo aver creato la versione del pacchetto e quando si modifica lo stato in`published`. Per ulteriori informazioni, consulta [Ciclo di vita della versione del pacchetto](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. [Facoltativo] Per semplificare la gestione di questa versione o per comunicare informazioni ai dispositivi, inserisci una o più coppie nome-valore per **Attributi di versione**. Scegli **Aggiungi attributo** per ciascuna coppia nome-valore inserita. Per ulteriori informazioni, consulta [Attributi della versione](preparing-to-use-software-package-catalog.md#version-attributes).
1. [Facoltativo] Puoi usare i tag per facilitare la classificazione e la gestione di questo pacchetto. Per aggiungere tag, espandi **Tag**, scegli **Aggiungi tag** e inserisci una coppia chiave-valore. Puoi inserire fino a 50 tag. Per ulteriori informazioni, consulta [Taggare le AWS IoT risorse](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. Scegli **Next (Successivo)**.
**Associare la distinta base del software a una versione del pacchetto (opzionale)**
1. Al **Passaggio 3: Versione SBOMs (opzionale)** nella finestra **delle configurazioni SBOM**, scegliete il formato di file SBOM predefinito e la modalità di convalida utilizzati per convalidare la distinta base del software prima che venga associata alla versione del pacchetto.
1. Nella finestra **Aggiungi file SBOM**, inserisci l'Amazon Resource Name (ARN) che rappresenta la tua versione del bucket Amazon S3 e il formato di file SBOM preferito se il tipo predefinito non funziona.
**Nota**
Puoi aggiungere un singolo file SBOM o un singolo file zip contenente più SBOMs di una distinta software per la versione del pacchetto.
1. Nella finestra **Aggiunto file SBOM**, è possibile visualizzare il file SBOM aggiunto per la versione del pacchetto.
1. Scegli **Crea** pacchetto e versione. Viene visualizzata la pagina della versione del pacchetto e puoi vedere lo stato di convalida del tuo file SBOM nella finestra Aggiungi file **SBOM**. Lo stato iniziale sarà quello in cui il file SBOM viene `In progress` sottoposto a convalida.
**Nota**
Gli stati di convalida del file SBOM sono`Invalid file`,,,`Not started`, `In progress` e i motivi dell'errore di convalida. `Validated (SPDX)` `Validated (CycloneDX)`
# Distribuzione di una versione del pacchetto tramite job AWS IoT
Puoi utilizzare la procedura seguente per distribuire una versione del pacchetto tramite la Console di gestione AWS.
**Prerequisiti:**
Prima di iniziare, esegui queste attività:
+ Registra AWS IoT le cose con AWS IoT Core. Per indicazioni su come aggiungere i dispositivi AWS IoT Core, consulta [Creare un oggetto](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Facoltativo] Crea un AWS IoT gruppo di oggetti o un gruppo di oggetti dinamico per indirizzare i dispositivi su cui distribuirai la versione del pacchetto. Per istruzioni su come creare un gruppo di oggetti, consulta [Creazione di un gruppo di oggetti statico](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Per istruzioni su come creare un gruppo di oggetti dinamico, consulta [Creazione di un gruppo di oggetti dinamico](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Crea un pacchetto software e una versione del pacchetto. Per ulteriori informazioni, consulta [Creazione di un pacchetto software e di una versione del pacchetto](creating-package-and-version.md).
+ Crea un documento del processo. Per ulteriori informazioni, consulta [Preparazione del documento del processo e della versione del pacchetto per l'implementazione](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).
**Per distribuire un lavoro AWS IoT**
1. Sulla [console AWS IoT](https://console.aws.amazon.com/iot/home), scegli **Pacchetti software**.
1. Scegli il pacchetto software che desideri distribuire. Viene visualizzata la pagina dei **dettagli del pacchetto software**.
1. Scegli la versione del pacchetto che desideri distribuire, in **Versioni**, e scegli **Distribuisci versione del processo.**
1. Se è la prima volta che distribuisci un processo tramite questo portale, viene visualizzata una finestra di dialogo che descrive i requisiti. Rivedi le informazioni e scegli **Accetta**.
1. Inserisci un nome per l'implementazione o lascia il nome generato automaticamente nel campo **Nome**.
1. [Facoltativo] Nel campo **Descrizione**, inserisci una descrizione che identifica lo scopo o i contenuti dell'implementazione o lascia le informazioni generate automaticamente.
**Nota:** si consiglia di non utilizzare informazioni personali di identificazione nel nome del processo e nei campi di descrizione.
1. [Facoltativo] Aggiungi eventuali tag da associare a questo processo.
1. Scegli **Next (Successivo)**.
1. In **Destinazioni del processo**, scegli gli oggetti o i gruppi di oggetti che devono ricevere il processo.
1. Nel campo **File del processo**, specifica il file JSON del documento del processo.
1. Apri **Integrazione dei processi con il servizio Package Catalog**.
1. Seleziona i pacchetti e le versioni specificati all'interno del documento del processo.
**Nota**
Ti viene richiesto di scegliere gli stessi pacchetti e le stesse versioni dei pacchetti specificati nel documento del processo. Puoi includerne altri, ma il processo fornirà istruzioni solo per i pacchetti e le versioni inclusi nel documento del processo. Per ulteriori informazioni, consulta [Denominazione di pacchetti e versioni durante l'implementazione](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).
1. Scegli **Next (Successivo)**.
1. Nella pagina Configurazione del processo, seleziona uno dei seguenti tipi di processo nella finestra di dialogo Configurazione del processo:
+ **Snapshot job** (Processo snapshot): un processo snapshot viene completato quando termina la sua esecuzione su dispositivi e gruppi di destinazione.
+ **Continuous job** (Processo continuo): un processo continuo si applica ai gruppi di oggetti e viene eseguito su qualsiasi dispositivo aggiunto successivamente a un gruppo di destinazione specificato.
1. Nella finestra di dialogo **Configurazioni aggiuntive - opzionale**, esamina le seguenti configurazioni del processo opzionali ed esegui le selezioni di conseguenza. Per ulteriori informazioni, consulta [Configurazioni di rollout, pianificazione e interruzione dei processi](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) e [Configurazioni di timeout e di nuovo tentativo di esecuzione del processo](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry).
+ Rollout configuration (Configurazione rollout)
+ Scheduling configuration (Configurazione della pianificazione)
+ Job executions timeout configuration (Configurazione del timeout di esecuzioni dei processi)
+ Configurazione dei tentativi delle esecuzioni dei processi
+ Configurazione dell’interruzione
1. Esamina le selezioni del processo e scegli **Invia**.
Dopo aver creato il processo, la console genera una firma JSON e la inserisce nel documento di processo. È possibile utilizzare la AWS IoT console per visualizzare lo stato di un lavoro oppure annullarlo o eliminarlo. Per gestire i processi, vai all'[Hub di processo della console](https://console.aws.amazon.com/iot/home#/jobhub).
# Associare una versione del pacchetto a un oggetto AWS IoT
Dopo aver installato il software sul dispositivo, è possibile associare una versione del pacchetto a un AWS IoT oggetto denominato shadow riservato. Se i AWS IoT job sono stati configurati per aggiornare il named shadow riservato dell'oggetto dopo che il job è stato distribuito e completato con successo, non è necessario completare questa procedura. Per ulteriori informazioni, consulta [Copia shadow con nome riservata](preparing-to-use-software-package-catalog.md#reserved-named-shadow).
**Prerequisiti:**
Prima di iniziare, esegui queste attività:
+ Crea una o AWS IoT più cose e stabilisci la telemetria tramite. AWS IoT Core Per ulteriori informazioni, consulta [Guida introduttiva](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html). AWS IoT Core
+ Crea un pacchetto software e una versione del pacchetto. Per ulteriori informazioni, consulta [Creazione di un pacchetto software e di una versione del pacchetto](creating-package-and-version.md).
+ Installa il software della versione del pacchetto sul dispositivo.
**Nota**
L'associazione di una versione del pacchetto a un AWS IoT elemento non comporta l'aggiornamento o l'installazione del software sul dispositivo fisico. La versione del pacchetto deve essere distribuita sul dispositivo.
**Associare una versione del pacchetto a un oggetto AWS IoT**
1. Nel riquadro di navigazione della [console AWS IoT](https://console.aws.amazon.com/iot/home), espandi il menu **Tutti i dispositivi** e scegli **Oggetti**.
1. Identifica l' AWS IoT elemento che desideri aggiornare dall'elenco e scegli il nome dell'oggetto per visualizzarne la pagina dei dettagli.
1. Nella sezione **Dettagli**, scegli **Pacchetti e versioni**.
1. Scegli **Aggiungi al pacchetto e alla versione**.
1. In **Scegli un pacchetto di dispositivi**, seleziona il pacchetto software desiderato.
1. In **Scegli una versione**, seleziona la versione del software desiderata.
1. Scegli **Aggiungi pacchetto di dispositivi**.
Il pacchetto e la versione vengono visualizzati nell'elenco **Pacchetti e versioni selezionate**.
1. Ripeti questi passaggi per ogni pacchetto e versione che desideri associare a questo oggetto.
1. Al termine, scegli **Aggiungi pacchetto e dettagli della versione**. Viene visualizzata la pagina **Dettagli dell'oggetto** in cui è possibile visualizzare il nuovo pacchetto e la nuova versione nell'elenco.