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

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

使用创建 OTA 更新 Amazon CLI

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

对固件更新进行数字签名

当您使用执行 Amazon CLI OTA 更新时，可以使用代码签名 Amazon IoT，也可以自己签署固件更新。有关代码签名支持的加密签名和哈希算法的列表 Amazon IoT，请参阅。 SigningConfigurationOverrides 如果您想使用代码签名不支持的加密算法，则必须先对固件二进制文件进行签名 Amazon IoT，然后才能将其上传到 Amazon S3。

使用代码签名对固件映像进行签名 Amazon IoT

要使用代码签名对固件映像进行签名 Amazon IoT，可以使用Amazon 软件开发工具包或命令行工具之一。有关代码签名的更多信息 Amazon IoT，请参阅的代码签名 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。稍后会需要这些值。有关代码签名的更多信息 Amazon IoT，请参阅的代码签名 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 命令的参数：

要查找已签名固件映像的 Amazon S3 对象密钥，请使用aws signer describe-signing-job --job-id my-job-id命令，其中my-job-idcreate-signing-job Amazon 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"
    }
  ]
}

Output

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

以下是传递到使用代码签名的create-ota-update命令中的 JSON 文件的示例 Amazon IoT。

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

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

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

以下是传递到create-ota-update Amazon CLI 命令的 JSON 文件示例，该文件允许 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"
          }
        }
      }
    }  
  }
]

以下是传递到create-ota-update Amazon CLI 命令中的 JSON 文件的示例，该文件创建 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"
          }
        }
      }
    }  
  }
]

以下是传递到create-ota-update Amazon CLI 命令中的 JSON 文件示例，该文件允许 FreeRTOS OTA 使用现有的代码签名任务 ID 创建流。

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

以下是传递给创建 OTA 更新的create-ota-update Amazon CLI 命令的 JSON 文件的示例。该更新根据指定的 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-related 数据

目前，您无法使用 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 作业

FreeRTOS 会在您创建 OTA 更新时创建 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 更新应用程序的更多信息，请参阅Over-the-air 更新演示应用程序。