Langkah 6: Terapkan komponen Anda - AWS IoT Greengrass

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Langkah 6: Terapkan komponen Anda

Dengan AWS IoT Greengrass, Anda dapat men-deploy komponen ke perangkat individual atau grup perangkat. Saat Anda men-deploy komponen, AWS IoT Greengrass akan menginstal dan menjalankan perangkat lunak komponen tersebut pada setiap perangkat target. Anda menentukan komponen mana yang akan di-deploy dan pembaruan konfigurasi yang akan di-deploy pada setiap komponen. Anda juga dapat mengontrol bagaimana deployment mulai tersedia pada perangkat yang menjadi target deployment. Untuk informasi selengkapnya, lihat Deploy komponen AWS IoT Greengrass ke perangkat.

Di bagian ini, Anda menerapkan komponen Hello World Anda kembali ke perangkat inti Greengrass Anda.

  1. Pada menu navigasi konsol AWS IoT Greengrass tersebut, pilih Komponen.

  2. Pada halaman Components, pada tab My components, pilih com.example.HelloWorld.

  3. Pada halaman com.example.HelloWorld pilih Deploy.

  4. Dari Add to deployment, pilih Create new deployment, lalu pilih Next.

  5. Di halaman Tentukan target, lakukan hal berikut:

    1. Di kotak Nama, masukkanDeployment for MyGreengrassCore.

    2. Untuk target Deployment, pilih Perangkat inti, dan nama AWS IoT benda untuk perangkat inti Anda. Nilai default dalam tutorial ini adalah MyGreengrassCore.

    3. Pilih Berikutnya.

  6. Pada halaman Pilih komponen, di bawah Komponen saya, verifikasi bahwa com.example.HelloWorldkomponen dipilih, dan pilih Berikutnya.

  7. Pada halaman Konfigurasi komponen, pilih com.example.HelloWorld, dan lakukan hal berikut:

    1. Pilih Konfigurasi komponen.

    2. Di bawah Pembaruan konfigurasi, di Konfigurasi untuk menggabungkan, masukkan konfigurasi berikut.

      {
  "Message": "universe"
}

      Pembaruan konfigurasi ini menetapkan parameter Message Hello World ke universe untuk perangkat dalam deployment ini.

    3. Pilih Konfirmasi.

    4. Pilih Berikutnya.

  8. Pada halaman Konfigurasikan pengaturan lanjutan, simpan pengaturan konfigurasi default tersebut, dan pilih Selanjutnya.

  9. Di halaman Tinjau, pilih Deploy.

  10. Verifikasi bahwa deployment berhasil diselesaikan. Deployment ini dapat memakan waktu beberapa menit hingga selesai. Periksa log Hello World untuk memverifikasi perubahan. Jalankan perintah berikut pada perangkat inti Greengrass Anda.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait

    Anda akan melihat pesan yang mirip dengan contoh berikut ini.

    Hello, universe! Greetings from your first Greengrass component.
    catatan

    Jika pesan log tidak berubah, deployment gagal atau tidak mencapai perangkat inti. Hal ini dapat terjadi jika perangkat inti Anda tidak tersambung ke internet atau tidak memiliki izin untuk mengambil artefak dari bucket S3 Anda. Jalankan perintah berikut pada perangkat inti Anda untuk melihat berkas log perangkat inti AWS IoT Greengrass. File ini mencakup log dari layanan deployment perangkat inti Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\greengrass.log

    typePerintah menulis konten file ke terminal. Jalankan perintah ini beberapa kali untuk mengamati perubahan dalam file.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Untuk informasi selengkapnya, lihat Pemecahan masalah AWS IoT Greengrass V2.

Untuk men-deploy komponen Hello World Anda

  1. Pada komputer pengembangan Anda, buat file bernama hello-world-deployment.json dan salin JSON berikut ke dalam file. File ini menentukan komponen dan konfigurasi yang akan di-deploy.

    {
  "components": {
    "com.example.HelloWorld": {
      "componentVersion": "1.0.0",
      "configurationUpdate": {
        "merge": "{\"Message\":\"universe\"}"
      }
    }
  }
}

    File konfigurasi ini menentukan untuk men-deploy versi 1.0.0 komponen Hello World yang telah Anda kembangkan dan deploy dalam prosedur sebelumnya. configurationUpdate menentukan untuk menggabungkan konfigurasi komponen dalam string yang dikodekan JSON. Pembaruan konfigurasi ini menetapkan parameter Message Hello World ke universe untuk perangkat dalam deployment ini.

  2. Jalankan perintah berikut untuk men-deploy komponen ke perangkat inti Greengrass Anda. Anda dapat men-deploy ke objek, yang merupakan perangkat individual, atau grup objek, yang merupakan grup perangkat. Ganti MyGreengrassCoredengan nama AWS IoT benda untuk perangkat inti Anda.

    Linux or Unix
    aws greengrassv2 create-deployment \
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" \
  --cli-input-json file://hello-world-deployment.json
    Windows Command Prompt (CMD)
    aws greengrassv2 create-deployment ^
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" ^
  --cli-input-json file://hello-world-deployment.json
    PowerShell
    aws greengrassv2 create-deployment `
  --target-arn "arn:aws:iot:region:account-id:thing/MyGreengrassCore" `
  --cli-input-json file://hello-world-deployment.json

    Perintah ini menghasilkan respons yang mirip dengan contoh berikut.

    {
  "deploymentId": "deb69c37-314a-4369-a6a1-3dff9fce73a9",
  "iotJobId": "b5d92151-6348-4941-8603-bdbfb3e02b75",
  "iotJobArn": "arn:aws:iot:region:account-id:job/b5d92151-6348-4941-8603-bdbfb3e02b75"
}

  3. Verifikasi bahwa deployment berhasil diselesaikan. Deployment ini dapat memakan waktu beberapa menit hingga selesai. Periksa log Hello World untuk memverifikasi perubahan. Jalankan perintah berikut pada perangkat inti Greengrass Anda.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/com.example.HelloWorld.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\com.example.HelloWorld.log
    PowerShell
    gc C:\greengrass\v2\\logs\\com.example.HelloWorld.log -Tail 10 -Wait

    Anda akan melihat pesan yang mirip dengan contoh berikut ini.

    Hello, universe! Greetings from your first Greengrass component.
    catatan

    Jika pesan log tidak berubah, deployment gagal atau tidak mencapai perangkat inti. Hal ini dapat terjadi jika perangkat inti Anda tidak tersambung ke internet atau tidak memiliki izin untuk mengambil artefak dari bucket S3 Anda. Jalankan perintah berikut pada perangkat inti Anda untuk melihat berkas log perangkat inti AWS IoT Greengrass. File ini mencakup log dari layanan deployment perangkat inti Greengrass.

    Linux or Unix
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows Command Prompt (CMD)
    type C:\greengrass\v2\\logs\\greengrass.log

    typePerintah menulis konten file ke terminal. Jalankan perintah ini beberapa kali untuk mengamati perubahan dalam file.

    PowerShell
    gc C:\greengrass\v2\\logs\\greengrass.log -Tail 10 -Wait

    Lihat informasi yang lebih lengkap di Pemecahan masalah AWS IoT Greengrass V2.