View a markdown version of this page

Konsep kunci pekerjaan - AWS IoT Core

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

Konsep kunci pekerjaan

Konsep berikut memberikan detail tentang AWS IoT Jobs dan cara membuat dan menerapkan pekerjaan untuk menjalankan operasi jarak jauh di perangkat Anda.

Konsep dasar

Berikut ini adalah konsep dasar yang harus Anda ketahui saat menggunakan AWS IoT Jobs.

Pekerjaan

Pekerjaan adalah operasi jarak jauh yang dikirim ke dan dijalankan pada satu atau lebih perangkat yang terhubung ke AWS IoT. Misalnya, Anda dapat menentukan pekerjaan yang menginstruksikan serangkaian perangkat untuk mengunduh dan menginstal aplikasi atau menjalankan pembaruan firmware, me-reboot, memutar sertifikat, atau melakukan operasi pemecahan masalah jarak jauh.

Dokumen pekerjaan

Untuk membuat pekerjaan, Anda harus terlebih dahulu membuat dokumen pekerjaan yang merupakan deskripsi operasi jarak jauh yang akan dilakukan oleh perangkat.

Dokumen pekerjaan adalah dokumen JSON yang UTF-8 dikodekan dan berisi informasi yang diperlukan perangkat Anda untuk melakukan pekerjaan. Dokumen pekerjaan berisi satu atau lebih URL tempat perangkat dapat mengunduh pembaruan atau data lainnya. Dokumen pekerjaan dapat disimpan dalam bucket Amazon S3, atau disertakan sebaris dengan perintah yang membuat pekerjaan.

catatan

Dalam respons MQTT, jobDocument bidang adalah objek JSON. Dalam respons HTTP, ini adalah representasi string dari objek JSON.

Target

Saat Anda membuat pekerjaan, Anda menentukan daftar target yang merupakan perangkat yang harus melakukan operasi. Targetnya bisa berupa benda atau kelompok benda atau keduanya. Layanan AWS IoT Jobs mengirimkan pesan ke setiap target untuk menginformasikan bahwa pekerjaan tersedia.

Deployment

Setelah Anda membuat pekerjaan dengan menyediakan dokumen pekerjaan dan menentukan daftar target Anda, dokumen pekerjaan kemudian digunakan ke perangkat target jarak jauh yang ingin Anda lakukan pembaruannya. Untuk pekerjaan snapshot, pekerjaan akan selesai setelah digunakan ke perangkat target. Untuk pekerjaan berkelanjutan, pekerjaan dikerahkan ke grup perangkat saat ditambahkan ke grup.

Eksekusi pekerjaan

Eksekusi pekerjaan adalah contoh pekerjaan pada perangkat target. Target memulai eksekusi pekerjaan dengan mengunduh dokumen pekerjaan. Kemudian melakukan operasi yang ditentukan dalam dokumen, dan melaporkan kemajuannya ke AWS IoT. Nomor eksekusi adalah pengidentifikasi unik dari eksekusi pekerjaan pada target tertentu. Layanan AWS IoT Jobs menyediakan perintah untuk melacak kemajuan eksekusi pekerjaan pada target dan kemajuan pekerjaan di semua target.

Konsep jenis pekerjaan

Konsep berikut dapat membantu Anda memahami lebih banyak tentang berbagai jenis pekerjaan yang dapat Anda buat dengan AWS IoT Pekerjaan.

Pekerjaan snapshot

Secara default, pekerjaan dikirim ke semua target yang Anda tentukan saat membuat pekerjaan. Setelah target tersebut menyelesaikan pekerjaan (atau melaporkan bahwa mereka tidak dapat melakukannya), pekerjaan selesai.

Pekerjaan berkelanjutan

Pekerjaan berkelanjutan dikirim ke semua target yang Anda tentukan saat Anda membuat pekerjaan. Ini terus berjalan dan dikirim ke perangkat baru (hal) yang ditambahkan ke kelompok target. Misalnya, pekerjaan berkelanjutan dapat digunakan untuk meng-onboard atau meng-upgrade perangkat saat ditambahkan ke grup. Anda dapat membuat pekerjaan terus menerus dengan menetapkan parameter opsional saat Anda membuat pekerjaan.

catatan

Saat menargetkan armada IoT Anda menggunakan grup benda dinamis, sebaiknya gunakan pekerjaan berkelanjutan alih-alih pekerjaan snapshot. Dengan menggunakan pekerjaan berkelanjutan, perangkat yang bergabung dengan grup menerima eksekusi pekerjaan bahkan setelah pekerjaan dibuat.

URL yang ditandatangani sebelumnya

