Men-deploy grup (konsol)Men-deploy grup (API)Ringkasan tentang model objek grup Lihat juga

Deploy AWS IoT Greengrass kelompok untuk AWS IoT Greengrass inti

Gunakan AWS IoT Greengrass grup untuk mengatur entitas di lingkungan tepi Anda. Anda juga menggunakan grup untuk mengontrol cara entitas dalam grup berinteraksi satu sama lain dan dengan AWS Cloud. Sebagai contoh, hanya fungsi Lambda di dalam grup yang di-deploy untuk berjalan secara lokal, dan hanya perangkat di dalam grup yang dapat berkomunikasi menggunakan server MQTT lokal.

Grup harus menyertakan inti, yang merupakan AWS IoT perangkat yang menjalankan perangkat lunak AWS IoT Greengrass Core. Inti bertindak sebagai gateway tepi dan menyediakan AWS IoT Core kemampuan di lingkungan tepi. Bergantung pada kebutuhan bisnis Anda, Anda juga dapat menambahkan entitas berikut ke grup:

Perangkat klien. Diwakili sebagai hal-hal dalam AWS IoT registri. Perangkat ini harus menjalankan FreeRTOS atau menggunakan AWS IoT Device SDK atau AWS IoT Greengrass Discovery API untuk mendapatkan informasi koneksi untuk inti. Hanya perangkat klien yang merupakan anggota grup yang dapat terhubung ke inti.
Fungsi lambda. User-defined aplikasi tanpa server yang menjalankan kode pada inti. Fungsi lambda ditulis AWS Lambda dan direferensikan dari grup Greengrass. Untuk informasi selengkapnya, lihat Jalankan fungsi Lambda di AWS IoT Greengrass inti.
Konektor. Aplikasi serverless standar yang menjalankan kode pada core. Konektor dapat menyediakan integrasi bawaan dengan infrastruktur lokal, protokol perangkat AWS, dan layanan cloud lainnya. Untuk informasi selengkapnya, lihat Integrasikan dengan layanan dan protokol menggunakan konektor Greengrass.
Langganan. Mendefinisikan penerbit, pelanggan, dan topik MQTT (atau mata pelajaran) yang berwenang untuk komunikasi MQTT.
Sumber daya. Referensi ke perangkat dan volume lokal, model machine learning, dan rahasia, digunakan untuk kontrol akses oleh fungsi Lambda Greengrass dan konektor.
Log. Konfigurasi logging untuk komponen AWS IoT Greengrass sistem dan fungsi Lambda. Untuk informasi selengkapnya, lihat Pemantauan dengan AWS IoT Greengrass log.

Anda mengelola grup Greengrass Anda di AWS Cloud dan kemudian menyebarkannya ke inti. Salinan deployment konfigurasi grup untuk file group.json pada perangkat core. File ini terletak di greengrass-root/ggc/deployments/group.

Definisi cloud dari grup Greengrass di-deploy ke perangkat core.

catatan

Selama deployment, proses Greengrass daemon pada perangkat core berhenti lalu dimulai kembali.

Menyebarkan grup dari AWS IoT konsol

Anda dapat menyebarkan grup dan mengelola penerapannya dari halaman konfigurasi grup di AWS IoT konsol.

catatan

Untuk membuka halaman ini di konsol, pilih perangkat Greengrass, lalu Grup (V1), lalu di bawah grup Greengrass, pilih grup Anda.

Untuk menerapkan versi grup saat ini

Dari halaman konfigurasi grup, pilih Deplo y.

Untuk melihat riwayat penerapan grup

Riwayat deployment grup mencakup tanggal dan waktu, versi grup, dan status setiap upaya deployment.

Dari halaman konfigurasi grup, pilih tab Deployments.
Untuk melihat informasi selengkapnya tentang penerapan, termasuk pesan kesalahan, pilih Penerapan dari AWS IoT konsol, di bawah perangkat Greengrass.

Untuk menyebarkan ulang penerapan grup

Anda mungkin ingin men-deploy ulang deployment jika deployment saat ini gagal atau kembali ke versi grup yang berbeda.

Dari AWS IoT konsol, pilih perangkat Greengrass, lalu pilih Grup (V1).
Pilih tab Deployments.
Pilih penerapan yang ingin Anda gunakan kembali dan pilih Re deploy.

Untuk mengatur ulang penerapan grup

Anda mungkin ingin mengatur ulang deployment grup untuk memindahkan atau menghapus grup atau untuk menghapus informasi deployment. Untuk informasi selengkapnya, lihat Atur ulang deployment.

Dari AWS IoT konsol, pilih perangkat Greengrass, lalu pilih Grup (V1).
Pilih tab Deployments.
Pilih penerapan yang ingin Anda atur ulang dan pilih Reset penerapan.

