Buat AWS IoT Greengrass komponen

Jika Anda belum melakukannya, instal CLI GDK di komputer pengembangan Anda. Untuk informasi selengkapnya, lihat Instal atau perbarui Antarmuka AWS IoT Greengrass Baris Perintah Kit Pengembangan.

Ubah ke folder tempat Anda ingin membuat folder komponen.

Pilih template komponen atau komponen komunitas untuk diunduh. CLI GDK mengunduh template atau komponen komunitas, sehingga Anda dapat memulai dari contoh fungsional. Gunakan perintah daftar komponen untuk mengambil daftar template yang tersedia atau komponen komunitas.

• Untuk daftar template komponen, jalankan perintah berikut. Setiap baris dalam respons mencakup nama template dan bahasa pemrograman.

  gdk component list --template

• Untuk daftar komponen komunitas, jalankan perintah berikut.

  gdk component list --repository

Buat dan ubah ke folder komponen tempat CLI GDK mengunduh templat atau komponen komunitas. Ganti HelloWorlddengan nama komponen, atau nama lain yang membantu Anda mengidentifikasi folder komponen ini.

Unduh template atau komponen komunitas ke folder saat ini. Gunakan perintah komponen init.

• Untuk membuat folder komponen dari template, jalankan perintah berikut. Ganti HelloWorlddengan nama template, dan ganti python dengan nama bahasa pemrograman.

  gdk component init --template HelloWorld --language python

• Untuk membuat folder komponen dari komponen komunitas, jalankan perintah berikut. Ganti ComponentNamedengan nama komponen komunitas.

  gdk component init --repository ComponentName

CLI GDK membaca dari file konfigurasi CLI GDK, gdk-config.json bernama, untuk membangun dan menerbitkan komponen. File konfigurasi ini ada di root folder komponen. Langkah sebelumnya membuat file ini untuk Anda. Pada langkah ini, Anda memperbarui gdk-config.json dengan informasi tentang komponen Anda. Lakukan hal-hal berikut:

1. Buka gdk-config.json di editor teks.

2. (Opsional) Ubah nama komponen. Nama komponen adalah kunci dalam component objek.

3. Ubah penulis komponen.

4. (Opsional) Ubah versi komponen. Tentukan satu dari yang berikut ini:

   • NEXT_PATCH— Saat Anda memilih opsi ini, CLI GDK menetapkan versi saat Anda mempublikasikan komponen. CLI GDK menanyakan layanan AWS IoT Greengrass untuk mengidentifikasi versi komponen terbaru yang diterbitkan. Kemudian, ia menetapkan versi ke versi patch berikutnya setelah versi itu. Jika Anda belum mempublikasikan komponen sebelumnya, CLI GDK menggunakan versi. 1.0.0

     Jika Anda memilih opsi ini, Anda tidak dapat menggunakan CLI Greengrass untuk menyebarkan dan menguji komponen secara lokal ke komputer pengembangan lokal Anda yang menjalankan perangkat lunak Core. AWS IoT Greengrass Untuk mengaktifkan penerapan lokal, Anda harus menentukan versi semantik sebagai gantinya.

   • Versi semantik, seperti. 1.0.0 Versi semantik menggunakan mayor. kecil. sistem penomoran tambalan. Untuk informasi lebih lanjut, lihat spesifikasi versi semantik.

     Jika Anda mengembangkan komponen pada perangkat inti Greengrass tempat Anda ingin menerapkan dan menguji komponen, pilih opsi ini. Anda harus membangun komponen dengan versi tertentu untuk membuat penerapan lokal dengan CLI Greengrass.