Untuk akses aman dan terbatas waktu ke data yang tidak disertakan dalam dokumen pekerjaan, Anda dapat menggunakan URL Amazon S3 yang telah ditandatangani sebelumnya. Tempatkan data Anda di bucket Amazon S3 dan tambahkan tautan placeholder ke data dalam dokumen pekerjaan. Ketika AWS IoT Jobs menerima permintaan untuk dokumen pekerjaan, Jobs akan mengurai dokumen pekerjaan dengan mencari tautan placeholder, dan kemudian mengganti tautan dengan URL Amazon S3 yang telah ditandatangani sebelumnya.

Tautan placeholder dalam format berikut:

${aws:iot:s3-presigned-url:https://s3.amazonaws.com/bucket/key}

di bucket mana nama bucket Anda dan key merupakan objek di bucket yang Anda tautkan.

Di Wilayah Beijing dan Ningxia, URL yang ditandatangani sebelumnya hanya berfungsi jika pemilik sumber daya memiliki lisensi ICP (Internet Content Provider). Untuk informasi selengkapnya, lihat Amazon Simple Storage Service di dokumentasi Mem AWS ulai dengan Layanan di China.

Konsep konfigurasi pekerjaan

Konsep berikut dapat membantu Anda memahami cara mengonfigurasi pekerjaan.

Peluncuran

Anda dapat menentukan seberapa cepat target diberitahu tentang eksekusi pekerjaan yang tertunda. Ini memungkinkan Anda membuat peluncuran bertahap untuk mengelola pembaruan, reboot, dan operasi lainnya dengan lebih baik. Anda dapat membuat konfigurasi peluncuran dengan menggunakan tingkat peluncuran statis atau tingkat peluncuran eksponensial. Untuk menentukan jumlah maksimum target pekerjaan yang akan diinformasikan per menit, gunakan tingkat peluncuran statis.

Untuk contoh pengaturan tingkat peluncuran dan untuk informasi selengkapnya tentang mengonfigurasi peluncuran pekerjaan, lihat. Peluncuran pekerjaan, penjadwalan, dan konfigurasi pembatalan

Penjadwalan

Penjadwalan pekerjaan memungkinkan Anda menjadwalkan jangka waktu peluncuran dokumen pekerjaan ke semua perangkat dalam kelompok target untuk pekerjaan berkelanjutan dan snapshot. Selain itu, Anda dapat membuat jendela pemeliharaan opsional yang berisi tanggal dan waktu tertentu saat pekerjaan akan meluncurkan dokumen pekerjaan ke semua perangkat dalam grup target. Jendela pemeliharaan adalah instance berulang dengan frekuensi tanggal dan waktu harian, mingguan, bulanan, atau kustom yang dipilih selama pembuatan pekerjaan awal atau templat pekerjaan. Hanya pekerjaan berkelanjutan yang dapat dijadwalkan untuk melakukan peluncuran selama jendela pemeliharaan.

Penjadwalan Pekerjaan khusus untuk pekerjaan Anda. Eksekusi Pekerjaan Individu tidak dapat dijadwalkan. Untuk informasi selengkapnya, lihat Peluncuran pekerjaan, penjadwalan, dan konfigurasi pembatalan.

Batalkan

Anda dapat membuat serangkaian kondisi untuk membatalkan peluncuran ketika kriteria yang Anda tentukan telah terpenuhi. Untuk informasi selengkapnya, lihat Peluncuran pekerjaan, penjadwalan, dan konfigurasi pembatalan.

Waktu habis

Waktu tunggu pekerjaan memberi tahu Anda setiap kali penerapan pekerjaan terjebak dalam IN_PROGRESS status untuk jangka waktu yang tidak terduga lama. Ada dua jenis timer: timer dalam proses dan timer langkah. Saat pekerjaan selesaiIN_PROGRESS, Anda dapat memantau dan melacak kemajuan penerapan pekerjaan Anda.

Konfigurasi peluncuran dan pembatalan khusus untuk pekerjaan Anda, sedangkan konfigurasi batas waktu khusus untuk penerapan pekerjaan. Untuk informasi selengkapnya, lihat Batas waktu eksekusi pekerjaan dan konfigurasi coba lagi.

Mencoba lagi

Percobaan ulang pekerjaan memungkinkan untuk mencoba lagi eksekusi pekerjaan ketika pekerjaan gagal, waktu habis, atau keduanya. Anda dapat melakukan hingga 10 percobaan ulang untuk menjalankan pekerjaan. Anda dapat memantau dan melacak kemajuan upaya percobaan ulang dan apakah eksekusi pekerjaan berhasil.

Konfigurasi peluncuran dan pembatalan khusus untuk pekerjaan Anda, sedangkan konfigurasi batas waktu dan coba ulang khusus untuk eksekusi pekerjaan. Untuk informasi selengkapnya, lihat Batas waktu eksekusi pekerjaan dan konfigurasi coba lagi.