Menerapkan komponen Anda ke perangkat

Untuk menerapkan komponen model dan komponen aplikasi klien ke perangkat AWS IoT Greengrass Version 2 inti, Anda menggunakan AWS IoT Greengrass V2 konsol atau menggunakan CreateDeploymentAPI. Untuk informasi selengkapnya, lihat Membuat penerapan atau di Panduan AWS IoT Greengrass Version 2Pengembang. Untuk informasi tentang memperbarui komponen yang diterapkan ke perangkat inti, lihat Merevisi penerapan.

Izin IAM untuk menyebarkan komponen

Untuk menerapkan komponen dengan AWS IoT Greengrass V2 Anda memerlukan izin berikut:

• greengrass:ListComponents

• greengrass:ListComponentVersions

• greengrass:ListCoreDevices

• greengrass:CreateDeployment

• greengrass:GetDeployment

• greengrass:ListDeployments

CreateDeploymentdan GetDeployment memiliki tindakan yang bergantung. Untuk informasi selengkapnya, lihat Tindakan yang ditentukan oleh AWS IoT Greengrass V2.

Untuk informasi tentang mengubah izin IAM, lihat Mengubah izin untuk pengguna.

Menerapkan komponen Anda (konsol)

Gunakan prosedur berikut untuk menyebarkan komponen aplikasi klien ke perangkat inti. Aplikasi klien bergantung pada komponen model (yang pada gilirannya tergantung pada Lookout for Vision Edge Agent). Menyebarkan komponen aplikasi klien juga memulai penyebaran komponen model dan Lookout for Vision Edge Agent.

catatan

Anda dapat menambahkan komponen Anda ke penerapan yang ada. Anda juga dapat menerapkan komponen ke grup sesuatu.

Untuk menjalankan prosedur ini, Anda harus memiliki perangkat AWS IoT Greengrass V2 inti yang dikonfigurasi. Untuk informasi selengkapnya, lihat Menyiapkan perangkat AWS IoT Greengrass Version 2 inti Anda.

Untuk menyebarkan komponen Anda ke perangkat

1. Buka AWS IoT Greengrass konsol di https://console.aws.amazon.com/iot/.

2. Di panel navigasi kiri, di bawah Greengrass pilih Deployments.

3. Di bawah Deployment pilih Buat.

4. Di halaman Tentukan target, lakukan hal berikut:

   1. Di bawah informasi Deployment, masukkan atau ubah nama yang ramah untuk deployment Anda.

   2. Di bawah Target Deployment, pilih Perangkat inti dan masukkan nama target.

   3. Pilih Selanjutnya.

5. Pada halaman Pilih komponen, lakukan hal berikut:

   1. Di bawah Komponen saya, pilih nama komponen aplikasi klien Anda (com.lookoutvison.EdgeAgentPythonExample).

   2. Pilih Selanjutnya

6. Pada halaman Konfigurasi komponen, pertahankan konfigurasi saat ini dan pilih Berikutnya.

7. Pada halaman Konfigurasi pengaturan lanjutan, pertahankan pengaturan saat ini dan pilih Berikutnya.

8. Pada halaman Tinjauan, pilih Deploy untuk mulai menerapkan komponen Anda.

Memeriksa status penerapan (Konsol)

Anda dapat memeriksa status penerapan Anda dari AWS IoT Greengrass V2 konsol. Jika komponen aplikasi klien Anda menggunakan contoh resep dan kode dariMembuat komponen aplikasi klien, lihat log komponen aplikasi klien setelah penerapan selesai. Jika berhasil, log menyertakan daftar model Lookout for Vision yang disebarkan ke komponen.

Untuk informasi tentang menggunakan AWS SDK untuk memeriksa status penerapan, lihat Memeriksa status penerapan.

Untuk memeriksa status penerapan

1. Buka AWS IoT Greengrass konsol di https://console.aws.amazon.com/iot/