5. (Opsional) Ubah konfigurasi build untuk komponen. Konfigurasi build mendefinisikan bagaimana CLI GDK membangun sumber komponen menjadi artefak. Pilih dari opsi berikut untukbuild_system:

   • zip— Paket folder komponen ke dalam file ZIP untuk didefinisikan sebagai satu-satunya artefak komponen. Pilih opsi ini untuk jenis komponen berikut:

     • Komponen yang menggunakan bahasa pemrograman yang ditafsirkan, seperti JavaScript Python atau.

     • Komponen yang mengemas file selain kode, seperti model pembelajaran mesin atau sumber daya lainnya.

     CLI GDK meritsleting folder komponen ke dalam file zip dengan nama yang sama dengan folder komponen. Misalnya, jika nama folder komponen adalahHelloWorld, CLI GDK membuat file zip bernama. HelloWorld.zip

     catatan

     Jika Anda menggunakan GDK CLI versi 1.0.0 pada perangkat Windows, folder komponen dan nama file zip harus berisi hanya huruf kecil.

     Ketika CLI GDK meritsleting folder komponen ke dalam file zip, ia melewatkan file-file berikut:

     • File gdk-config.json

     • File resep (recipe.jsonataurecipe.yaml)

     • Membangun folder, seperti greengrass-build

   • maven— Menjalankan mvn clean package perintah untuk membangun sumber komponen menjadi artefak. Pilih opsi ini untuk komponen yang menggunakan Maven, seperti komponen Java.

     Pada perangkat Windows, fitur ini tersedia untuk GDK CLI v1.1.0 dan yang lebih baru.

   • gradle— Menjalankan gradle build perintah untuk membangun sumber komponen menjadi artefak. Pilih opsi ini untuk komponen yang menggunakan Gradle. Fitur ini tersedia untuk GDK CLI v1.1.0 dan yang lebih baru.

     Sistem gradle build mendukung Kotlin DSL sebagai file build. Fitur ini tersedia untuk GDK CLI v1.2.0 dan yang lebih baru.

   • gradlew— Menjalankan gradlew perintah untuk membangun sumber komponen menjadi artefak. Pilih opsi ini untuk komponen yang menggunakan Gradle Wrapper.

     Fitur ini tersedia untuk GDK CLI v1.2.0 dan yang lebih baru.

   • custom— Menjalankan perintah khusus untuk membangun sumber komponen menjadi resep dan artefak. Tentukan perintah khusus dalam custom_build_command parameter.

6. Jika Anda menentukan custom untukbuild_system, tambahkan custom_build_command ke build objek. Dalamcustom_build_command, tentukan satu string atau daftar string, di mana setiap string adalah kata dalam perintah. Misalnya, untuk menjalankan perintah build kustom untuk komponen C++, Anda dapat menentukan["cmake", "--build", "build", "--config", "Release"].

7. Jika Anda menggunakan GDK CLI v1.1.0 atau yang lebih baru, Anda dapat menentukan argumen untuk menentukan --bucket bucket S3 tempat CLI GDK mengunggah artefak komponen. Jika Anda tidak menentukan argumen ini, CLI GDK akan mengunggah ke bucket S3 yang namanya, di mana bucket dan region bucket-region-accountId adalah nilai yang Anda tentukangdk-config.json, dan accountID adalah ID Anda. Akun AWS CLI GDK membuat bucket jika tidak ada.

   Ubah konfigurasi publikasi untuk komponen. Lakukan hal-hal berikut:

   1. Tentukan nama bucket S3 yang akan digunakan untuk meng-host artefak komponen.

   2. Tentukan Wilayah AWS tempat CLI GDK menerbitkan komponen.

Ketika Anda selesai dengan langkah ini, gdk-config.json file mungkin terlihat mirip dengan contoh berikut.

{
  "component": {
    "com.example.PythonHelloWorld": {
      "author": "Amazon",
      "version": "NEXT_PATCH",
      "build": {
        "build_system" : "zip"
      },
      "publish": {
        "bucket": "greengrass-component-artifacts",
        "region": "us-west-2"
      }
    }
  },
  "gdk_version": "1.0.0"
}

Perbarui file resep komponen, bernama recipe.yaml ataurecipe.json. Lakukan hal-hal berikut:

