implementazione

Crea o aggiorna una distribuzione locale utilizzando ricette di componenti, artefatti e argomenti di runtime specifici.

Riepilogo

greengrass-cli deployment create 
    --recipeDir path/to/component/recipe
    [--artifactDir path/to/artifact/folder ]
    [--update-config {component-configuration}]
    [--groupId <thing-group>]
    [--merge "<component-name>=<component-version>"]...
    [--runWith "<component-name>:posixUser=<user-name>[:<group-name>]"]...
    [--systemLimits "{component-system-resource-limits}]"]...
    [--remove <component-name>,...]
    [--failure-handling-policy <policy name[ROLLBACK, DO_NOTHING]>]

Arguments (Argomenti)

• --recipeDir,. -r Il percorso completo della cartella che contiene i file di ricette dei componenti.

• --artifactDir,-a. Il percorso completo della cartella che contiene i file degli artefatti da includere nella distribuzione. La cartella artifacts deve contenere la seguente struttura di directory:

  /path/to/artifact/folder/<component-name>/<component-version>/<artifacts>

• --update-config,. -c Gli argomenti di configurazione per la distribuzione, forniti come stringa JSON o file JSON. La stringa JSON deve avere il seguente formato:

  { \
    "componentName": { \ 
      "MERGE": {"config-key": "config-value"}, \
      "RESET": ["path/to/reset/"] \
    } \
  }

  MERGEe RESET fanno distinzione tra maiuscole e minuscole e devono essere scritte in maiuscolo.

• --groupId,. -g Il gruppo di oggetti bersaglio per la distribuzione.

• --merge,-m. Il nome e la versione del componente di destinazione che desideri aggiungere o aggiornare. È necessario fornire le informazioni sul componente nel formato<component>=<version>. Utilizzate un argomento separato per ogni componente aggiuntivo da specificare. Se necessario, utilizzate l'--runWithargomento per fornire le windowsUser informazioni posixUserposixGroup, e per l'esecuzione del componente.

• --runWith. posixUserposixGroup, e windowsUser informazioni per l'esecuzione di un componente generico o Lambda. È necessario fornire queste informazioni nel formato<component>:{posixUser|windowsUser}=<user>[:<=posixGroup>]. Ad esempio, è possibile specificare HelloWorld:posixUser=ggc_user:ggc_group oHelloWorld:windowsUser=ggc_user. Utilizzate un argomento separato per ogni opzione aggiuntiva da specificare.

  Per ulteriori informazioni, consulta Configurare l'utente che esegue i componenti.

• --systemLimits. I limiti delle risorse di sistema da applicare ai processi dei componenti Lambda generici e non containerizzati sul dispositivo principale. È possibile configurare la quantità massima di utilizzo di CPU e RAM utilizzabile dai processi di ciascun componente. Specificate un oggetto JSON serializzato o il percorso di un file JSON. L'oggetto JSON deve avere il seguente formato.

  {  \
    "componentName": { \ 
      "cpus": cpuTimeLimit, \
      "memory": memoryLimitInKb \
    } \
  }

  È possibile configurare i seguenti limiti di risorse di sistema per ogni componente:

  • cpus— La quantità massima di tempo di CPU che i processi di questo componente possono utilizzare sul dispositivo principale. Il tempo totale della CPU di un dispositivo principale è equivalente al numero di core CPU del dispositivo. Ad esempio, su un dispositivo principale con 4 core CPU, è possibile impostare questo valore in modo da 2 limitare i processi di questo componente al 50% di utilizzo di ciascun core della CPU. Su un dispositivo con 1 core di CPU, puoi impostare questo valore 0.25 per limitare i processi di questo componente al 25 percento di utilizzo della CPU. Se imposti questo valore su un numero maggiore del numero di core della CPU, il software AWS IoT Greengrass Core non limita l'utilizzo della CPU del componente.

  • memory— La quantità massima di RAM (in kilobyte) che i processi di questo componente possono utilizzare sul dispositivo principale.

  Per ulteriori informazioni, consulta Configura i limiti delle risorse di sistema per i componenti.

  Questa funzionalità è disponibile per la versione 2.4.0 e successive del componente Greengrass nucleus e della Greengrass CLI sui dispositivi core Linux. AWS IoT Greengrass attualmente non supporta questa funzionalità sui dispositivi Windows core.

• --remove. Il nome del componente di destinazione che si desidera rimuovere da una distribuzione locale. Per rimuovere un componente che è stato unito da una distribuzione cloud, è necessario fornire l'ID di gruppo del thing group di destinazione nel seguente formato:

  Greengrass nucleus v2.4.0 and later

  --remove <component-name> --groupId <group-name>

  Earlier than v2.4.0

  --remove <component-name> --groupId thinggroup/<group-name>

  anchoranchor
  • Greengrass nucleus v2.4.0 and later
  • Earlier than v2.4.0

  --remove <component-name> --groupId <group-name>

• --failure-handling-policy. Definisce l'azione intrapresa in caso di errore di una distribuzione. È possibile specificare due azioni:

  • ROLLBACK –

  • DO_NOTHING –

  Questa funzionalità è disponibile per la versione 2.11.0 e successive di. Nucleo Greengrass

Output

L'esempio seguente mostra l'output prodotto quando si esegue questo comando.

$ sudo greengrass-cli deployment create \
    --merge MyApp1=1.0.0 \
    --merge MyApp2=1.0.0 --runWith MyApp2:posixUser=ggc_user \
    --remove MyApp3 \
    --recipeDir recipes/ \ 
    --artifactDir artifacts/

Local deployment has been submitted! Deployment Id: 44d89f46-1a29-4044-ad89-5151213dfcbc

Riepilogo

greengrass-cli deployment cancel
    -i <deployment-id>

Argomenti

-i. L'identificatore univoco della distribuzione da annullare. L'ID di distribuzione viene restituito nell'output del create comando.

Output

• Nessuno

Riepilogo

greengrass-cli deployment list

Arguments (Argomenti)

Nessuno

Output

L'esempio seguente mostra l'output prodotto quando si esegue questo comando. A seconda dello stato della distribuzione, l'output mostra uno dei seguenti valori di stato: IN_PROGRESSSUCCEEDED, oFAILED.

$ sudo greengrass-cli deployment list

44d89f46-1a29-4044-ad89-5151213dfcbc: SUCCEEDED
Created on: 6/27/23 11:05 AM

Riepilogo

greengrass-cli deployment status -i <deployment-id>

Arguments (Argomenti)

-i. L'ID della distribuzione.

Output

L'esempio seguente mostra l'output prodotto quando si esegue questo comando. A seconda dello stato della distribuzione, l'output mostra uno dei seguenti valori di stato: IN_PROGRESSSUCCEEDED, oFAILED.

$ sudo greengrass-cli deployment status -i 44d89f46-1a29-4044-ad89-5151213dfcbc

44d89f46-1a29-4044-ad89-5151213dfcbc: FAILED
Created on: 6/27/23 11:05 AM
Detailed Status: <Detailed deployment status>
Deployment Error Stack: List of error codes
Deployment Error Types: List of error types
Failure Cause: Cause