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 rincian 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.

Job

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

Dokumen Job

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

Dokumen Job adalah dokumen JSON yang dikodekan UTF-8 dan berisi informasi yang diperlukan perangkat Anda untuk melakukan pekerjaan. Dokumen pekerjaan berisi satu atau beberapa 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.

Tip

Untuk contoh dokumen pekerjaan, lihat contoh jobs-agent.js di AWS IoT SDK untuk JavaScript.

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 disebarkan ke perangkat target jarak jauh yang ingin Anda lakukan pembaruannya. Untuk pekerjaan snapshot, pekerjaan akan selesai setelah menerapkan ke perangkat target. Untuk pekerjaan berkelanjutan, pekerjaan dikerahkan ke sekelompok perangkat saat ditambahkan ke grup.

Eksekusi Job

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 pelaksanaan pekerjaan pada target dan kemajuan pekerjaan di semua target.

Konsep tipe pekerjaan

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

Pekerjaan snapshot

Secara default, pekerjaan dikirim ke semua target yang Anda tentukan saat Anda 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-hal) yang ditambahkan ke grup target. Misalnya, pekerjaan berkelanjutan dapat digunakan untuk onboard atau upgrade perangkat saat ditambahkan ke grup. Anda dapat membuat pekerjaan berkelanjutan dengan menetapkan parameter opsional saat Anda membuat pekerjaan.

catatan

Saat menargetkan armada IoT Anda menggunakan grup benda dinamis, kami sarankan Anda menggunakan 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 data yang aman dan terbatas waktu yang tidak disertakan dalam dokumen pekerjaan, Anda dapat menggunakan URL Amazon S3 yang telah ditetapkan 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, itu mem-parsing dokumen pekerjaan dengan mencari tautan placeholder, dan kemudian mengganti tautan dengan URL Amazon S3 yang telah ditetapkan sebelumnya.

Tautan placeholder dalam format berikut:

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

di mana bucket adalah nama bucket Anda dan kuncinya adalah objek dalam ember yang Anda tautkan.

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

Konsep konfigurasi Job

Konsep-konsep berikut dapat membantu Anda memahami cara mengkonfigurasi pekerjaan.

Peluncuran

Anda dapat menentukan seberapa cepat target diberi tahu 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 tarif peluncuran dan untuk informasi selengkapnya tentang mengonfigurasi peluncuran pekerjaan, lihat. Peluncuran pekerjaan, penjadwalan, dan membatalkan konfigurasi

Penjadwalan

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

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

Batalkan

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

Timeout

Batas waktu kerja memberi tahu Anda setiap kali penerapan pekerjaan macet di IN_PROGRESS negara bagian untuk jangka waktu yang sangat lama. Ada dua jenis pengatur waktu: pengatur waktu dalam proses dan pengatur waktu langkah. Ketika pekerjaan ituIN_PROGRESS, Anda dapat memantau dan melacak kemajuan penyebaran pekerjaan Anda.

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

Mencoba lagi

Job retries memungkinkan untuk mencoba kembali eksekusi pekerjaan ketika pekerjaan gagal, waktu habis, atau keduanya. Anda dapat memiliki hingga 10 percobaan ulang untuk melaksanakan pekerjaan itu. Anda dapat memantau dan melacak kemajuan upaya percobaan ulang Anda dan apakah eksekusi pekerjaan berhasil.

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