2. Di panel navigasi kiri, pilih Perangkat inti.

3. Di bawah perangkat inti Greengrass pilih perangkat inti Anda.

4. Pilih tab Deployment untuk melihat status penerapan saat ini.

5. Setelah penerapan berhasil (status Selesai), buka jendela terminal pada perangkat inti dan lihat log komponen aplikasi klien di. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Jika penerapan Anda menggunakan contoh resep dan kode, log menyertakan output darilookoutvision_edge_agent_example.py. Misalnya:

   Model Details model_component:"ModelComponent"

Menerapkan komponen (SDK)

Gunakan prosedur berikut untuk menerapkan komponen aplikasi klien, komponen model, dan Amazon Lookout for Vision Edge Agent ke perangkat inti Anda.

1. Buat deployment.json file untuk menentukan konfigurasi deployment untuk komponen Anda. File ini akan terlihat seperti contoh berikut.

   {
     "targetArn":"targetArn",
     "components": {
       "com.lookoutvison.EdgeAgentPythonExample": {
         "componentVersion": "1.0.0",
         "configurationUpdate": {
         }
       }
     }
   }

   • Di kolom targetArn, ganti targetArn dengan Amazon Resource Name (ARN) dari grup objek atau objek yang ditargetkan untuk deployment tersebut, dalam format berikut:

     • Objek: arn:aws:iot:region:account-id:thing/thingName

     • Grup objek: arn:aws:iot:region:account-id:thinggroup/thingGroupName

2. Periksa apakah target penerapan memiliki penerapan yang sudah ada yang ingin Anda revisi. Lakukan hal berikut:

   1. Jalankan perintah berikut untuk membuat daftar penerapan untuk target penyebaran. Ganti targetArn dengan Amazon Resource Name (ARN) dari grup hal atau benda AWS IoT target. Untuk mendapatkan ARN dari hal-hal di Wilayah AWS saat ini, gunakan perintahaws iot list-things.

      aws greengrassv2 list-deployments --target-arn targetArn

      Tanggapan berisi daftar dengan deployment terbaru untuk target. Jika responsnya kosong, target tidak memiliki penerapan yang ada, dan Anda dapat melompat ke Langkah 3. Jika tidak, salin deploymentId dari respons untuk digunakan pada langkah berikutnya.

   2. Jalankan perintah berikut untuk mendapatkan detail penerapan. Detail ini mencakup metadata, komponen, dan konfigurasi pekerjaan. Ganti deploymentId dengan ID dari langkah sebelumnya.

      aws greengrassv2 get-deployment --deployment-id deploymentId

   3. Salin salah satu pasangan nilai kunci berikut dari respons perintah sebelumnya ke deployment.json. Anda dapat mengubah nilai-nilai ini untuk penerapan baru.

      • deploymentName— Nama penyebaran.

      • components— Komponen penyebaran. Untuk menghapus komponen, hapus dari objek ini.

      • deploymentPolicies— Kebijakan penyebaran.

      • tags— Tag penyebaran.

3. Jalankan perintah berikut untuk menyebarkan komponen pada perangkat. Perhatikan nilai deploymentId dalam respon.

   aws greengrassv2 create-deployment \
       --cli-input-json file://path/to/deployment.json

4. Jalankan perintah berikut untuk mendapatkan status penyebaran. Ubah deployment-id ke nilai yang Anda catat di langkah sebelumnya. Penerapan telah selesai dengan sukses jika nilainya adalah. deploymentStatus COMPLETED

   aws greengrassv2 get-deployment --deployment-id deployment-id

5. Setelah penerapan berhasil, buka jendela terminal pada perangkat inti dan lihat log komponen aplikasi klien di. /greengrass/v2/logs/com.lookoutvison.EdgeAgentPythonExample.log Jika penerapan Anda menggunakan contoh resep dan kode, log menyertakan output darilookoutvision_edge_agent_example.py. Misalnya:

   Model Details model_component:"ModelComponent"