AWS IoT Greengrass Version 1 memasuki fase umur panjang pada 30 Juni 2023. Untuk informasi selengkapnya, lihat kebijakan AWS IoT Greengrass V1 pemeliharaan. Setelah tanggal ini, tidak AWS IoT Greengrass V1 akan merilis pembaruan yang menyediakan fitur, penyempurnaan, perbaikan bug, atau patch keamanan. Perangkat yang berjalan AWS IoT Greengrass V1 tidak akan terganggu dan akan terus beroperasi dan terhubung ke cloud. Kami sangat menyarankan Anda bermigrasi ke AWS IoT Greengrass Version 2, yang menambahkan fitur baru yang signifikan dan dukungan untuk platform tambahan.

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

Perbarui OTA AWS IoT Greengrass perangkat lunak Core

Paket perangkat lunak AWS IoT Greengrass Core mencakup agen pembaruan yang dapat melakukan pembaruan AWS IoT Greengrass perangkat lunak over-the-air (OTA). Anda dapat menggunakan pembaruan OTA untuk menginstal versi terbaru AWS IoT Greengrass perangkat lunak Core atau perangkat lunak agen pembaruan OTA pada satu atau lebih core. Dengan pembaruan OTA, perangkat inti Anda tidak harus hadir secara fisik.

Kami merekomendasikan agar Anda menggunakan pembaruan OTA bila memungkinkan. Mereka menyediakan mekanisme yang dapat Anda gunakan untuk melacak status pembaruan dan sejarah pembaruan. Jika terjadi gagal pembaruan, agen pembaruan OTA akan kembali ke versi perangkat lunak sebelumnya.

pembaruan OTA membuatnya lebih efisien untuk:

Fitur ini terintegrasi dengan AWS IoT tugas.

Persyaratan

Persyaratan berikut berlaku untuk pembaruan OTA AWS IoT Greengrass perangkat lunak.

Izin IAM untuk pembaruan OTA

Ketika AWS IoT Greengrass merilis versi baru dari perangkat lunak Core AWS IoT Greengrass ini, AWS IoT Greengrass memperbarui artefak perangkat lunak yang disimpan di Amazon S3 yang digunakan untuk pembaruan OTA.

Anda Akun AWS harus menyertakan peran signer URL Amazon S3 yang dapat digunakan untuk mengakses artefak ini. Peran harus memiliki kebijakan izin yang mengizinkan s3:GetObject tindakan pada bucket di target Wilayah AWSs. Peran ini juga harus memiliki kebijakan kepercayaan yang mengizinkan iot.amazonaws.com untuk mengambil peran sebagai entitas terpercaya.

Selain itu, pengguna yang memulai pembaruan OTA harus memiliki izin untuk menggunakan greengrass:CreateSoftwareUpdateJob dan iot:CreateJob, dan menggunakan iam:PassRole untuk lulus izin dari peran signer. Berikut ini adalah contoh kebijakan IAM:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "greengrass:CreateSoftwareUpdateJob"
            ],
            "Effect": "Allow",
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iot:CreateJob"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "iam:PassRole"
            ],
            "Resource": "arn-of-s3-url-signer-role"
        }
    ]
}

Pertimbangan-pertimbangan

Sebelum Anda meluncurkan pembaruan OTA perangkat lunak Core Greengrass, waspadai dampak pada perangkat dalam grup Greengrass Anda, baik pada perangkat core dan pada perangkat klien yang terhubung secara lokal ke core itu:

Informasi status berikut dipertahankan selama pembaruan OTA:

Agen pembaruan OTA Greengrass

Agen pembaruan OTA Greengrass adalah komponen perangkat lunak pada perangkat yang menangani pembaruan pekerjaan yang dibuat dan di-deploy di cloud. Agen pembaruan OTA didistribusikan dalam paket perangkat lunak yang sama sebagai AWS IoT Greengrass perangkat lunak Core. Agen tersebut berada di /greengrass-root/ota/ota_agent/ggc-ota. Ini menulis log ke /var/log/greengrass/ota/ggc_ota.txt.

Anda dapat memulai agen pembaruan OTA dengan mengeksekusi biner secara manual atau dengan mengintegrasikannya sebagai bagian dari skrip init, seperti file layanan systemd. Jika Anda menjalankan biner secara manual, itu harus dijalankan sebagai root. Ketika ini mulai, agen pembaruan OTA mendengarkan tugas pembaruan perangkat lunak AWS IoT Greengrass dari AWS IoT Core dan mengeksekusi mereka secara berurutan. Agen pembaruan OTA mengabaikan semua lainnya AWS IoT jenis tugas.

