Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

使用 Amazon CLI 创建 OTA 更新

在使用 Amazon CLI 创建 OTA 更新时，您将：

对固件更新进行数字签名

在使用 Amazon CLI 执行 OTA 更新时，您可以使用 Code Signing for Amazon IoT，也可以自行对固件更新进行签名。有关 Code Signing for Amazon IoT 支持的加密签名和哈希算法的列表，请参阅 SigningConfigurationOverrides。如果要使用适用于 Amazon IoT 的代码签名不支持的加密算法，您必须先对固件二进制文件进行签名，然后再将其上传到 Amazon S3 中。

使用 Code Signing for Amazon IoT 对固件映像进行签名

要使用适用于 Amazon IoT 的代码签名对固件映像进行签名，您可以使用 Amazon 开发工具包或命令行工具之一。有关 Code Signing for Amazon IoT 的更多信息，请参阅 Code Signing for Amazon IoT。

安装并配置代码签名工具后，将未签名的固件映像复制到 Amazon S3 存储桶中，并使用以下 Amazon CLI 命令启动代码签名作业。put-signing-profile 命令用于创建一个可重复使用的代码签名配置文件。start-signing-job 命令用于启动签名作业。

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

以下是 put-signing-profile 和 start-signing-job 命令的参数：

签名作业启动，将已签名的固件映像写入目标 Amazon S3 存储桶。已签名的固件映像的文件名是 GUID。创建流时将需要此文件名。浏览至 Amazon S3 控制台并选择存储桶即可找到此文件名。如果没有看到带有 GUID 文件名的文件，可刷新浏览器。

此命令将显示作业 ARN 和作业 ID。稍后会需要这些值。有关 Code Signing for Amazon IoT 的更多信息，请参阅 Code Signing for Amazon IoT。

手动签署固件映像

对固件映像进行数字签名，并将已签名的固件映像上传到 Amazon S3 存储桶。

创建固件更新流

流是设备可以使用的数据的抽象接口。流可以隐藏访问存储在不同位置或各种基于云的服务中的数据的复杂性。利用 OTA Update Manager 服务，您可以使用存储在 Amazon S3 中的各个位置的多个数据段来执行 OTA 更新。

在创建 Amazon IoT OTA 更新时，还可以创建包含已签名的固件更新的流。创建一个 JSON 文件 (stream.json)，该文件标识已签名的固件映像。JSON 文件应包含以下内容。

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

以下是 JSON 文件中的属性：

使用 create-stream Amazon CLI 命令创建流。

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

以下是 create-stream Amazon CLI CLI 命令的参数：

要查找已签名的固件映像的 Amazon S3 对象密钥，可使用 aws signer describe-signing-job --job-id my-job-id 命令，其中 my-job-id 是 create-signing-job Amazon CLI CLI 命令所显示的作业 ID。describe-signing-job 命令的输出中包含已签名的固件映像的密钥。

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

创建 OTA 更新

可以使用 create-ota-update Amazon CLI 命令创建一个 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-json 格式

{
  "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"
    }
  ]
}

输出

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

以下示例说明了如何将 JSON 文件传递到 create-ota-update 命令，该命令使用 Code Signing for Amazon IoT。

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

以下示例说明了如何将 JSON 文件传递到 create-ota-update Amazon CLI 命令，该命令使用内联文件提供自定义代码签名材料。

[
  {
    "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"
      }
    }
  }
]

以下示例说明了如何将 JSON 文件传递到 create-ota-update Amazon CLI 命令，该命令允许 FreeRTOS OTA 启动代码签名作业并创建代码签名配置文件和流。

[
  {
    "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"
          }
        }
      }
    }  
  }
]

以下示例说明了如何将 JSON 文件传递到 create-ota-update Amazon CLI 命令，该命令创建一个 OTA 更新以使用现有配置文件启动代码签名作业并使用指定的流。

[
  {
    "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"
          }
        }
      }
    }  
  }
]

以下示例说明了如何将 JSON 文件传递到 create-ota-update Amazon CLI 命令，该命令允许 FreeRTOS OTA 使用现有代码签名作业 ID 创建一个流。

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

以下示例说明了如何将 JSON 文件传递到 create-ota-update Amazon CLI 命令，该命令创建一个 OTA 更新。该更新根据指定的 S3 对象创建一个流，并使用自定义代码签名。

[
  {
    "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"
      }
    }  
  }
]

列出 OTA 更新

您可以使用 list-ota-updates Amazon CLI 命令获取所有 OTA 更新的列表。

aws iot list-ota-updates

list-ota-updates 命令输出如下所示。

{
  "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
    }
  ]
}

获取有关 OTA 更新的信息

您可以使用 get-ota-update Amazon CLI 命令获取 OTA 更新的创建或删除状态。

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

get-ota-update 命令的输出如下所示。

{ 
    "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" 
    } 
}

otaUpdateStatus 返回的值包括：

删除与 OTA 相关的数据

目前还不能使用 Amazon IoT 控制台来删除流或 OTA 更新。可以使用 Amazon CLI 来删除流、OTA 更新以及在 OTA 更新过程中创建的 Amazon IoT 作业。

删除 OTA 流

在创建使用 MQTT 的 OTA 更新时，可以使用命令行或 Amazon IoT 控制台创建流，以将固件分割为多个数据块，以便能通过 MQTT 进行发送。您可以使用 delete-stream Amazon CLI 命令删除该流，如以下示例中所示。

aws iot delete-stream --stream-id your_stream_id

删除 OTA 更新

在创建 OTA 更新时，将创建以下各项：

delete-ota-update 命令仅删除 OTA 更新作业数据库中的条目。必须使用 delete-job 命令来删除 Amazon IoT 作业。

可以使用 delete-ota-update 命令删除一个 OTA 更新。

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

删除为 OTA 更新创建的 IoT 作业

在创建 OTA 更新时，FreeRTOS 会创建 Amazon IoT 作业。也会为处理作业的每个设备创建作业执行。您可以使用 delete-job Amazon CLI 命令删除一个作业及其关联的作业执行。

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

no-force 参数指定只能删除处于结束状态（COMPLETED 或 CANCELLED）的作业。可以通过传递 force 参数来删除处于非结束状态的作业。有关更多信息，请参阅 DeleteJob API。

删除作业可能需要几分钟时间，具体取决于为作业创建的作业执行数量以及其他因素。在删除作业的过程中，其状态为 DELETION_IN_PROGRESS。试图删除或取消已处于 DELETION_IN_PROGRESS 状态的作业将导致错误。

可以使用 delete-job-execution 删除作业执行。如果设备数量太少无法处理作业，您可能希望删除作业执行。这会删除单个设备的作业执行，如以下示例中所示。

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

如同 delete-job Amazon CLI 命令一样，可以将 --force 参数传递到 delete-job-execution 以强制删除作业执行。有关更多信息，请参阅 DeleteJobExecution API。

有关使用 OTA 更新应用程序的更多信息，请参阅无线更新演示应用程序。