Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Buat deployment
Anda dapat membuat deployment yang menargetkan objek atau grup objek.
Ketika Anda membuat deployment, Anda mengonfigurasi komponen perangkat lunak yang akan di-deploy dan bagaimana tugas deployment keluar ke target perangkat. Anda dapat menentukan deployment dalam file JSON yang Anda berikan ke AWS CLI.
Target deployment menentukan perangkat yang Anda inginkan untuk menjalankan komponen Anda. Untuk men-deploy ke satu perangkat inti, tentukan objek. Untuk men-deploy ke beberapa perangkat inti, tentukan grup objek yang mencakup perangkat tersebut. Untuk informasi lebih lanjut tentang cara mengonfigurasi grup objek, lihat [Grup objek statis](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html) dan [Grup objek dinamis](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html) di *Panduan Developer AWS IoT *.
Ikuti langkah-langkah di bagian ini untuk membuat penyebaran ke target. Untuk informasi selengkapnya tentang cara memperbarui komponen perangkat lunak pada target yang memiliki deployment, lihat [Revisi deployment](revise-deployments.md).
**Awas**
[CreateDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_CreateDeployment.html)Operasi dapat menghapus komponen dari perangkat inti. Jika komponen ada di penerapan sebelumnya dan bukan penerapan baru, perangkat inti akan menghapus pemasangan komponen tersebut. Untuk menghindari mencopot pemasangan komponen, pertama-tama gunakan [ListDeployments](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_ListDeployments.html)operasi untuk memeriksa apakah target penerapan sudah memiliki penerapan yang ada. Kemudian, gunakan [GetDeployment](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetDeployment.html)operasi untuk memulai dari penerapan yang ada saat Anda membuat penerapan baru.
**Untuk membuat deployment (AWS CLI)**
1. Buat file bernama `deployment.json`, lalu salin objek JSON berikut ke dalam file. Ganti *targetArn* dengan ARN dari grup AWS IoT benda atau benda yang akan ditargetkan untuk penerapan. Kelompok benda dan benda ARNs memiliki format berikut:
+ Objek: `arn:aws:iot:region:account-id:thing/thingName`
+ Grup objek: `arn:aws:iot:region:account-id:thinggroup/thingGroupName`
```
{
"targetArn": "targetArn"
}
```
1. Periksa apakah target penerapan memiliki penerapan yang sudah ada yang ingin Anda revisi. Lakukan hal-hal berikut:
1. Jalankan perintah berikut untuk membuat daftar penerapan untuk target penyebaran. Ganti *targetArn* dengan ARN dari AWS IoT benda target atau kelompok benda.
```
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[Step 3](#create-deployment-define-name-step). Jika tidak, salin `deploymentId` dari respons untuk digunakan pada langkah berikutnya.
**catatan**
Anda juga dapat merevisi deployment selain revisi terbaru untuk target. Tentukan `--history-filter ALL` untuk mencantumkan semua deployment untuk target. Kemudian, salin ID penerapan yang ingin Anda revisi.
1. 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
```
Tanggapan berisi detail deployment.
1. Salin salah satu pasangan kunci-nilai berikut dari respons perintah sebelumnya ke dalam. `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.
+ `iotJobConfiguration`— Konfigurasi pekerjaan penerapan.
+ `tags`— Tag penyebaran.
1. (Opsional) Tentukan nama untuk penerapan. Ganti *deploymentName* dengan nama penyebaran.
```
{
"targetArn": "targetArn",
"deploymentName": "deploymentName"
}
```
1. Tambahkan setiap komponen untuk men-deploy perangkat target. Untuk melakukannya, tambahkan pasangan nilai kunci ke objek `components`, di mana kunci adalah nama komponen, dan nilai adalah objek yang berisi detail untuk komponen tersebut. Tentukan detail berikut untuk setiap komponen yang Anda tambahkan:
+ `version` — Versi komponen yang akan di-deploy.
+ `configurationUpdate` — [Pembaruan konfigurasi](update-component-configurations.md) yang akan di-deploy. Pembaruan adalah operasi patch yang memodifikasi konfigurasi komponen yang ada pada setiap perangkat target, atau konfigurasi default komponen jika tidak ada pada perangkat target. Anda dapat menentukan pembaruan konfigurasi berikut:
+ Pembaruan reset (`reset`) — (Opsional) Daftar pointer JSON yang menentukan nilai konfigurasi untuk di-reset ke nilai default-nya pada perangkat target. Perangkat lunak AWS IoT Greengrass Core menerapkan pembaruan reset sebelum menerapkan pembaruan gabungan. Untuk informasi selengkapnya, lihat [Pembaruan reset](update-component-configurations.md#reset-configuration-update).
+ Pembaruan merge (`merge`) - (Opsional) Sebuah dokumen JSON yang menentukan nilai konfigurasi yang akan digabungkan ke perangkat target. Anda harus membuat serial dokumen JSON sebagai string. Untuk informasi selengkapnya, lihat [Pembaruan merge](update-component-configurations.md#merge-configuration-update).
+ `runWith`— (Opsional) Opsi proses sistem yang digunakan perangkat lunak AWS IoT Greengrass Core untuk menjalankan proses komponen ini pada perangkat inti. Jika Anda menghilangkan parameter dalam `runWith` objek, perangkat lunak AWS IoT Greengrass Core menggunakan nilai default yang Anda konfigurasikan pada komponen inti [Greengrass](greengrass-nucleus-component.md).
Anda dapat menentukan salah satu opsi berikut:
+ `posixUser`— Pengguna sistem POSIX dan, secara opsional, kelompok untuk digunakan untuk menjalankan komponen ini pada perangkat inti Linux. Pengguna, dan grup jika ditentukan, harus ada di setiap perangkat inti Linux. Tentukan pengguna dan grup yang dipisahkan dengan titik dua (`:`) dalam format berikut: `user:group`. Grup ini opsional. Jika Anda tidak menentukan grup, perangkat lunak AWS IoT Greengrass Core menggunakan grup utama untuk pengguna. Untuk informasi selengkapnya, lihat [Konfigurasikan pengguna yang menjalankan komponen](configure-greengrass-core-v2.md#configure-component-user).
+ `windowsUser`— Pengguna Windows yang digunakan untuk menjalankan komponen ini pada perangkat inti Windows. Pengguna harus ada di setiap perangkat inti Windows, dan nama serta kata sandinya harus disimpan dalam instance Credentials Manager LocalSystem akun. Untuk informasi selengkapnya, lihat [Konfigurasikan pengguna yang menjalankan komponen](configure-greengrass-core-v2.md#configure-component-user).
[Fitur ini tersedia untuk v2.5.0 dan yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md)
+ `systemResourceLimits`— Batas sumber daya sistem untuk diterapkan pada proses komponen ini. Anda dapat menerapkan batas sumber daya sistem ke komponen Lambda generik dan non-kontainer. Untuk informasi selengkapnya, lihat [Konfigurasikan batas sumber daya sistem untuk komponen](configure-greengrass-core-v2.md#configure-component-system-resource-limits).
Anda dapat menentukan salah satu opsi berikut:
+ `cpus`— Jumlah maksimum waktu CPU yang dapat digunakan oleh proses komponen ini pada perangkat inti. Total waktu CPU perangkat inti setara dengan jumlah inti CPU perangkat. Misalnya, pada perangkat inti dengan 4 core CPU, Anda dapat mengatur nilai ini `2` untuk membatasi proses komponen ini hingga 50 persen penggunaan setiap inti CPU. Pada perangkat dengan 1 inti CPU, Anda dapat mengatur nilai ini `0.25` untuk membatasi proses komponen ini hingga 25 persen penggunaan CPU. Jika Anda menetapkan nilai ini ke angka yang lebih besar dari jumlah inti CPU, perangkat lunak AWS IoT Greengrass Core tidak membatasi penggunaan CPU komponen.
+ `memory`— Jumlah maksimum RAM (dalam kilobyte) yang dapat digunakan oleh proses komponen ini pada perangkat inti.
[Fitur ini tersedia untuk v2.4.0 dan yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md) AWS IoT Greengrass saat ini tidak mendukung fitur ini di perangkat inti Windows.
**Example Contoh pembaruan konfigurasi dasar**
Obejk `components` contoh berikut menentukan untuk men-deploy komponen, `com.example.PythonRuntime`, yang mengharapkan parameter konfigurasi bernama `pythonVersion`.
```
{
"targetArn": "targetArn",
"deploymentName": "deploymentName",
"components": {
"com.example.PythonRuntime": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"merge": "{\"pythonVersion\":\"3.7\"}"
}
}
}
}
```
**Example Contoh pembaruan konfigurasi dengan pembaruan reset dan merge**
Pertimbangkan komponen contoh dasbor industri, `com.example.IndustrialDashboard`, yang memiliki konfigurasi default berikut.
```
{
"name": null,
"mode": "REQUEST",
"network": {
"useHttps": true,
"port": {
"http": 80,
"https": 443
},
},
"tags": []
}
```
Pembaruan konfigurasi berikut menentukan petunjuk berikut:
1. Reset pengaturan HTTPS ke nilai default (`true`).
1. Setel ulang daftar tag industri ke daftar kosong.
1. Gabungkan daftar tag industri yang mengidentifikasi aliran data suhu dan tekanan untuk dua boiler.
```
{
"reset": [
"/network/useHttps",
"/tags"
],
"merge": {
"tags": [
"/boiler/1/temperature",
"/boiler/1/pressure",
"/boiler/2/temperature",
"/boiler/2/pressure"
]
}
}
```
Contoh objek `components` berikut menentukan untuk men-deploy komponen dasbor industri ini dan pembaruan konfigurasi.
```
{
"targetArn": "targetArn",
"deploymentName": "deploymentName",
"components": {
"com.example.IndustrialDashboard": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"reset": [
"/network/useHttps",
"/tags"
],
"merge": "{\"tags\":[\"/boiler/1/temperature\",\"/boiler/1/pressure\",\"/boiler/2/temperature\",\"/boiler/2/pressure\"]}"
}
}
}
}
```
1. (Opsional) Tentukan kebijakan deployment untuk deployment ini. Anda dapat mengonfigurasi ketika perangkat inti dapat dengan aman menerapkan deployment atau apa yang harus dilakukan jika perangkat inti gagal untuk menerapkan deployment tersebut. Untuk melakukannya, tambahkan objek `deploymentPolicies` pada `deployment.json`, lalu lakukan langkah-langkah berikut:
1. (Opsional) Tentukan kebijakan pembaruan komponen (`componentUpdatePolicy`). Kebijakan ini menentukan apakah deployment memungkinkan komponen menunda pembaruan sampai siap untuk diperbarui. Sebagai contoh, komponen mungkin perlu membersihkan sumber daya atau menyelesaikan tindakan penting sebelum dapat di-restart untuk menerapkan pembaruan. Kebijakan ini juga menentukan jumlah waktu yang harus ditanggapi komponen pada pemberitahuan pembaruan.
Kebijakan ini merupakan objek dengan parameter berikut:
+ `action` — (Opsional) Apakah akan memberi tahu komponen atau tidak dan menunggunya melaporkan kapan ia siap untuk diperbarui. Pilih dari salah satu pilihan berikut:
+ `NOTIFY_COMPONENTS` – Deployment akan memberitahu setiap komponen sebelum menghentikan dan memperbarui komponen itu. Komponen dapat menggunakan operasi IPC [SubscribeToComponentUpdates](ipc-component-lifecycle.md#ipc-operation-subscribetocomponentupdates) untuk menerima pemberitahuan ini.
+ `SKIP_NOTIFY_COMPONENTS` – Deployment tidak memberitahu komponen atau menunggunya sampai aman untuk diperbarui.
Default ke `NOTIFY_COMPONENTS`.
+ `timeoutInSeconds` Jumlah waktu, dalam hitungan detik, ketika setiap komponen merespons notifikasi pembaruan dengan perintah operasi IPC [DeferComponentUpdate](ipc-component-lifecycle.md#ipc-operation-defercomponentupdate). Jika komponen tidak merespons dalam jumlah waktu ini, maka deployment akan berlangsung pada perangkat inti.
Default ke 60 detik.
1. (Opsional) Tentukan kebijakan validasi konfigurasi (`configurationValidationPolicy`). Kebijakan ini menentukan berapa lama setiap komponen harus memvalidasi pembaruan konfigurasi dari suatu deployment. Komponen dapat menggunakan operasi IPC [SubscribeToValidateConfigurationUpdates](ipc-component-configuration.md#ipc-operation-subscribetovalidateconfigurationupdates) untuk berlangganan pemberitahuan untuk pembaruan konfigurasinya sendiri. Kemudian, komponen dapat menggunakan operasi [SendConfigurationValidityReport](ipc-component-configuration.md#ipc-operation-sendconfigurationvalidityreport) IPC untuk memberi tahu perangkat lunak AWS IoT Greengrass Core jika pembaruan konfigurasi valid. Jika pembaruan konfigurasi tidak valid, deployment akan gagal.
Kebijakan ini merupakan objek dengan parameter berikut:
+ `timeoutInSeconds` (Opsional) Jumlah waktu, dalam hitungan detik, ketika setiap komponen harus memvalidasi pembaruan konfigurasi. Jika komponen tidak merespons dalam jumlah waktu ini, maka deployment akan berlangsung pada perangkat inti.
Default ke 30 detik.
1. (Opsional) Tentukan kebijakan penanganan kegagalan (`failureHandlingPolicy`). Kebijakan ini adalah string yang menentukan apakah akan memutar kembali perangkat atau tidak jika deployment tersebut gagal. Pilih dari salah satu pilihan berikut:
+ `ROLLBACK`— Jika penerapan gagal pada perangkat inti, maka perangkat lunak AWS IoT Greengrass Core memutar kembali perangkat inti itu ke konfigurasi sebelumnya.
+ `DO_NOTHING`— Jika penerapan gagal pada perangkat inti, maka perangkat lunak AWS IoT Greengrass Core menyimpan konfigurasi baru. Hal ini dapat mengakibatkan komponen rusak jika konfigurasi baru tidak valid.
Default ke `ROLLBACK`.
Deployment Anda di `deployment.json` mungkin terlihat serupa dengan contoh berikut:
```
{
"targetArn": "targetArn",
"deploymentName": "deploymentName",
"components": {
"com.example.IndustrialDashboard": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"reset": [
"/network/useHttps",
"/tags"
],
"merge": "{\"tags\":[\"/boiler/1/temperature\",\"/boiler/1/pressure\",\"/boiler/2/temperature\",\"/boiler/2/pressure\"]}"
}
}
},
"deploymentPolicies": {
"componentUpdatePolicy": {
"action": "NOTIFY_COMPONENTS",
"timeoutInSeconds": 30
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
},
"failureHandlingPolicy": "ROLLBACK"
}
}
```
1. (Opsional) Tentukan bagaimana penerapan berhenti, diluncurkan, atau habis waktu. AWS IoT Greengrass menggunakan AWS IoT Core pekerjaan untuk mengirim penerapan ke perangkat inti, sehingga opsi ini identik dengan opsi konfigurasi untuk AWS IoT Core pekerjaan. Untuk informasi selengkapnya, lihat [Peluncuran tugas dan batalkan konfigurasi](https://docs.aws.amazon.com/iot/latest/developerguide/job-rollout-abort.html) di *Panduan Developer AWS IoT *.
Untuk menentukan pilihan tugas, tambahkan objek `iotJobConfiguration` pada `deployment.json`. Kemudian, tentukan pilihan yang akan dikonfigurasi.
Deployment Anda di `deployment.json` mungkin terlihat serupa dengan contoh berikut:
```
{
"targetArn": "targetArn",
"deploymentName": "deploymentName",
"components": {
"com.example.IndustrialDashboard": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"reset": [
"/network/useHttps",
"/tags"
],
"merge": "{\"tags\":[\"/boiler/1/temperature\",\"/boiler/1/pressure\",\"/boiler/2/temperature\",\"/boiler/2/pressure\"]}"
}
}
},
"deploymentPolicies": {
"componentUpdatePolicy": {
"action": "NOTIFY_COMPONENTS",
"timeoutInSeconds": 30
},
"configurationValidationPolicy": {
"timeoutInSeconds": 60
},
"failureHandlingPolicy": "ROLLBACK"
},
"iotJobConfiguration": {
"abortConfig": {
"criteriaList": [
{
"action": "CANCEL",
"failureType": "ALL",
"minNumberOfExecutedThings": 100,
"thresholdPercentage": 5
}
]
},
"jobExecutionsRolloutConfig": {
"exponentialRate": {
"baseRatePerMinute": 5,
"incrementFactor": 2,
"rateIncreaseCriteria": {
"numberOfNotifiedThings": 10,
"numberOfSucceededThings": 5
}
},
"maximumPerMinute": 50
},
"timeoutConfig": {
"inProgressTimeoutInMinutes": 5
}
}
}
```
1. (Opsional) Tambahkan tag (`tags`) untuk deployment itu. Untuk informasi selengkapnya, lihat [Tandai AWS IoT Greengrass Version 2 sumber daya Anda](tag-resources.md).
1. Jalankan perintah berikut untuk membuat deployment dari `deployment.json`.
```
aws greengrassv2 create-deployment --cli-input-json file://deployment.json
```
Tanggapan meliputi `deploymentId` yang menentukan deployment ini. Anda dapat menggunakan ID deployment untuk memeriksa status deployment. Untuk informasi selengkapnya, lihat [Periksa status deployment](check-deployment-status.md#check-cloud-deployment-status).
# Perbarui konfigurasi komponen
Konfigurasi komponen adalah objek JSON yang menentukan parameter untuk setiap komponen. Resep setiap komponen menentukan konfigurasi default, yang Anda ubah ketika Anda men-deploy komponen ke perangkat inti.
Bila Anda membuat deployment, Anda dapat menentukan *pembaruan konfigurasi* yang akan diterapkan bagi setiap komponen. Pembaruan konfigurasi adalah operasi patch, yang berarti bahwa pembaruan mengubah konfigurasi komponen yang ada pada perangkat inti. Jika perangkat inti tidak memiliki komponen, maka pembaruan konfigurasi akan memodifikasi dan menerapkan konfigurasi default untuk deployment tersebut.
Pembaruan konfigurasi menentukan pembaruan *reset* dan pembaruan *merge*. Pembaruan reset menentukan nilai konfigurasi yang akan di-reset ke default-nya atau dihapus. Pembaruan merge menentukan nilai konfigurasi baru yang akan ditetapkan untuk komponen. Saat Anda menerapkan pembaruan konfigurasi, perangkat lunak AWS IoT Greengrass Core menjalankan pembaruan reset sebelum pembaruan gabungan.
Komponen dapat memvalidasi pembaruan konfigurasi yang Anda deploy. Komponen berlangganan untuk menerima pemberitahuan ketika deployment mengubah konfigurasi, dan dapat menolak konfigurasi yang tidak mendukung. Untuk informasi selengkapnya, lihat [Berinteraksilah dengan konfigurasi komponen](ipc-component-configuration.md).
**Topics**
+ [Pembaruan reset](#reset-configuration-update)
+ [Pembaruan merge](#merge-configuration-update)
+ [Contoh](#configuration-update-example)
## Pembaruan reset
Pembaruan reset menentukan nilai konfigurasi yang akan di-reset ke default-nya pada perangkat inti. Jika nilai konfigurasi tidak memiliki nilai default, maka pembaruan reset akan menghapus nilai dari konfigurasi komponen. Hal ini dapat membantu Anda memperbaiki komponen yang rusak sebagai hasil dari konfigurasi yang tidak valid.
Gunakan daftar pointer JSON untuk menentukan nilai konfigurasi yang akan di-reset. Pointer JSON dimulai dengan garis miring `/`. Untuk menentukan nilai dalam konfigurasi komponen bersusun, gunakan garis miring ke depan (`/`) untuk memisahkan kunci-kunci pada setiap tingkat dalam konfigurasi. Untuk informasi selengkapnya, lihat [spesifikasi pointer JSON](https://tools.ietf.org/html/rfc6901).
**catatan**
Anda hanya dapat mengatur ulang seluruh daftar ke nilai default. Anda tidak dapat menggunakan pembaruan reset untuk mengatur ulang elemen individual dalam daftar.
Untuk me-reset seluruh konfigurasi komponen untuk nilai default, tentukan string kosong tunggal sebagai pembaruan reset.
```
"reset": [""]
```
## Pembaruan merge
Pembaruan merge menentukan nilai konfigurasi yang akan dimasukkan ke konfigurasi komponen pada inti. Pembaruan gabungan adalah objek JSON yang digabungkan oleh perangkat lunak AWS IoT Greengrass Core setelah menyetel ulang nilai di jalur yang Anda tentukan dalam pembaruan reset. Bila Anda menggunakan AWS CLI or AWS SDKs, Anda harus membuat serial objek JSON ini sebagai string.
Anda dapat menggabungkan pasangan kunci-nilai yang tidak ada dalam konfigurasi default komponen. Anda juga dapat menggabungkan pasangan kunci-nilai yang memiliki jenis yang berbeda dari nilai dengan kunci yang sama. Nilai baru akan menggantikan nilai lama. Ini berarti bahwa Anda dapat mengubah struktur objek konfigurasi.
Anda dapat menggabungkan nilai-nilai null dan string, daftar, dan objek kosong.
**catatan**
Anda tidak dapat menggunakan pembaruan merge untuk tujuan memasukkan atau menambahkan elemen ke daftar. Anda dapat mengganti seluruh daftar, atau Anda dapat menentukan objek di mana setiap elemen memiliki kunci yang unik.
AWS IoT Greengrass menggunakan JSON untuk nilai konfigurasi. JSON menentukan jenis nomor tetapi tidak membedakan antara bilangan bulat dan float. Akibatnya, nilai konfigurasi mungkin berubah menjadi float di AWS IoT Greengrass. Untuk memastikan bahwa komponen Anda menggunakan jenis data yang benar, kami sarankan Anda menentukan nilai konfigurasi numerik sebagai string. Kemudian, buat komponen Anda mengurainya sebagai bilangan bulat atau float. Hal ini akan memastikan bahwa nilai konfigurasi Anda memiliki jenis yang sama dalam konfigurasi dan pada perangkat inti Anda.
### Gunakan variabel resep dalam menggabungkan pembaruan
[Fitur ini tersedia untuk v2.6.0 dan yang lebih baru dari komponen inti Greengrass.](greengrass-nucleus-component.md)
Jika Anda menyetel opsi konfigurasi [interpolateComponentConfiguration](greengrass-nucleus-component.md#greengrass-nucleus-component-configuration-interpolate-component-configuration)inti Greengrass `true` ke, Anda dapat menggunakan variabel resep, selain `component_dependency_name:configuration:json_pointer` variabel resep, dalam pembaruan gabungan. Misalnya, Anda dapat menggunakan variabel `{iot:thingName}` resep dalam pembaruan gabungan untuk menyertakan nama AWS IoT benda perangkat inti dalam nilai konfigurasi komponen, seperti kebijakan otorisasi [komunikasi antarproses (IPC)](interprocess-communication.md#ipc-authorization-policies).
## Contoh
Contoh berikut menunjukkan pembaruan konfigurasi untuk komponen dasbor yang memiliki konfigurasi default berikut. Contoh komponen ini menampilkan informasi tentang peralatan industri.
```
{
"name": null,
"mode": "REQUEST",
"network": {
"useHttps": true,
"port": {
"http": 80,
"https": 443
},
},
"tags": []
}
```
### Resep komponen dasbor industri
------
#### [ JSON ]
```
{
"RecipeFormatVersion": "2020-01-25",
"ComponentName": "com.example.IndustrialDashboard",
"ComponentVersion": "1.0.0",
"ComponentDescription": "Displays information about industrial equipment.",
"ComponentPublisher": "Amazon",
"ComponentConfiguration": {
"DefaultConfiguration": {
"name": null,
"mode": "REQUEST",
"network": {
"useHttps": true,
"port": {
"http": 80,
"https": 443
},
},
"tags": []
}
},
"Manifests": [
{
"Platform": {
"os": "linux"
},
"Lifecycle": {
"Run": "python3 -u {artifacts:path}/industrial_dashboard.py"
}
},
{
"Platform": {
"os": "windows"
},
"Lifecycle": {
"Run": "py -3 -u {artifacts:path}/industrial_dashboard.py"
}
}
]
}
```
------
#### [ YAML ]
```
---
RecipeFormatVersion: '2020-01-25'
ComponentName: com.example.IndustrialDashboard
ComponentVersion: '1.0.0'
ComponentDescription: Displays information about industrial equipment.
ComponentPublisher: Amazon
ComponentConfiguration:
DefaultConfiguration:
name: null
mode: REQUEST
network:
useHttps: true
port:
http: 80
https: 443
tags: []
Manifests:
- Platform:
os: linux
Lifecycle:
Run: |
python3 -u {artifacts:path}/industrial_dashboard.py
- Platform:
os: windows
Lifecycle:
Run: |
py -3 -u {artifacts:path}/industrial_dashboard.py
```
------
**Example Contoh 1: Gabungkan pembaruan**
Anda membuat penerapan yang menerapkan pemutakhiran konfigurasi berikut, yang menentukan pembaruan gabungan tetapi bukan pembaruan reset. Pembaruan konfigurasi ini memberi tahu komponen untuk menampilkan dasbor pada port HTTP 8080 dengan data dari dua boiler.
**Konfigurasi untuk digabungkan**
```
{
"name": "Factory 2A",
"network": {
"useHttps": false,
"port": {
"http": 8080
}
},
"tags": [
"/boiler/1/temperature",
"/boiler/1/pressure",
"/boiler/2/temperature",
"/boiler/2/pressure"
]
}
```
Perintah berikut membuat penyebaran ke perangkat inti.
```
aws greengrassv2 create-deployment --cli-input-json file://dashboard-deployment.json
```
`dashboard-deployment.json`File tersebut berisi dokumen JSON berikut.
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"deploymentName": "Deployment for MyGreengrassCore",
"components": {
"com.example.IndustrialDashboard": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"merge": "{\"name\":\"Factory 2A\",\"network\":{\"useHttps\":false,\"port\":{\"http\":8080}},\"tags\":[\"/boiler/1/temperature\",\"/boiler/1/pressure\",\"/boiler/2/temperature\",\"/boiler/2/pressure\"]}"
}
}
}
}
```
Perintah [Greengrass CLI](greengrass-cli-component.md) berikut membuat penerapan lokal pada perangkat inti.
```
sudo greengrass-cli deployment create \
--recipeDir recipes \
--artifactDir artifacts \
--merge "com.example.IndustrialDashboard=1.0.0" \
--update-config dashboard-configuration.json
```
`dashboard-configuration.json`File tersebut berisi dokumen JSON berikut.
```
{
"com.example.IndustrialDashboard": {
"MERGE": {
"name": "Factory 2A",
"network": {
"useHttps": false,
"port": {
"http": 8080
}
},
"tags": [
"/boiler/1/temperature",
"/boiler/1/pressure",
"/boiler/2/temperature",
"/boiler/2/pressure"
]
}
}
}
```
Setelah pembaruan ini, komponen dasbor akan memiliki konfigurasi berikut.
```
{
"name": "Factory 2A",
"mode": "REQUEST",
"network": {
"useHttps": false,
"port": {
"http": 8080,
"https": 443
}
},
"tags": [
"/boiler/1/temperature",
"/boiler/1/pressure",
"/boiler/2/temperature",
"/boiler/2/pressure"
]
}
```
**Example Contoh 2: Setel ulang dan gabungkan pembaruan**
Kemudian, Anda membuat penerapan yang menerapkan pemutakhiran konfigurasi berikut, yang menentukan pembaruan reset dan pembaruan gabungan. Pembaruan ini menentukan untuk menampilkan dasbor pada port HTTPS default dengan data dari boiler yang berbeda. Pembaruan ini mengubah konfigurasi yang dihasilkan dari pembaruan konfigurasi pada contoh sebelumnya.
**Setel ulang jalur**
```
[
"/network/useHttps",
"/tags"
]
```
**Konfigurasi untuk digabungkan**
```
{
"tags": [
"/boiler/3/temperature",
"/boiler/3/pressure",
"/boiler/4/temperature",
"/boiler/4/pressure"
]
}
```
Perintah berikut membuat penyebaran ke perangkat inti.
```
aws greengrassv2 create-deployment --cli-input-json file://dashboard-deployment2.json
```
`dashboard-deployment2.json`File tersebut berisi dokumen JSON berikut.
```
{
"targetArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
"deploymentName": "Deployment for MyGreengrassCore",
"components": {
"com.example.IndustrialDashboard": {
"componentVersion": "1.0.0",
"configurationUpdate": {
"reset": [
"/network/useHttps",
"/tags"
],
"merge": "{\"tags\":[\"/boiler/3/temperature\",\"/boiler/3/pressure\",\"/boiler/4/temperature\",\"/boiler/4/pressure\"]}"
}
}
}
}
```
Perintah [Greengrass CLI](greengrass-cli-component.md) berikut membuat penerapan lokal pada perangkat inti.
```
sudo greengrass-cli deployment create \
--recipeDir recipes \
--artifactDir artifacts \
--merge "com.example.IndustrialDashboard=1.0.0" \
--update-config dashboard-configuration2.json
```
`dashboard-configuration2.json`File tersebut berisi dokumen JSON berikut.
```
{
"com.example.IndustrialDashboard": {
"RESET": [
"/network/useHttps",
"/tags"
],
"MERGE": {
"tags": [
"/boiler/3/temperature",
"/boiler/3/pressure",
"/boiler/4/temperature",
"/boiler/4/pressure"
]
}
}
}
```
Setelah pembaruan ini, komponen dasbor akan memiliki konfigurasi berikut.
```
{
"name": "Factory 2A",
"mode": "REQUEST",
"network": {
"useHttps": true,
"port": {
"http": 8080,
"https": 443
}
},
"tags": [
"/boiler/3/temperature",
"/boiler/3/pressure",
"/boiler/4/temperature",
"/boiler/4/pressure",
]
}
```