1. Jika Anda mengunduh templat atau komponen komunitas yang menggunakan sistem zip build, periksa apakah nama artefak zip cocok dengan nama folder komponen. CLI GDK meritsleting folder komponen ke dalam file zip dengan nama yang sama dengan folder komponen. Resep berisi nama artefak zip dalam daftar artefak komponen dan skrip siklus hidup yang menggunakan file dalam artefak zip. Perbarui Artifacts dan Lifecycle definisi sedemikian rupa sehingga nama file zip cocok dengan nama folder komponen. Contoh resep parsi berikut menyoroti nama file zip dalam Lifecycle definisi Artifacts dan.

   JSON

   {
     ...
     "Manifests": [
       {
         "Platform": {
           "os": "all"
         },
         "Artifacts": [
           {
             "URI": "s3://{COMPONENT_NAME}/{COMPONENT_VERSION}/HelloWorld.zip",
             "Unarchive": "ZIP"
           }
         ],
         "Lifecycle": {
           "run": "python3 -u {artifacts:decompressedPath}/HelloWorld/main.py {configuration:/Message}"
         }
       }
     ]
   }

   YAML

   ---
   ...
   Manifests:
     - Platform:
         os: all
       Artifacts:
         - URI: "s3://BUCKET_NAME/COMPONENT_NAME/COMPONENT_VERSION/HelloWorld.zip"
           Unarchive: ZIP
       Lifecycle:
         run: "python3 -u {artifacts:decompressedPath}/HelloWorld/main.py {configuration:/Message}"

2. (Opsional) Perbarui deskripsi komponen, konfigurasi default, artefak, skrip siklus hidup, dan dukungan platform. Untuk informasi selengkapnya, lihat AWS IoT Greengrass referensi resep komponen.

Setelah selesai dengan langkah ini, file resep mungkin terlihat mirip dengan contoh berikut.

Kembangkan dan bangun komponen Greengrass. Perintah build komponen menghasilkan resep dan artefak di greengrass-build folder di folder komponen. Jalankan perintah berikut.

gdk component build

Buat folder untuk komponen Anda dengan subfolder untuk resep dan artefak. Jalankan perintah berikut pada perangkat inti Greengrass Anda untuk membuat folder ini dan mengubah ke folder komponen. Ganti ~/greengrassv2 atau %USERPROFILE%\ greengrassv2 dengan path ke folder yang akan digunakan untuk pengembangan lokal.

Gunakan editor teks untuk membuat file resep yang mendefinisikan metadata, parameter, dependensi, siklus hidup, dan kemampuan platform komponen Anda. Sertakan versi komponen dalam nama file resep agar Anda dapat mengidentifikasi resep yang mencerminkan versi komponen. Anda dapat memilih format YAML atau JSON untuk resep Anda.

Misalnya, pada sistem berbasis Linux, Anda dapat menjalankan perintah berikut untuk menggunakan GNU nano untuk membuat file.

Tentukan resep untuk komponen Anda. Untuk informasi selengkapnya, lihat AWS IoT Greengrass referensi resep komponen.

Resep Anda mungkin terlihat serupa dengan contoh resep Hello World berikut.

Resep ini menjalankan skrip Hello World Python, yang mungkin terlihat mirip dengan contoh skrip berikut.

import sys

message = "Hello, %s!" % sys.argv[1]

# Print the message to stdout, which Greengrass saves in a log file.
print(message)

Buat folder untuk versi komponen yang akan dikembangkan. Kami merekomendasikan agar Anda menggunakan folder terpisah untuk setiap versi komponen artefak agar Anda dapat mengidentifikasi artefak untuk setiap versi komponen. Jalankan perintah berikut.

artifacts/componentName/componentVersion/

Buat artefak untuk komponen Anda di folder yang Anda buat di langkah sebelumnya. Artefak dapat mencakup perangkat lunak, gambar, dan biner lain yang menggunakan komponen Anda.

Ketika komponen Anda sudah siap, uji komponen Anda.