deployment

Buat atau perbarui deployment lokal menggunakan resep komponen tertentu, artefak, dan argumen waktu aktif.

Ringkasan

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>,...]

Pendapat

• --recipeDir, -r. Jalur lengkap ke folder yang berisi file resep komponen.

• --artifactDir, -a. Jalur lengkap ke folder yang berisi file artefak yang ingin Anda sertakan dalam deployment Anda. Folder artefak harus berisi struktur direktori berikut:

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

• --update-config, -c. Argumen konfigurasi untuk deployment, disediakan sebagai string JSON atau file JSON. String JSON harus dalam format berikut:

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

  MERGE dan RESET peka huruf besar-kecil dan harus dalam huruf besar.

• --groupId, -g. Grup sasaran objek untuk deployment.

• --merge, -m. Nama dan versi komponen target yang ingin Anda tambahkan atau perbarui. Anda harus memberikan informasi komponen dalam format <component>=<version>. Gunakan argumen terpisah untuk setiap komponen tambahan yang akan ditentukan. Jika diperlukan, gunakan--runWithargumen untuk memberikanposixUser,posixGroup, danwindowsUserinformasi untuk menjalankan komponen.

• --runWith. KlasterposixUser,posixGroup, danwindowsUserinformasi untuk menjalankan komponen generik atau Lambda. Anda harus memberikan informasi ini dalam format <component>:{posixUser|windowsUser}=<user>[:<=posixGroup>]. Misalnya, Anda dapat menentukanHelloWorld:posixUser=ggc_user:ggc_groupatauHelloWorld:windowsUser=ggc_user. Gunakan argumen terpisah untuk setiap opsi tambahan yang akan ditentukan.

  Untuk informasi selengkapnya, lihat Mengkonfigurasi pengguna yang menjalankan komponen.

• --systemLimits. Batas sumber daya sistem untuk diterapkan pada proses komponen Lambda generik dan non-kontainer pada perangkat inti. Anda dapat mengonfigurasi jumlah maksimum penggunaan CPU dan RAM yang dapat digunakan setiap proses komponen. Tentukan objek JSON serial atau path file ke file JSON. Objek JSON harus dalam format berikut.

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

  Anda dapat mengonfigurasi batas sumber daya berikut untuk setiap komponen:

  • cpus—Jumlah maksimum waktu CPU yang dapat digunakan proses komponen ini pada perangkat inti. Total waktu CPU perangkat inti setara dengan jumlah inti CPU perangkat. Misalnya, pada perangkat inti dengan 4 inti CPU, Anda dapat mengatur nilai ini2untuk membatasi proses komponen ini untuk 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini0.25untuk membatasi proses komponen ini untuk 25 persen penggunaan CPU. Jika Anda menetapkan nilai ini ke angka yang lebih besar dari jumlah core CPU,AWS IoT GreengrassPerangkat lunak inti tidak membatasi penggunaan CPU komponen.

  • memory—Jumlah maksimum RAM (dalam kilobyte) yang dapat digunakan proses komponen ini pada perangkat inti.

  Untuk informasi selengkapnya, lihat Mengkonfigurasi batas sumber daya sistem untuk komponen.

  Fitur ini tersedia untuk v2.4.0 dan versi yang lebih baruKomponen inti Greengrassdan Greengrass CLI pada perangkat inti Linux.AWS IoT GreengrassSaat ini tidak mendukung fitur ini pada perangkat inti Windows.

• --remove. Nama komponen target yang ingin Anda hapus dari deployment lokal. Untuk menghapus komponen yang digabung dari deployment cloud, Anda harus memberikan ID grup dari grup objek target dalam format berikut:

  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>

Output

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini.

$ 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

Ringkasan

greengrass-cli deployment list

Pendapat

Tidak ada

Output

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini. Tergantung pada status deployment Anda, output menunjukkan salah satu dari nilai status berikut: IN_PROGRESS, SUCCEEDED, atau FAILED.

$ sudo greengrass-cli deployment list

44d89f46-1a29-4044-ad89-5151213dfcbc: SUCCEEDED

Ringkasan

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

Pendapat

-i. ID deployment.

Output

Contoh berikut menunjukkan output yang dihasilkan ketika Anda menjalankan perintah ini. Tergantung pada status deployment Anda, output menunjukkan salah satu dari nilai status berikut: IN_PROGRESS, SUCCEEDED, atau FAILED.

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

44d89f46-1a29-4044-ad89-5151213dfcbc: FAILED