Pemberitahuan akhir dukungan: Pada 7 Oktober 2026, AWS akan menghentikan dukungan untuk. AWS IoT Greengrass Version 1 Setelah 7 Oktober 2026, Anda tidak akan lagi dapat mengakses sumber daya. AWS IoT Greengrass V1 Untuk informasi lebih lanjut, silakan kunjungi [Migrasi dari AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Deploy AWS IoT Greengrass kelompok ke sebuah 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.
Sebuah grup harus menyertakan [inti](gg-core.md), 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](https://docs.aws.amazon.com/freertos/latest/userguide/freertos-lib-gg-connectivity.html) atau menggunakan [AWS IoT Device](what-is-gg.md#iot-device-sdk) SDK [AWS IoT Greengrass atau Discovery](gg-discover-api.md) 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 intinya. Fungsi Lambda ditulis dan direferensikan dari grup AWS Lambda Greengrass. Untuk informasi selengkapnya, lihat [Jalankan fungsi Lambda di AWS IoT Greengrass inti](lambda-functions.md).
+ **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](connectors.md).
+ **Langganan**. Mendefinisikan penerbit, pelanggan, dan topik MQTT (atau mata pelajaran) yang berwenang untuk komunikasi MQTT.
+ **Sumber daya**. Referensi ke [perangkat dan volume lokal](access-local-resources.md), [model machine learning](ml-inference.md), dan [rahasia](secrets.md), 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](greengrass-logs-overview.md).
Anda mengelola grup Greengrass Anda di dan kemudian menyebarkannya AWS Cloud ke inti. Salinan deployment konfigurasi grup untuk file `group.json` pada perangkat core. File ini terletak di `{{greengrass-root}}/ggc/deployments/group`.
**catatan**
Selama deployment, proses Greengrass daemon pada perangkat core berhenti lalu dimulai kembali.
## Menyebarkan grup dari AWS IoT konsol
Anda dapat menerapkan grup dan mengelola penerapannya dari halaman konfigurasi grup di konsol. AWS IoT
**catatan**
Untuk membuka halaman ini di konsol, pilih Perangkat **Greengrass**, **lalu Grup (V1), dan kemudian di bawah Grup** **Greengrass**, pilih grup Anda.
**Untuk menyebarkan versi grup saat ini**
+ Dari halaman konfigurasi grup, pilih **Deploy**.
**Untuk melihat riwayat penyebaran grup**
Riwayat deployment grup mencakup tanggal dan waktu, versi grup, dan status setiap upaya deployment.
1. Dari halaman konfigurasi grup, pilih tab **Deployment.**
1. **Untuk melihat informasi selengkapnya tentang penerapan, termasuk pesan kesalahan, pilih **Penerapan dari AWS IoT konsol, di bawah Perangkat Greengrass**.**
**Untuk menerapkan ulang penyebaran grup**
Anda mungkin ingin men-deploy ulang deployment jika deployment saat ini gagal atau kembali ke versi grup yang berbeda.
1. **Dari AWS IoT konsol, pilih perangkat **Greengrass**, lalu pilih Grup (V1).**
1. Pilih tab **Deployment.**
1. **Pilih penerapan yang ingin Anda gunakan kembali dan pilih Redeploy.**
**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](reset-deployments-scenario.md).
1. **Dari AWS IoT konsol, pilih perangkat **Greengrass**, lalu pilih Grup (V1).**
1. Pilih tab **Deployment.**
1. Pilih penerapan yang ingin Anda atur ulang dan pilih Atur **ulang 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](https://docs.aws.amazon.com/greengrass/v1/apireference/createdeployment-post.html) | 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](https://docs.aws.amazon.com/greengrass/v1/apireference/getdeploymentstatus-get.html) | 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](deployment-notifications.md). |
| [ListDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/listdeployments-get.html) | Mengembalikan sejarah deployment untuk grup. |
| [ResetDeployments](https://docs.aws.amazon.com/greengrass/v1/apireference/resetdeployments-post.html) | 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](reset-deployments-scenario.md). |
**catatan**
Untuk informasi tentang operasi deployment massal, lihat [Buat deployment massal untuk grup](bulk-deploy-cli.md).
### Mendapatkan ID grup
ID grup umumnya digunakan dalam tindakan API. Anda dapat menggunakan [ListGroups](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroups-get.html)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](https://docs.aws.amazon.com/greengrass/v1/apireference/listgroupversions-get.html).
**catatan**
Anda juga dapat menemukan nilai-nilai ini di AWS IoT konsol. ID grup ditampilkan pada halaman **Pengaturan** grup. ID versi grup ditampilkan di tab **Deployment** 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 AWS IoT Greengrass model objek kelompok
Saat memprogram dengan AWS IoT Greengrass API, akan sangat membantu untuk memahami model objek grup Greengrass.
### Grup
Dalam AWS IoT Greengrass API, `Group` objek tingkat atas terdiri dari metadata dan daftar objek. `GroupVersion` `GroupVersion`objek dikaitkan dengan ID `Group` oleh.
### 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.
+ `DeviceDefinitionVersion`Yang 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 satu set 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 dari perangkat klien yang sesuai dalam registri, ARN sertifikat AWS IoT perangkatnya, dan apakah bayangan lokalnya disinkronkan secara otomatis dengan cloud.
Anda dapat menambahkan jenis entitas berikut ke grup:
+ [Konektor](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-connector.html)
+ [Inti](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-core.html)
+ [Perangkat](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-device.html)
+ [Fungsi](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-function.html)
+ [Logger](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-logger.html)
+ [Sumber Daya](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-resource.html)
+ [Berlangganan](https://docs.aws.amazon.com/greengrass/v1/apireference/definitions-subscription.html)
Contoh berikut `DeviceDefinition` mereferensikan tiga `DeviceDefinitionVersion` objek yang masing-masing berisi beberapa `Device` objek. Hanya satu `DeviceDefinitionVersion` pada suatu waktu digunakan di dalam grup.
### 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 membuat sebuah `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. Selain itu, peran [layanan Greengrass](service-role.md) harus dikaitkan dengan peran Akun AWS Anda di tempat Wilayah AWS Anda menggunakan. `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 properti dan](secrets.md) juga referensi sumber daya Greengrass-specific yang sesuai. AWS Untuk memperbarui entitas ini, Anda dapat membuat perubahan pada AWS sumber daya yang sesuai, bukan objek Greengrass Anda. Misalnya, fungsi Lambda mereferensikan fungsi 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 penyebaran grup berikutnya, perubahan ini diambil dari AWS Lambda dan disalin ke lingkungan lokal Anda.
+ Untuk memperbarui [Greengrass-specific properti](lambda-group-config.md), Anda membuat `FunctionDefinitionVersion` yang berisi `Function` properti yang diperbarui.
**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](lambda-functions.md#lambda-versions-aliases).
## Lihat juga
+ [Dapatkan notifikasi deployment](deployment-notifications.md)
+ [Atur ulang deployment](reset-deployments-scenario.md)
+ [Buat deployment massal untuk grup](bulk-deploy-cli.md)
+ [Memecahkan Masalah Penerapan](gg-troubleshooting.md#gg-troubleshooting-deploymentissues)
+ [AWS IoT Greengrass Version 1 Referensi API](https://docs.aws.amazon.com/greengrass/v1/apireference/)
+ [AWS IoT Greengrass perintah](https://docs.aws.amazon.com/cli/latest/reference/greengrass/index.html) dalam *Referensi AWS CLI Perintah*