Kutipan berikut menunjukkan contoh file layanan systemd untuk memulai, berhenti, dan restart agen pembaruan OTA:

[Unit]
Description=Greengrass OTA Daemon

[Service]
Type=forking
Restart=on-failure
ExecStart=/greengrass/ota/ota_agent/ggc-ota

[Install]
WantedBy=multi-user.target

Core yang merupakan target pembaruan tidak harus menjalankan dua instans agen pembaruan OTA. Melakukan hal itu membuat kedua agen untuk memproses tugas yang sama, yang membuat konflik.

Integrasi dengan sistem init

Selama pembaruan OTA, agen pembaruan OTA restart binari pada perangkat core. Jika bineri berjalan, ini dapat menyebabkan konflik ketika sistem init memantau keadaan perangkat lunak Core AWS IoT Greengrass atau agen selama pembaruan. Untuk membantu mengintegrasikan mekanisme pembaruan OTA dengan strategi pemantauan init Anda, Anda dapat menulis skrip shell yang berjalan sebelum dan sesudah pembaruan. Sebagai contoh, Anda dapat menggunakan ggc_pre_update.sh skrip untuk membuat cadangan data atau menghentikan proses sebelum perangkat dimatikan.

Untuk memberitahu agen pembaruan OTA untuk menjalankan skrip ini, Anda harus menyertakan "managedRespawn" : true bendera di file config.json. Pengaturan ini ditunjukkan dalam contoh berikut:

{
   "coreThing": {                                                     
       …
   },
   "runtime": {                                                       
       …
   },
   "managedRespawn": true
       …
}

Respawn terkelola dengan pembaruan OTA

Persyaratan berikut berlaku untuk pembaruan OTA dengan managedRespawn diatur ke true:

Agen pembaruan OTA menjalankan skrip dari /greengrass-root/usr/scripts. Pohon direktori akan terlihat seperti berikut:

<greengrass_root>
|-- certs
|-- config
|   |-- config.json
|-- ggc
|-- usr/scripts
|   |-- ggc_pre_update.sh
|   |-- ggc_post_update.sh
|   |-- ota_pre_update.sh
|   |-- ota_post_update.sh
|-- ota

Ketika managedRespawn diatur ke true, agen pembaruan OTA memeriksa direktori /greengrass-root/usr/scripts untuk skrip ini sebelum dan sesudah pembaruan perangkat lunak. Jika skrip tidak ada, pembaruan gagal. AWS IoT Greengrass tidak memvalidasi isi skrip ini. Sebagai praktik terbaik, verifikasi bahwa skrip Anda berfungsi dengan benar dan mengeluarkan kode keluar yang sesuai untuk kesalahan.

Buat pembaruan OTA

Ikuti langkah-langkah ini untuk melakukan pembaruan OTA dari perangkat lunak AWS IoT Greengrass pada satu atau lebih core:

API CreateSoftwareUpdateJob

Anda dapat menggunakan API CreateSoftwareUpdateJob untuk pembaruan perangkat lunak Core AWS IoT Greengrass atau perangkat lunak agen pembaruan OTA pada perangkat core Anda. API ini membuat tugas snapshot AWS IoT yang memberitahu perangkat ketika pembaruan tersedia. Setelah Anda memanggil CreateSoftwareUpdateJob, Anda dapat menggunakan perintah tugas AWS IoT lainnya untuk melacak pembaruan perangkat lunak. Untuk informasi selengkapnya, lihat Tugas di AWS IoT Panduan Developer.

Contoh berikut menunjukkan cara menggunakan AWS CLI untuk membuat tugas yang memperbarui perangkat lunak Core AWS IoT Greengrass pada perangkat core:

aws greengrass create-software-update-job \
--update-targets-architecture x86_64 \
--update-targets [\"arn:aws:iot:region:123456789012:thing/myCoreDevice\"] \
--update-targets-operating-system ubuntu \
--software-to-update core \
--s3-url-signer-role arn:aws:iam::123456789012:role/myS3UrlSignerRole \
--update-agent-log-level WARN \
--amzn-client-token myClientToken1

Perintah create-software-update-job mengembalikan respons JSON yang berisi tugas ID, tugas ARN, dan versi perangkat lunak yang diinstal oleh pembaruan:

{
    "IotJobId": "GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "IotJobArn": "arn:aws:iot:region:123456789012:job/GreengrassUpdateJob_c3bd7f36-ee80-4d42-8321-a1da0EXAMPLE",
    "PlatformSoftwareVersion": "1.9.2"
}

Untuk langkah-langkah yang menunjukkan bagaimana menggunakan create-software-update-job untuk memperbarui perangkat core, lihat Buat pembaruan OTA.

Perintah create-software-update-job memiliki parameter berikut: