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

Membuat pembaruan OTA dengan AWS CLI

Saat Anda menggunakan AWS CLI untuk membuat pembaruan OTA, Anda:

Menandatangani pembaruan firmware Anda secara digital

Saat Anda menggunakan AWS CLI untuk melakukan pembaruan OTA, Anda dapat menggunakan Penandatanganan Kode untuk AWS IoT, atau Anda dapat menandatangani pembaruan firmware Anda sendiri. Untuk daftar algoritma penandatanganan kriptografi dan hashing yang didukung oleh Penandatanganan Kode untuk AWS IoT, lihat. SigningConfigurationOverrides Jika Anda ingin menggunakan algoritma kriptografi yang tidak didukung oleh Penandatanganan Kode untuk AWS IoT, Anda harus menandatangani biner firmware sebelum mengunggahnya ke Amazon S3.

Menandatangani gambar firmware Anda dengan Penandatanganan Kode untuk AWS IoT

Untuk menandatangani gambar firmware menggunakan Penandatanganan Kode untuk AWS IoT, Anda dapat menggunakan salah satu AWS SDK atau alat baris perintah. Untuk informasi selengkapnya tentang Penandatanganan Kode untuk AWS IoT, lihat Penandatanganan Kode untuk AWS IoT.

Setelah Anda menginstal dan mengonfigurasi alat penandatanganan kode, salin image firmware yang tidak ditandatangani ke bucket Amazon S3 Anda dan mulai pekerjaan penandatanganan kode dengan perintah berikut. AWS CLI Per put-signing-profile intah membuat profil penandatanganan kode yang dapat digunakan kembali. Per start-signing-job intah memulai pekerjaan penandatanganan.

aws signer put-signing-profile \
    --profile-name your_profile_name \
    --signing-material certificateArn=arn:aws:acm::your-region:your-aws-account-id:certificate/your-certificate-id \
    --platform your-hardware-platform \
    --signing-parameters certname=your_certificate_path_on_device

aws signer start-signing-job \
    --source 's3={bucketName=your_s3_bucket,key=your_s3_object_key,version=your_s3_object_version_id}' \
    --destination 's3={bucketName=your_destination_bucket}' \
    --profile-name your_profile_name

Ini adalah parameter untuk start-signing-job perintah put-signing-profile dan:

Pekerjaan penandatanganan dimulai dan menulis gambar firmware yang ditandatangani ke bucket Amazon S3 tujuan. Nama file untuk gambar firmware yang ditandatangani adalah GUID. Anda memerlukan nama file ini saat membuat streaming. Anda dapat menemukan nama file dengan menelusuri ke konsol Amazon S3 dan memilih bucket Anda. Jika Anda tidak melihat file dengan nama file GUID, segarkan browser Anda.

Perintah ini menampilkan ARN pekerjaan dan ID pekerjaan. Anda membutuhkan nilai-nilai ini nanti. Untuk informasi selengkapnya tentang Penandatanganan Kode untuk AWS IoT, lihat Penandatanganan Kode untuk AWS IoT.

Menandatangani gambar firmware Anda secara manual

Tanda tangani gambar firmware Anda secara digital dan unggah gambar firmware yang ditandatangani ke bucket Amazon S3 Anda.

Membuat aliran pembaruan firmware Anda

Stream adalah antarmuka abstrak untuk data yang dapat dikonsumsi oleh perangkat. Stream dapat menyembunyikan kompleksitas mengakses data yang disimpan di lokasi yang berbeda atau layanan berbasis cloud yang berbeda. Layanan OTA Update Manager memungkinkan Anda menggunakan beberapa bagian data, disimpan di berbagai lokasi di Amazon S3, untuk melakukan Pembaruan OTA.

Saat Anda membuat Pem AWS IoT baruan OTA, Anda juga dapat membuat aliran yang berisi pembaruan firmware yang ditandatangani. Buat file JSON (stream.json) yang mengidentifikasi gambar firmware yang ditandatangani. File JSON harus berisi yang berikut ini.

[
  {
    "fileId":"your_file_id",
    "s3Location":{
      "bucket":"your_bucket_name",
      "key":"your_s3_object_key"
    }
  }   
]

Ini adalah atribut dalam file JSON:

Gunakan perintah create-stream AWS CLI untuk membuat aliran.

aws iot create-stream \
    --stream-id your_stream_id \
    --description your_description \
    --files file://stream.json \
    --role-arn your_role_arn

Ini adalah argumen untuk create-stream AWS CLI perintah:

Untuk menemukan kunci objek Amazon S3 dari gambar firmware yang ditandatangani, gunakan aws signer describe-signing-job --job-id my-job-id perintah where my-job-id is job ID yang ditampilkan oleh create-signing-job AWS CLI perintah. Output dari describe-signing-job perintah berisi kunci gambar firmware yang ditandatangani.

... text deleted for brevity ...
  "signedObject": {
    "s3": {
      "bucketName": "ota-bucket",
      "key": "7309da2c-9111-48ac-8ee4-5a4262af4429"
    }
  }
... text deleted for brevity ...

Membuat pembaruan OTA

Gunakan create-ota-update AWS CLI perintah untuk membuat pekerjaan pembaruan OTA.

aws iot  create-ota-update \
    --ota-update-id value \
    [--description value] \
    --targets value \
    [--protocols value] \
    [--target-selection value] \
    [--aws-job-executions-rollout-config value] \
    [--aws-job-presigned-url-config value] \
    [--aws-job-abort-config value] \
    [--aws-job-timeout-config value] \
    --files value \
    --role-arn value \
    [--additional-parameters value] \
    [--tags value]  \
    [--cli-input-json value] \
    [--generate-cli-skeleton]

cli-input-jsonformat

{
  "otaUpdateId": "string",
  "description": "string",
  "targets": [
    "string"
  ],
  "protocols": [
    "string"
  ],
  "targetSelection": "string",
  "awsJobExecutionsRolloutConfig": {
    "maximumPerMinute": "integer",
    "exponentialRate": {
      "baseRatePerMinute": "integer",
      "incrementFactor": "double",
      "rateIncreaseCriteria": {
        "numberOfNotifiedThings": "integer",
        "numberOfSucceededThings": "integer"
      }
    }
  },
  "awsJobPresignedUrlConfig": {
    "expiresInSec": "long"
  },
  "awsJobAbortConfig": {
    "abortCriteriaList": [
      {
        "failureType": "string",
        "action": "string",
        "thresholdPercentage": "double",
        "minNumberOfExecutedThings": "integer"
      }
    ]
  },
  "awsJobTimeoutConfig": {
    "inProgressTimeoutInMinutes": "long"
  },
  "files": [
    {
      "fileName": "string",
      "fileType": "integer",
      "fileVersion": "string",
      "fileLocation": {
        "stream": {
          "streamId": "string",
          "fileId": "integer"
        },
        "s3Location": {
          "bucket": "string",
          "key": "string",
          "version": "string"
        }
      },
      "codeSigning": {
        "awsSignerJobId": "string",
        "startSigningJobParameter": {
          "signingProfileParameter": {
            "certificateArn": "string",
            "platform": "string",
            "certificatePathOnDevice": "string"
          },
          "signingProfileName": "string",
          "destination": {
            "s3Destination": {
              "bucket": "string",
              "prefix": "string"
            }
          }
        },
        "customCodeSigning": {
          "signature": {
            "inlineDocument": "blob"
          },
          "certificateChain": {
            "certificateName": "string",
            "inlineDocument": "string"
          },
          "hashAlgorithm": "string",
          "signatureAlgorithm": "string"
        }
      },
      "attributes": {
        "string": "string"
      }
    }
  ],
  "roleArn": "string",
  "additionalParameters": {
    "string": "string"
  },
  "tags": [
    {
      "Key": "string",
      "Value": "string"
    }
  ]
}

Output

{
  "otaUpdateId": "string",
  "awsIotJobId": "string",
  "otaUpdateArn": "string",
  "awsIotJobArn": "string",
  "otaUpdateStatus": "string"
}

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update perintah yang menggunakan Penandatanganan Kode untuk AWS IoT.

[
  {
    "fileName": "firmware.bin",                
    "fileType": 1,
    "fileLocation": {
      "stream": {
        "streamId": "004",                         
        "fileId":123
      }                        
    },
    "codeSigning": {
      "awsSignerJobId": "48c67f3c-63bb-4f92-a98a-4ee0fbc2bef6"     
    }
  }
]

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update AWS CLI perintah yang menggunakan file inline untuk menyediakan materi penandatanganan kode khusus.

[
  {
    "fileName": "firmware.bin",
    "fileType": 1,
    "fileLocation": {
      "stream": {
        "streamId": "004",
        "fileId": 123
      }
    },
    "codeSigning": {
      "customCodeSigning":{
        "signature":{
          "inlineDocument":"your_signature"
        },
        "certificateChain": {
          "certificateName": "your_certificate_name",
          "inlineDocument":"your_certificate_chain"
        },
        "hashAlgorithm":"your_hash_algorithm",
        "signatureAlgorithm":"your_signature_algorithm"
      }
    }
  }
]

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update AWS CLI perintah yang memungkinkan FreeRTOS OTA untuk memulai pekerjaan penandatanganan kode dan membuat profil penandatanganan kode dan streaming.

[
  {
    "fileName": "your_firmware_path_on_device",
    "fileType": 1,
    "fileVersion": "1",
    "fileLocation": {
      "s3Location": {
        "bucket": "your_bucket_name",
        "key": "your_object_key",
        "version": "your_S3_object_version"
      }
    },
    "codeSigning":{
      "startSigningJobParameter":{
        "signingProfileName": "myTestProfile",
        "signingProfileParameter": {
          "certificateArn": "your_certificate_arn",
          "platform": "your_platform_id",
          "certificatePathOnDevice": "certificate_path"
        },
        "destination": {
          "s3Destination": {
            "bucket": "your_destination_bucket"
          }
        }
      }
    }  
  }
]

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update AWS CLI perintah yang membuat pembaruan OTA yang memulai pekerjaan penandatanganan kode dengan profil yang ada dan menggunakan aliran yang ditentukan.

[
  {
    "fileName": "your_firmware_path_on_device",
    "fileType": 1,
    "fileVersion": "1",
    "fileLocation": {
      "s3Location": {
        "bucket": "your_s3_bucket_name",
        "key": "your_object_key",
        "version": "your_S3_object_version"
      }
    },
    "codeSigning":{
      "startSigningJobParameter":{
        "signingProfileName": "your_unique_profile_name",
        "destination": {
          "s3Destination": {
            "bucket": "your_destination_bucket"
          }
        }
      }
    }  
  }
]

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update AWS CLI perintah yang memungkinkan FreeRTOS OTA untuk membuat aliran dengan ID pekerjaan penandatanganan kode yang ada.

[
  {
    "fileName": "your_firmware_path_on_device",
    "fileType": 1,
    "fileVersion": "1",
    "codeSigning":{
      "awsSignerJobId": "your_signer_job_id"
    }  
  }
]

Berikut ini adalah contoh file JSON yang diteruskan ke create-ota-update AWS CLI perintah yang membuat pembaruan OTA. Pembaruan membuat aliran dari objek S3 yang ditentukan dan menggunakan penandatanganan kode khusus.

[
  {
    "fileName": "your_firmware_path_on_device",
    "fileType": 1,
    "fileVersion": "1",
    "fileLocation": {
      "s3Location": {
        "bucket": "your_bucket_name",
        "key": "your_object_key",
        "version": "your_S3_object_version"
      }
    },
    "codeSigning":{
      "customCodeSigning": {
        "signature":{
          "inlineDocument":"your_signature"
        },
        "certificateChain": {
          "inlineDocument":"your_certificate_chain",
          "certificateName": "your_certificate_path_on_device"
        },
        "hashAlgorithm":"your_hash_algorithm",
        "signatureAlgorithm":"your_sig_algorithm"
      }
    }  
  }
]

Mendaftarkan pembaruan OTA

Anda dapat menggunakan list-ota-updates AWS CLI perintah untuk mendapatkan daftar semua pembaruan OTA.

aws iot list-ota-updates

Output dari list-ota-updates perintah terlihat seperti ini.

{
  "otaUpdates": [
     
    {
      "otaUpdateId": "my_ota_update2",
      "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/my_ota_update2",
      "creationDate": 1522778769.042
    },
    {
      "otaUpdateId": "my_ota_update1",
      "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/my_ota_update1",
      "creationDate": 1522775938.956
    },
    {
      "otaUpdateId": "my_ota_update",
      "otaUpdateArn": "arn:aws:iot:us-west-2:123456789012:otaupdate/my_ota_update",
      "creationDate": 1522775151.031
    }
  ]
}

Mendapatkan informasi tentang pembaruan OTA

Anda dapat menggunakan get-ota-update AWS CLI perintah untuk mendapatkan status pembuatan atau penghapusan pembaruan OTA.

aws iot get-ota-update --ota-update-id your-ota-update-id

Output dari get-ota-update perintah terlihat seperti berikut ini.

{ 
    "otaUpdateInfo": { 
        "otaUpdateId": "ota-update-001", 
        "otaUpdateArn": "arn:aws:iot:region:123456789012:otaupdate/ota-update-001", 
        "creationDate": 1575414146.286, 
        "lastModifiedDate": 1575414149.091, 
        "targets": [ 
            "arn:aws:iot:region:123456789012:thing/myDevice" 
        ], 
        "protocols": [ "HTTP" ], 
        "awsJobExecutionsRolloutConfig": { 
            "maximumPerMinute": 0 
        }, 
        "awsJobPresignedUrlConfig": { 
            "expiresInSec": 1800 
        }, 
        "targetSelection": "SNAPSHOT", 
        "otaUpdateFiles": [ 
            { 
                "fileName": "my_firmware.bin", 
                "fileType": 1,
                "fileLocation": { 
                    "s3Location": { 
                        "bucket": "my-bucket", 
                        "key": "my_firmware.bin", 
                        "version": "AvP3bfJC9gyqnwoxPHuTqM5GWENt4iii" 
                    } 
                }, 
                "codeSigning": { 
                    "awsSignerJobId": "b7a55a54-fae5-4d3a-b589-97ed103737c2", 
                    "startSigningJobParameter": { 
                        "signingProfileParameter": {}, 
                        "signingProfileName": "my-profile-name", 
                        "destination": { 
                            "s3Destination": { 
                                "bucket": "some-ota-bucket", 
                                "prefix": "SignedImages/" 
                            } 
                        } 
                    }, 
                    "customCodeSigning": {} 
                } 
            } 
        ], 
        "otaUpdateStatus": "CREATE_COMPLETE", 
        "awsIotJobId": "AFR_OTA-ota-update-001", 
        "awsIotJobArn": "arn:aws:iot:region:123456789012:job/AFR_OTA-ota-update-001" 
    } 
}

Nilai yang dikembalikan untuk otaUpdateStatus termasuk yang berikut:

Menghapus OTA-related data

Saat ini, Anda tidak dapat menggunakan AWS IoT konsol untuk menghapus streaming atau pembaruan OTA. Anda dapat menggunakan AWS CLI untuk menghapus aliran, pembaruan OTA, dan AWS IoT pekerjaan yang dibuat selama pembaruan OTA.

Menghapus aliran OTA

Saat Anda membuat pembaruan OTA yang menggunakan MQTT, Anda dapat menggunakan baris perintah atau AWS IoT konsol untuk membuat aliran untuk memecah firmware menjadi beberapa bagian sehingga dapat dikirim melalui MQTT. Anda dapat menghapus aliran ini dengan delete-stream AWS CLI perintah, seperti yang ditunjukkan pada contoh berikut.

aws iot delete-stream --stream-id your_stream_id

Menghapus pembaruan OTA

Saat Anda membuat pembaruan OTA, berikut ini dibuat:

Per delete-ota-update intah menghapus entri di database pekerjaan pembaruan OTA saja. Anda harus menggunakan delete-job perintah untuk menghapus AWS IoT pekerjaan.

Gunakan delete-ota-update perintah untuk menghapus pembaruan OTA.

aws iot delete-ota-update --ota-update-id your_ota_update_id

Menghapus pekerjaan IoT yang dibuat untuk pembaruan OTA

FreeRTOS membuat AWS IoT pekerjaan saat Anda membuat pembaruan OTA. Eksekusi pekerjaan juga dibuat untuk setiap perangkat yang memproses pekerjaan. Anda dapat menggunakan delete-job AWS CLI perintah untuk menghapus pekerjaan dan eksekusi pekerjaan yang terkait.

aws iot delete-job --job-id your-job-id --no-force

no-forceParameter menentukan bahwa hanya pekerjaan yang berada dalam status terminal (SELESAI atau DIBATALKAN) dapat dihapus. Anda dapat menghapus pekerjaan yang berada dalam keadaan non-terminal dengan meneruskan force parameter. Untuk informasi selengkapnya, lihat DeleteJob API.

Bergantung pada jumlah eksekusi pekerjaan yang dibuat untuk pekerjaan dan faktor lainnya, perlu beberapa menit untuk menghapus pekerjaan. Saat pekerjaan sedang dihapus, statusnya adalah DELETION_IN_PROGRESS. Mencoba menghapus atau membatalkan pekerjaan yang statusnya sudah DELETION_IN_PROGRESS menghasilkan kesalahan.

Anda dapat menggunakan delete-job-execution untuk menghapus eksekusi pekerjaan. Anda mungkin ingin menghapus eksekusi pekerjaan ketika sejumlah kecil perangkat tidak dapat memproses pekerjaan. Ini menghapus eksekusi pekerjaan untuk satu perangkat, seperti yang ditunjukkan pada contoh berikut.

aws iot delete-job-execution --job-id your-job-id --thing-name
                    your-thing-name --execution-number your-job-execution-number --no-force

Seperti delete-job AWS CLI perintah, Anda dapat meneruskan --force parameter ke delete-job-execution untuk memaksa penghapusan eksekusi pekerjaan. Untuk informasi selengkapnya, lihat DeleteJobExecution API.

Untuk informasi lebih lanjut tentang menggunakan aplikasi demo pembaruan OTA, lihatOver-the-air memperbarui aplikasi demo.