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à.

Preparazione dei lavori AWS IoT

AWS IoT Device Management Software Package Catalog estende AWS IoT Jobs tramite parametri di sostituzione e integrazione con l'indicizzazione AWS IoT della flotta, i gruppi di oggetti dinamici e il nome shadow riservato dell' AWS IoT oggetto.

Parametri di sostituzione per i lavori AWS IoT

È possibile utilizzare i parametri di sostituzione come segnaposto all'interno del documento di lavoro. AWS IoT Quando il servizio del processo rileva un parametro di sostituzione, indirizza il processo a un attributo della versione software con nome per il valore del parametro. Puoi utilizzare questo processo per creare un singolo documento del processo e passare i metadati al processo tramite attributi di uso generico. Ad esempio, puoi inserire un Amazon Simple Storage Service (Amazon S3)URL, un pacchetto software Amazon Resource Name (ARN) o una firma nel documento di lavoro tramite gli attributi della versione del pacchetto.

I parametri di sostituzione devono essere formattati nel documento di lavoro come segue:

Nell'esempio seguente, esiste un pacchetto software denominato samplePackage e ha una versione del pacchetto denominata 2.1.5 con i seguenti attributi:

Per s3URL, il parametro del documento del processo è scritto come segue:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
}

Per signature, il parametro del documento del processo è scritto come segue:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
}

Il documento del processo completo è scritto come segue:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
      },
    ],
    "signature": [
      "samplePackage" : "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
    ]
  }
}

Dopo aver effettuato la sostituzione, nei dispositivi viene distribuito il seguente documento del processo:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile"
      },
    ],
    "signature": [
      "samplePackage" : "aaaaabbbbbcccccdddddeeeeefffffggggghhhhhiiiiijjjj"
    ]
  }
}

Parametri di sostituzione (visualizzazione prima e dopo)

I parametri di sostituzione semplificano la creazione di un documento di lavoro utilizzando vari flag, ad esempio per la versione predefinita del pacchetto. $default Ciò elimina la necessità di inserire manualmente i metadati della versione specifica del pacchetto per ogni distribuzione del processo, poiché tali flag vengono riempiti automaticamente con i metadati di riferimento nella versione specifica del pacchetto. Per ulteriori informazioni sugli attributi della versione del pacchetto, ad esempio $default per la versione predefinita del pacchetto, vedere. Preparazione del documento del processo e della versione del pacchetto per l'implementazione

In AWS Management Console, attiva il pulsante Anteprima della sostituzione nella finestra dell'editor del file di istruzioni di distribuzione durante la distribuzione di un lavoro per una versione del pacchetto per visualizzare il documento del lavoro con e senza i parametri di sostituzione.

Utilizzando il parametro «before-substitution» in e GetJobDocumentAPIs, è possibile visualizzare la risposta prima DescribeJob e dopo la rimozione dei parametri di sostituzione. API Fate riferimento ai seguenti esempi con e: DescribeJob GetJobDocument APIs

Per ulteriori informazioni sui AWS IoT lavori, sulla creazione di documenti di lavoro e sulla distribuzione dei lavori, consulta Jobs.

Preparazione del documento del processo e della versione del pacchetto per l'implementazione

Quando viene creata una versione del pacchetto, è in uno draft stato tale da indicare che è in fase di preparazione per la distribuzione. Per preparare la versione del pacchetto per la distribuzione, è necessario creare un documento di lavoro, salvare il documento in una posizione accessibile al processo (ad esempio Amazon S3) e confermare che la versione del pacchetto abbia i valori degli attributi che si desidera utilizzare nel documento di lavoro. (Nota: puoi aggiornare gli attributi per una versione del pacchetto solo mentre è nello draft stato.)

Quando si crea un AWS IoT Job o un modello di Job per una distribuzione a pacchetto singolo, sono disponibili le seguenti opzioni per personalizzare il documento di lavoro:

File di istruzioni di distribuzione () recipe

Artifactattributo di versione

Versione del pacchetto

