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

Preparing (Preparazione) AWS IoT Jobs

AWS IoT Device Management Software Package Catalog estende i AWS IoT processi tramite parametri di sostituzione e integrazione con l'indicizzazione del AWS IoT parco macchine, i gruppi di oggetti dinamici e la soluzione riservata denominata AWS IoT shadow.

Parametri di sostituzione per AWS IoT jobs

È 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, potrebbe essere necessario passare un URL di Amazon Simple Storage Service (Amazon S3), un nome della risorsa Amazon (ARN) del pacchetto software o una firma nel documento del processo tramite gli attributi della versione del pacchetto.

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

Nell'esempio seguente, è presente 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 lavoro poiché tali flag vengono compilati automaticamente con i metadati di riferimento nella versione specifica del pacchetto. Per ulteriori informazioni sugli attributi della versione del pacchetto, ad esempio per la versione predefinita del pacchetto, vedere. $default Preparazione del documento del processo e della versione del pacchetto per la distribuzione

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

Utilizzando il parametro «before-substitution» nelle API and, puoi visualizzare la risposta dell'GetJobDocumentAPI prima DescribeJob e dopo la rimozione dei parametri di sostituzione. Fai riferimento ai seguenti esempi con le API and: DescribeJob GetJobDocument

Per ulteriori informazioni su AWS IoT Jobs, sulla creazione di documenti relativi ai job e sulla distribuzione dei job, consulta Jobs. https://docs.aws.amazon.com/iot/latest/developerguide/iot-jobs.html

Preparazione del documento del processo e della versione del pacchetto per la distribuzione

Quando viene creata una versione del pacchetto, questa è in uno draft stato tale da indicare che è in fase di preparazione per la distribuzione. Per preparare la versione del pacchetto per la distribuzione, devi creare un documento di lavoro, salvarlo in una posizione accessibile al processo (come Amazon S3) e confermare che la versione del pacchetto contenga i valori degli attributi che desideri vengano utilizzati dal documento di lavoro. (Nota: puoi aggiornare gli attributi per una versione del pacchetto solo mentre è nello draft stato.)

Quando crei un AWS IoT Job o un modello Job per una distribuzione a pacchetto singolo, hai le seguenti opzioni per personalizzare il tuo documento di lavoro:

File di istruzioni di distribuzione () recipe

Artifactattributo version

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 API. UpdatePackageVersion È quindi possibile fare riferimento alla versione del pacchetto quando si crea il processo tramite la AWS IoT console o eseguendo l'operazione CreateJob API.

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

Per distribuire una versione del 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 nell'CreateJoboperazione 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 per la 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 del pacchetto aggiuntivi nel destinationPackageVersions parametro dell'operazione CreateJob API a cui non si fa riferimento nel documento di lavoro. Assicuratevi che nel documento di lavoro siano incluse le informazioni di installazione necessarie affinché i dispositivi installino correttamente le versioni aggiuntive del pacchetto software. Per ulteriori informazioni sul funzionamento dell'CreateJob API, vedere CreateJob.

Indirizzare i lavori tramite AWS IoT gruppi di 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 correnti sul pacchetto del tuo dispositivo e destinare tali elementi a un 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 un oggetto riservato denominato shadow ($package) quando il lavoro viene completato con successo. 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:

Puoi aggiungere o aggiornare una versione del pacchetto a una copia con nome riservata dell'oggetto ($package) tramite la console o l'operazione API UpdateThingShadow. Per ulteriori informazioni, consulta Associare una versione del pacchetto a un oggetto. AWS IoT

Disinstallazione di un pacchetto software e della relativa versione

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

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

L'ARN autorizzato 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"]