SageMaker 边缘管理器 - Amazon IoT Greengrass
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

SageMaker 边缘管理器

亚 Amazon SageMaker 边缘管理器组件 (aws.greengrass.SageMakerEdgeManager)会安装 SageMaker 边缘管理器代理二进制文件。

SageMaker Edge Manager 为边缘设备提供模型管理,因此您可以优化、保护、监控和维护边缘设备队列上的机器学习模型。SageMaker 边缘管理器组件可在核心设备上安装和管理 SageMaker 边缘管理器代理的生命周期。您还可以使用 SageMaker 边缘管理器打包和使用 SageMaker Neo 编译的模型作为 Greengrass 核心设备上的模型组件。有关在核心设备上使用 SageMaker 边缘管理器代理的详细信息,请参阅在 Greengrass 核心设备上使用 Amazon SageMaker 边缘管理器

SageMaker 边缘管理器组件 v1.0.0 安装边缘管理器代理二进制文件 v1.20210512.96da6cc。有关 Edge Manager 代理二进制版本的更多信息,请参阅边缘管理器代理

注意

SageMaker Edge Manager 组件在以下 Amazon Web Services 区域 :

  • 美国东部 (俄亥俄)

  • 美国东部(弗吉尼亚北部)

  • 美国西部(俄勒冈)

  • 欧洲(法兰克福)

  • 欧洲 (爱尔兰)

  • 亚太区域(东京)

Versions

此组件具有以下版本:

  • 1.0.x

Type

此组件是一个通用组件 (aws.greengrass.generic)。这些区域有:Greengrass 核心运行组件的生命周期脚本。

有关更多信息,请参阅 组件类型

Requirements