Quando sei soddisfatto della versione del pacchetto, pubblicala tramite la pagina dei dettagli del pacchetto software nella AWS IoT console o eseguendo l'operazione. UpdatePackageVersionAPI È quindi possibile fare riferimento alla versione del pacchetto quando si crea il processo tramite la AWS IoT console o eseguendo l'CreateJobAPIoperazione.

Assegnazione di un nome ai pacchetti e alle versioni durante la distribuzione

Per distribuire la versione di un pacchetto software su un dispositivo, verificate che il pacchetto software e la versione del pacchetto a cui si fa riferimento nel documento di lavoro corrispondano al pacchetto software e alla versione del pacchetto indicati nel destinationPackageVersions parametro dell'operazione. CreateJob API Se non corrispondono, riceverai un messaggio di errore che ti chiederà di far corrispondere entrambi i riferimenti. Per ulteriori informazioni sui messaggi di errore del Software Package Catalog, vedereMessaggi di errore generali sulla risoluzione dei problemi.

Oltre ai pacchetti software e alle versioni dei pacchetti a cui si fa riferimento nel documento di lavoro, è possibile includere pacchetti software e versioni di pacchetto aggiuntivi nel destinationPackageVersions parametro dell'CreateJobAPIoperazione non referenziata nel documento del lavoro. Assicuratevi che nel documento di lavoro siano incluse le informazioni di installazione necessarie affinché i dispositivi installino correttamente le versioni dei pacchetti software aggiuntivi. Per ulteriori informazioni sull'CreateJob APIoperazione, vedere CreateJob.

Indirizzazione dei lavori tramite gruppi di AWS IoT oggetti dinamici

Software Package Catalog funziona con l'indicizzazione del parco istanze, i processi di AWS IoT e i gruppi di oggetti dinamici AWS IoT per filtrare e definire i dispositivi all'interno del parco istanze per selezionare la versione del pacchetto da distribuire nei dispositivi. Puoi eseguire una query di indicizzazione del parco veicoli in base alle informazioni sulla confezione corrente del tuo dispositivo e indirizzare tali elementi per un determinato lavoro. AWS IoT Puoi anche rilasciare aggiornamenti software, ma solo per i dispositivi di destinazione idonei. Ad esempio, puoi specificare che desideri distribuire una configurazione solo sui dispositivi che attualmente eseguono iot-device-client 1.5.09. Per ulteriori informazioni, consulta Creazione di un gruppo di oggetti dinamico.

Copia shadow con nome riservata e versioni dei pacchetti

Se configurato, AWS IoT Jobs può aggiornare il nome riservato di un oggetto denominato shadow ($package) quando il processo viene completato correttamente. In tal caso, non occorre associare manualmente una versione del pacchetto alla copia shadow con nome riservata di un oggetto.

Puoi scegliere di associare o aggiornare manualmente una versione del pacchetto alla copia shadow con nome riservata dell'oggetto nelle seguenti situazioni:

È possibile aggiungere o aggiornare una versione del pacchetto alla proprietà riservata denominata shadow ($package) di un oggetto tramite la console o l'operazione. UpdateThingShadowAPI Per ulteriori informazioni, vedete Associare una versione del pacchetto a un AWS IoT oggetto.

Disinstallazione di un pacchetto software e della relativa versione del pacchetto

$nullè un segnaposto riservato che richiede al servizio AWS IoT Jobs di rimuovere il pacchetto software e la versione del pacchetto esistenti dall'ombra denominata riservata del dispositivo. $package Per ulteriori informazioni, consulta Copia shadow con nome riservata.

Per utilizzare questa funzionalità, sostituisci il nome della versione alla fine di destinationPackageVersionAmazon Resource Name (ARN) con$null. Successivamente, devi indicare al tuo servizio di rimuovere il software dal dispositivo.

L'autorizzato ARN utilizza il seguente formato:

arn:aws:iot:<regionCode>:111122223333:package/<packageName>/version/$null

Ad esempio,

$ aws iot create-job \
    ... \
    --destinationPackageVersions ["arn:aws:iot:us-east-1:111122223333:package/samplePackage/version/$null"]