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

Mempersiapkan AWS IoT Lowongan Kerja

AWS IoT Device Management Katalog Paket Perangkat Lunak memperluas AWS IoT Pekerjaan melalui parameter substitusi, dan integrasi dengan pengindeksan AWS IoT armada, grup benda dinamis, dan AWS IoT benda yang dicadangkan bernama shadow.

Parameter substitusi untuk AWS IoT pekerjaan

Anda dapat menggunakan parameter substitusi sebagai placeholder dalam dokumen AWS IoT pekerjaan Anda. Ketika layanan pekerjaan menemukan parameter substitusi, itu mengarahkan pekerjaan ke atribut versi perangkat lunak bernama untuk nilai parameter. Anda dapat menggunakan proses ini untuk membuat dokumen pekerjaan tunggal dan meneruskan metadata ke pekerjaan melalui atribut tujuan umum. Misalnya, Anda dapat meneruskan URL Amazon Simple Storage Service (Amazon S3), paket perangkat lunak Amazon Resource Name (ARN), atau tanda tangan ke dokumen pekerjaan melalui atribut versi paket.

Parameter substitusi harus diformat dalam dokumen pekerjaan sebagai berikut:

Dalam contoh berikut, ada paket perangkat lunak bernama samplePackage dan memiliki versi paket bernama 2.1.5 yang memiliki atribut berikut:

Untuks3URL, parameter dokumen pekerjaan ditulis sebagai berikut:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
}

Untuksignature, parameter dokumen pekerjaan ditulis sebagai berikut:

{
"samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
}

Dokumen pekerjaan lengkap ditulis sebagai berikut:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "${aws:iot:package:samplePackage1:version:2.1.5:attributes:s3URL}"
      },
    ],
    "signature": [
      "samplePackage" : "${aws:iot:package:samplePackage1:version:2.1.5:attributes:signature}"
    ]
  }
}

Setelah substitusi dilakukan, dokumen pekerjaan berikut digunakan ke perangkat:

{
  ...
  "Steps": {
    "uninstall": ["samplePackage"],
    "download": [ 
      { 
        "samplePackage": "https://EXAMPIEBUCKET.s3.us-west-2.amazonaws.com/exampleCodeFile"
      },
    ],
    "signature": [
      "samplePackage" : "aaaaabbbbbcccccdddddeeeeefffffggggghhhhhiiiiijjjj"
    ]
  }
}

Parameter Substitusi (Sebelum dan Sesudah Tampilan)

Parameter substitusi merampingkan pembuatan dokumen pekerjaan menggunakan berbagai flag seperti $default untuk versi paket default. Ini menghilangkan kebutuhan untuk memasukkan metadata versi paket tertentu secara manual untuk setiap penerapan pekerjaan karena flag tersebut diisi secara otomatis dengan metadata yang direferensikan dalam versi paket tertentu. Untuk informasi selengkapnya tentang atribut versi paket seperti $default untuk versi paket default, lihatMempersiapkan dokumen tugas dan versi paket untuk deployment.

Di dalam Konsol Manajemen AWS, alihkan tombol Preview substitusi di jendela editor file instruksi Deployment selama penerapan pekerjaan untuk versi paket untuk melihat dokumen pekerjaan dengan dan tanpa parameter substitusi.

Menggunakan parameter “sebelum-substitusi” di DescribeJob dan GetJobDocument API, Anda dapat melihat respons API sebelum dan sesudah parameter substitusi dihapus. Lihat contoh berikut dengan GetJobDocument API DescribeJob dan:

Untuk informasi selengkapnya tentang AWS IoT Pekerjaan, membuat dokumen pekerjaan, dan menyebarkan pekerjaan, lihat Pekerjaan.

Mempersiapkan dokumen tugas dan versi paket untuk deployment

Ketika versi paket dibuat, itu dalam draft keadaan untuk menunjukkan bahwa itu sedang dipersiapkan untuk penerapan. Untuk menyiapkan versi paket untuk penerapan, Anda harus membuat dokumen pekerjaan, menyimpan dokumen di lokasi yang dapat diakses pekerjaan (seperti Amazon S3), dan mengonfirmasi bahwa versi paket memiliki nilai atribut yang ingin digunakan dokumen pekerjaan. (Catatan: Anda dapat memperbarui atribut untuk versi paket hanya saat berada dalam draft status.)

Saat Anda membuat template AWS IoT Pekerjaan atau Pekerjaan untuk penerapan paket tunggal, Anda memiliki opsi berikut untuk menyesuaikan dokumen pekerjaan Anda:

File instruksi penerapan (recipe)

Artifactatribut versi

Versi Paket

Ketika Anda puas dengan versi paket, terbitkan melalui halaman detail paket perangkat lunak di AWS IoT konsol atau dengan mengeluarkan operasi UpdatePackageVersion API. Anda kemudian dapat mereferensikan versi paket saat Anda membuat pekerjaan baik melalui AWS IoT konsol atau dengan mengeluarkan operasi CreateJob API.

Menamaan paket dan versi saat menerapkan

Untuk menerapkan versi paket perangkat lunak ke perangkat, konfirmasikan paket perangkat lunak dan versi paket yang dirujuk dalam dokumen pekerjaan cocok dengan paket perangkat lunak dan versi paket yang dinyatakan dalam destinationPackageVersions parameter dalam operasi CreateJob API. Jika tidak cocok, Anda akan menerima pesan kesalahan yang meminta Anda untuk membuat kedua referensi cocok. Untuk informasi selengkapnya tentang pesan kesalahan Katalog Paket Perangkat Lunak, lihatPesan Kesalahan Pemecahan Masalah Umum.

Selain paket perangkat lunak dan versi paket yang dirujuk dalam dokumen pekerjaan, Anda dapat menyertakan paket perangkat lunak tambahan dan versi paket dalam destinationPackageVersions parameter dalam operasi CreateJob API yang tidak direferensikan dalam dokumen pekerjaan. Pastikan informasi instalasi yang diperlukan disertakan dalam dokumen pekerjaan agar perangkat dapat menginstal versi paket perangkat lunak tambahan dengan benar. Untuk informasi selengkapnya tentang operasi CreateJob API, lihat CreateJob.

Menargetkan pekerjaan melalui AWS IoT kelompok benda dinamis

Katalog Paket Perangkat Lunak bekerja dengan pengindeksan armada, AWS IoT pekerjaan, dan grup AWS IoT benda dinamis untuk memfilter dan menargetkan perangkat dalam armada Anda untuk memilih versi paket mana yang akan diterapkan ke perangkat Anda. Anda dapat menjalankan kueri pengindeksan armada berdasarkan informasi paket perangkat Anda saat ini dan menargetkan hal-hal tersebut untuk AWS IoT pekerjaan. Anda juga dapat merilis pembaruan perangkat lunak, tetapi hanya untuk perangkat target yang memenuhi syarat. Misalnya, Anda dapat menentukan bahwa Anda ingin menerapkan konfigurasi hanya ke perangkat yang saat ini menjalankaniot-device-client 1.5.09. Untuk informasi selengkapnya, lihat Membuat grup benda dinamis.

Bayangan bernama cadangan dan versi paket

Jika dikonfigurasi, AWS IoT Jobs dapat memperbarui sesuatu yang dicadangkan bernama shadow ($package) ketika pekerjaan berhasil diselesaikan. Jika Anda melakukannya, Anda tidak perlu mengaitkan versi paket secara manual ke sesuatu yang dicadangkan bernama shadow.

Anda dapat memilih untuk mengaitkan atau memperbarui versi paket secara manual ke objek yang dicadangkan bernama shadow dalam situasi berikut:

Anda dapat menambahkan atau memperbarui versi paket ke benda yang dicadangkan bernama shadow ($package) melalui konsol atau operasi UpdateThingShadow API. Untuk informasi selengkapnya, lihat Mengaitkan versi paket dengan AWS IoT sesuatu.

Menghapus instalasi paket perangkat lunak dan versi paketnya

$nulladalah placeholder cadangan yang meminta layanan AWS IoT Jobs untuk menghapus paket perangkat lunak dan versi paket yang ada dari bayangan bernama cadangan perangkat. $package Untuk informasi selengkapnya, lihat Cadangan bernama Cadangan.

Untuk menggunakan fitur ini, ganti nama versi di akhir Nama Sumber Daya PackageVersion Amazon (ARN) tujuan dengan$null. Setelah itu, Anda harus menginstruksikan layanan Anda untuk menghapus perangkat lunak dari perangkat.

ARN resmi menggunakan format berikut:

arn:aws:iot:<regionCode>:111122223333:package/<packageName>/version/$null

Misalnya,

$ aws iot create-job \
    ... \
    --destinationPackageVersions ["arn:aws:iot:us-east-1:111122223333:package/samplePackage/version/$null"]