此组件具有以下要求:

  • 在以下一个平台上运行的 Greengrass 核心设备:

    • 基于 Debian 的 Linux,如乌班图

    • Linux Armv8 (AArch64)

  • 这些区域有:Greengrass 设备角色配置如下:

    • 这些区域有:卓越亚马逊电子邮件设备政策IAM 托管策略。

    • 这些区域有:s3:PutObject操作,如以下 IAM 策略示例所示。

      { "Version": "2012-10-17", "Statement": [ { "Action": [ "s3:PutObject" ], "Resource": [ "*" ], "Effect": "Allow" } ] }
    • 允许的信任关系credentials.iot.amazonaws.comsagemaker.amazonaws.com代入角色,如以下 IAM 策略示例所示。

      { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "credentials.iot.amazonaws.com" }, "Action": "sts:AssumeRole" }, { "Effect": "Allow", "Principal": { "Service": "sagemaker.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
  • 在同一个 Amazon Web Services 账户 和 Amazon Web Services 区域 作为您的 Greengrass 核心设备。SageMaker Edge Manager 需要一个 S3 存储桶来创建边缘设备队列,并在您的设备上存储运行推理的示例数据。有关创建 S3 存储桶的信息,请参阅Amazon S3 入门

  • SageMaker 边缘设备队列,使用相同Amazon IoT角色别名作为 Greengrass 核心设备。有关更多信息,请参阅 创建边缘设备队列

  • 您的 Greengrass 核心设备在 SageMaker Edge 设备队列中注册为边缘设备。边缘设备名称必须与Amazon IoT事物名称。有关更多信息,请参阅 注册您的 Greengrass 核心设备

Dependencies

部署组件时,Amazon IoT Greengrass还部署其依赖关系的兼容版本。这意味着您必须满足组件及其所有依赖关系的要求才能成功部署组件。本部分列出了对应的依赖项。发布版本以及定义每个依赖关系的组件版本的语义版本约束。您也可以在中查看每一版的组件各个版的中的依赖关系。Amazon IoT Greengrass控制台。在组件详细信息页面上,查找依赖项列表。

1.0.1

下表列出此组件版本 1.0.1 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核心 >=2.0.0 软性
令牌交换服务 >=0.0 硬性
1.0.0

下表列出此组件版本 1.0.0 的依赖关系。

依赖关系 兼容版本 依赖关系类型
Greengrass 核心 >=2.0.0 软性
令牌交换服务 >=0.0 硬性

有关组件依赖项的更多信息,请参阅。组件配方参考

Configuration

此组件提供了以下配置参数,您可以在部署组件时自定义这些参数。

注意

本节介绍您在组件中设置的配置参数。有关相应的 SageMaker Edge Manager 配置的更多信息,请参阅。边缘管理器代理中的Amazon SageMaker 开发人员指南

DeviceFleetName

包含您的 Greengrass 核心设备的 SageMaker 边缘管理器设备队列的名称。

部署此组件时,必须在配置更新中为此参数指定一个值。

BucketName

将捕获的推断数据上传到的 S3 存储桶的名称。存储桶名称必须包含字符串sagemaker

如果您设置CaptureDataDestinationCloud,或者如果设置CaptureDataPeriodicUploadtrue,那么在部署此组件时,必须在配置更新中为此参数指定一个值。

注意

捕获数据是 SageMaker 的一项功能,您可以使用它将推断输入、推断结果和附加推理数据上传到 S3 存储桶或本地目录,以供将来分析。有关将捕获数据与 SageMaker Edge 管理器一起使用的更多信息,请参阅管理模型中的Amazon SageMaker 开发人员指南

CaptureDataBatchSize

(可选)代理处理的一批捕获数据请求的大小。该值必须小于您在CaptureDataBufferSize。建议您不要超过缓冲区大小的一半。

当缓冲区中的请求数满足CaptureDataBatchSize数字,或者当CaptureDataPushPeriodSeconds间隔过去,以先发生者为准。

默认值:10

CaptureDataBufferSize

(可选)缓冲区中存储的最大捕获数据请求数。

默认值:30

CaptureDataDestination

(可选)存储捕获数据的目标。此参数可能具有以下值:

  • Disk-将捕获的数据写入组件的工作目录。

  • Cloud— 将捕获的数据上传到您在BucketName

如果您指定Disk,您还可以选择定期将捕获的数据上传到 S3 存储桶,方法是设置CaptureDataPeriodicUploadtrue

默认值:Cloud

CaptureDataPeriodicUpload

(可选)指定是否定期上载捕获的数据的字符串值。支持的值为 truefalse

将该参数设置为true如果设置CaptureDataDestinationDisk,并且您还希望代理定期上传您的 S3 存储桶捕获的数据。

默认值:false

CaptureDataPeriodicUploadPeriodSeconds

(可选)SageMaker 边缘管理器代理将捕获的数据上传到 S3 存储桶的时间间隔(以秒为单位)。使用此参数,如果您设置CaptureDataPeriodicUploadtrue

默认值:8

CaptureDataPushPeriodSeconds

(可选)SageMaker Edge Manager 代理处理来自缓冲区的一批捕获数据请求的时间间隔(以秒为单位)。

当缓冲区中的请求数满足CaptureDataBatchSize数字,或者当CaptureDataPushPeriodSeconds间隔过去,以先发生者为准。

默认值:4

CaptureDataBase64EmbedLimit

(可选)SageMaker Edge Manager 代理上传的捕获数据的最大小(以字节为单位)。

默认值:3072

FolderPrefix

(可选)代理将捕获的数据写入到的文件夹的名称。如果您设置CaptureDataDestinationDisk时,代理会在组件的工作目录中创建文件夹。如果您设置CaptureDataDestinationCloud,或者如果设置CaptureDataPeriodicUploadtrue代理将在 S3 存储桶中创建文件夹。

默认值:sme-capture

SagemakerEdgeLogVerbose

(可选)指定是否启用调试日志记录的字符串值。支持的值为 truefalse

默认值:false

UnixSocketName

(可选)SageMaker Edge Manager 套接字文件描述符在核心设备上的位置。

默认值:/tmp/aws.greengrass.SageMakerEdgeManager.sock

例 示例:配置 merge 更新

以下示例配置指定核心设备是目标设备管理员并且代理将捕获数据写入设备和 S3 存储桶。此配置还启用调试日志记录。

{ "DeviceFleetName": "MyEdgeDeviceFleet", "BucketName": "DOC-EXAMPLE-BUCKET", "CaptureDataDestination": "Disk", "CaptureDataPeriodicUpload": "true", "SagemakerEdgeLogVerbose": "true" }

Changelog

下表介绍每一版的中的更改。

Version

更改

1.0.1

版 Greengrass 3.0 版。

1.0.0

初始版本。