Menyebarkan grup dengan AWS IoT Greengrass API

AWS IoT Greengrass API menyediakan tindakan berikut untuk menyebarkan AWS IoT Greengrass grup dan mengelola penerapan grup. Anda dapat memanggil tindakan ini dari AWS CLI, AWS IoT Greengrass API, atau AWS SDK.

Tindakan	Deskripsi
CreateDeployment	Membuat sebuah `NewDeployment` atau `Redeployment` deployment. Anda mungkin ingin men-deploy ulang deployment jika deployment saat ini gagal. Atau Anda mungkin ingin men-deploy ulang untuk kembali ke versi grup yang berbeda.
GetDeploymentStatus	Mengembalikan status sebuah deployment: `Building`, `InProgress`, `Success`, atau `Failure`. Anda dapat mengonfigurasi EventBridge acara Amazon untuk menerima pemberitahuan penerapan. Untuk informasi selengkapnya, lihat Dapatkan notifikasi deployment.
ListDeployments	Mengembalikan sejarah deployment untuk grup.
ResetDeployments	Mengatur ulang deployment untuk grup. Anda mungkin ingin mengatur ulang deployment grup untuk memindahkan atau menghapus grup atau untuk menghapus informasi deployment. Untuk informasi selengkapnya, lihat Atur ulang deployment.

catatan

Untuk informasi tentang operasi deployment massal, lihat Buat deployment massal untuk grup.

Mendapatkan ID grup

ID grup umumnya digunakan dalam tindakan API. Anda dapat menggunakan ListGroups tindakan untuk menemukan ID grup target dari daftar grup Anda. Misalnya, di AWS CLI, gunakan list-groups perintah.


aws greengrass list-groups

Anda juga dapat menyertakan query opsi untuk memfilter hasil. Contoh:

Untuk mendapatkan grup yang paling baru dibuat:


aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"

Untuk mendapatkan grup dengan nama:
```
aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
```
Nama grup tidak perlu unik, sehingga beberapa grup mungkin ditampilkan.

Berikut ini adalah contoh list-groups respons. Informasi untuk setiap grup termasuk ID grup (di dalam Id properti) dan ID dari versi grup terbaru (dalam LatestVersion properti). Untuk mendapatkan ID versi lain untuk grup, gunakan ID grup dengan ListGroupVersions.

catatan

Anda juga dapat menemukan nilai-nilai ini di AWS IoT konsol. ID grup ditampilkan pada halaman Pengaturan grup. ID versi grup ditampilkan pada tab Deployments grup.


{
    "Groups": [
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE/versions/4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "Name": "MyFirstGroup",
            "LastUpdatedTimestamp": "2019-11-11T05:47:31.435Z",
            "LatestVersion": "4cbc3f07-fc5e-48c4-a50e-7d356EXAMPLE",
            "CreationTimestamp": "2019-11-11T05:47:31.435Z",
            "Id": "00dedaaa-ac16-484d-ad77-c3eedEXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/00dedaaa-ac16-484d-ad77-c3eedEXAMPLE"
        },
        {
            "LatestVersionArn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE/versions/8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "Name": "GreenhouseSensors",
            "LastUpdatedTimestamp": "2020-01-07T19:58:36.774Z",
            "LatestVersion": "8fe9e8ec-64d1-4647-b0b0-01dc8EXAMPLE",
            "CreationTimestamp": "2020-01-07T19:58:36.774Z",
            "Id": "036ceaf9-9319-4716-ba2a-237f9EXAMPLE",
            "Arn": "arn:aws:us-west-2:123456789012:/greengrass/groups/036ceaf9-9319-4716-ba2a-237f9EXAMPLE"
        },
        ...
    ]
}

Jika Anda tidak menentukan Wilayah AWS, AWS CLI perintah menggunakan Wilayah default dari profil Anda. Untuk mengembalikan grup di Wilayah yang berbeda, sertakan region opsi. Contoh:


aws greengrass list-groups --region us-east-1

Ikhtisar dari AWS IoT Greengrass model objek kelompok

Saat pemrograman dengan AWS IoT Greengrass API, akan sangat membantu untuk memahami model objek grup Greengrass.

Grup

Di AWS IoT Greengrass API, Group objek tingkat atas terdiri dari metadata dan daftar GroupVersion objek. GroupVersionobjek dikaitkan dengan Group by ID.

Versi grup

GroupVersion objek mendefinisikan keanggotaan grup. Masing-masing GroupVersion mereferensi CoreDefinitionVersion dan versi komponen lainnya oleh ARN. Referensi ini menentukan entitas mana yang akan disertakan di dalam grup.

Sebagai contoh, untuk menyertakan tiga fungsi Lambda, satu perangkat, dan dua langganan di dalam grup, GroupVersion referensi:

Sebuah CoreDefinitionVersion yang berisi core yang dibutuhkan.
Sebuah FunctionDefinitionVersion yang berisi tiga fungsi.
Yang DeviceDefinitionVersion berisi perangkat klien.
Sebuah SubscriptionDefinitionVersion yang berisi dua langganan.

Men-deploy GroupVersion ke perangkat core menentukan entitas yang tersedia di lingkungan lokal dan cara mereka dapat berinteraksi.

Komponen grup

Komponen yang Anda tambahkan ke grup memiliki hirarki tiga tingkat:

Definisi yang mereferensikan daftar DefinitionVersion objek dari jenis tertentu. Sebagai contoh, DeviceDefinition mereferensikan daftar DeviceDefinitionVersion objek.
A DefinitionVersion yang berisi sekumpulan entitas dari tipe tertentu. Sebagai contoh, DeviceDefinitionVersion berisi sebuah daftar dari Device objek.
Entitas individu yang mendefinisikan properti dan perilaku mereka. Misalnya, a Device mendefinisikan ARN perangkat klien yang sesuai di AWS IoT registri, ARN sertifikat perangkatnya, dan apakah bayangan lokalnya disinkronkan secara otomatis dengan cloud.

Anda dapat menambahkan jenis entitas berikut ke grup:

Contoh berikut DeviceDefinition mereferensikan tiga DeviceDefinitionVersion objek yang masing-masing berisi beberapa Device objek. Hanya satu DeviceDefinitionVersion pada suatu waktu digunakan di dalam grup.

Diagram hierarki perangkat, yang terdiri dari DeviceDefinition, DeviceDefinitionVersion, dan objek Perangkat.

Memperbarui grup

Di AWS IoT Greengrass API, Anda menggunakan versi untuk memperbarui konfigurasi grup. Versi tidak dapat diubah, jadi untuk menambah, menghapus, atau mengubah komponen grup, Anda harus membuat DefinitionVersion objek yang berisi entitas baru atau yang diperbarui.

Anda dapat mengaitkan DefinitionVersions objek baru dengan objek Definisi baru atau yang sudah ada. Sebagai contoh, Anda dapat menggunakan opsi CreateFunctionDefinition tindakan untuk membuat FunctionDefinition yang mencakup FunctionDefinitionVersion sebagai versi awal, atau Anda dapat menggunakan CreateFunctionDefinitionVersion tindakan dan mereferensi yang sudah ada FunctionDefinition.

Setelah Anda membuat komponen grup Anda, Anda membuat GroupVersion yang berisi semua DefinitionVersion objek yang ingin Anda sertakan dalam grup. Kemudian, Anda men-deploy GroupVersion.

Untuk men-deploy GroupVersion, hal itu harus mereferensi CoreDefinitionVersion yang berisi persis satu Core. Semua entitas yang direferensikan harus menjadi anggota grup. Juga, peran layanan Greengrass harus dikaitkan dengan Anda Akun AWS di Wilayah AWS tempat Anda menyebarkan. GroupVersion

catatan

Tindakan Update dalam API digunakan untuk mengubah nama dari Group atau komponen Definisi objek.

Memperbarui entitas yang mereferensikan AWS sumber daya

Fungsi Greengrass Lambda dan sumber daya rahasia menentukan Greengrass-specific properti dan juga mereferensikan sumber daya yang sesuai AWS . Untuk memperbarui entitas ini, Anda dapat membuat perubahan pada AWS sumber daya yang sesuai alih-alih objek Greengrass Anda. Misalnya, fungsi Lambda mereferensikan fungsi di AWS Lambda dan juga menentukan siklus hidup dan properti lain yang spesifik untuk grup Greengrass.

Untuk memperbarui kode fungsi Lambda atau dependensi yang dikemas, buat perubahan Anda di dalam AWS Lambda. Selama penerapan grup berikutnya, perubahan ini diambil dari AWS Lambda dan disalin ke lingkungan lokal Anda.
Untuk memperbarui Greengrass-specific properti, Anda membuat FunctionDefinitionVersion yang berisi properti yang diperbaruiFunction.

catatan

Fungsi Greengrass Lambda dapat mereferensi fungsi Lambda dengan ARN alias atau ARN versi. Jika Anda mereferensikan ARN alias (disarankan), Anda tidak perlu memperbarui FunctionDefinitionVersion (atau SubscriptionDefinitionVersion) ketika Anda menerbitkan versi fungsi baru di dalam AWS Lambda. Untuk informasi selengkapnya, lihat Fungsi Referensi Lambda dengan alias atau versi.

Lihat juga

AWS IoT Greengrass Version 1 Referensi API
AWS IoT Greengrass perintah dalam Referensi AWS CLI Perintah

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Pembaruan OTA dari perangkat lunak AWS IoT Greengrass Core

Dapatkan notifikasi deployment