安装 Amazon Systems Manager 代理

1. 在 IAM 控制台导航菜单中，选择角色。

2. 选择您在安装 C Amazon IoT Greengrass ore 软件时设置为令牌交换角色的 IAM 角色。如果您在安装 C Amazon IoT Greengrass ore 软件时没有为令牌交换角色指定名称，则它会创建一个名为的角色GreengrassV2TokenExchangeRole。

3. 在 “权限” 下，选择 “添加权限”，然后选择 “附加策略”。

4. 选择创建策略。创建策略页面将在新的浏览器选项卡中打开。

5. 在创建策略页面上，执行以下操作：

   1. 选择 JSON 以打开 JSON 编辑器。

   2. 将下面的 策略粘贴到 JSON 编辑器中。将 SSM ServiceRole 替换为您在中创建的服务角色的步骤 2：为 Systems Manager 创建 IAM 服务角色名称。

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Action": [
              "iam:PassRole"
            ],
            "Effect": "Allow",
            "Resource": [
              "arn:aws:iam::account-id:role/SSMServiceRole"
            ]
          },
          {
            "Action": [
              "ssm:AddTagsToResource",
              "ssm:RegisterManagedInstance"
            ],
            "Effect": "Allow",
            "Resource": "*"
          }
        ]
      }

   3. 选择下一步：标签。

   4. 选择下一步：审核。

   5. 输入策略的名称，例如 GreengrassSSMAgentComponentPolicy。

   6. 选择创建策略。

   7. 切换到上一个浏览器选项卡，您可以在其中打开令牌交换角色。

6. 在添加权限页面上，选择刷新按钮，然后选择您在上一步中创建的 Greengrass Systems Manager 代理策略。

7. 选择附加策略。

   使用此令牌交换角色的核心设备现在有权与 Systems Manager 服务进行交互。

添加授予使用 Systems Manager 权限的策略

1. 创建一个名为的文件，ssm-agent-component-policy.json并将以下 JSON 复制到该文件中。将 SSM ServiceRole 替换为您在中创建的服务角色的步骤 2：为 Systems Manager 创建 IAM 服务角色名称。

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Action": [
           "iam:PassRole"
         ],
         "Effect": "Allow",
         "Resource": [
           "arn:aws:iam::account-id:role/SSMServiceRole"
         ]
       },
       {
         "Action": [
           "ssm:AddTagsToResource",
           "ssm:RegisterManagedInstance"
         ],
         "Effect": "Allow",
         "Resource": "*"
       }
     ]
   }

2. 运行以下命令，根据中的策略文档创建策略ssm-agent-component-policy.json。

   Linux or Unix

   aws iam create-policy \
     --policy-name GreengrassSSMAgentComponentPolicy \
     --policy-document file://ssm-agent-component-policy.json

   Windows Command Prompt (CMD)

   aws iam create-policy ^
     --policy-name GreengrassSSMAgentComponentPolicy ^
     --policy-document file://ssm-agent-component-policy.json

   PowerShell

   aws iam create-policy `
     --policy-name GreengrassSSMAgentComponentPolicy `
     --policy-document file://ssm-agent-component-policy.json

   从输出中的策略元数据中复制策略 Amazon 资源名称 (ARN)。在下一步中，您将使用此 ARN 将此策略附加到核心设备角色。

3. 运行以下命令将策略附加到令牌交换角色。

   • 将 GreenGrassV2 TokenExchangeRole 替换为您在安装 Core 软件时指定的令牌交换角色的名称。Amazon IoT Greengrass如果您在安装 C Amazon IoT Greengrass ore 软件时没有为令牌交换角色指定名称，则它会创建一个名为的角色GreengrassV2TokenExchangeRole。

   • 将策略 ARN 替换为上一步中的 ARN。

   Linux or Unix

   aws iam attach-role-policy \
     --role-name GreengrassV2TokenExchangeRole \
     --policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy

   Windows Command Prompt (CMD)

   aws iam attach-role-policy ^
     --role-name GreengrassV2TokenExchangeRole ^
     --policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy

   PowerShell

   aws iam attach-role-policy `
     --role-name GreengrassV2TokenExchangeRole `
     --policy-arn arn:aws:iam::123456789012:policy/GreengrassSSMAgentComponentPolicy

   如果命令没有输出，则表示成功了。使用此令牌交换角色的核心设备现在有权与 Systems Manager 服务进行交互。

1. 在Amazon IoT Greengrass控制台导航菜单中，选择组件。

2. 在 “组件” 页上，选择 “公共组件” 选项卡，然后选择aws.greengrass.SystemsManagerAgent。

3. 在 aws.greengrass.SystemsManagerAgent 页面上，选择部署。

4. 从 “添加到部署” 中，选择要修改的现有部署，或者选择创建新部署，然后选择 “下一步”。

5. 如果您选择创建新部署，请为部署选择目标核心设备或事物组。在 “指定目标” 页面的 “部署目标” 下，选择核心设备或事物组，然后选择下一步。

6. 在 “选择组件” 页面上，确认已选择该aws.greengrass.SystemsManagerAgent组件，然后选择 “下一步”。

7. 在 “配置组件” 页面上 aws.greengrass.SystemsManagerAgent，选择，然后执行以下操作：

   1. 选择配置组件。

   2. 在 “配置” aws.greengrass.SystemsManagerAgent 模式的 “配置更新” 下，在 “要合并的配置” 中，输入以下配置更新。将 SSM ServiceRole 替换为您在中创建的服务角色的步骤 2：为 Systems Manager 创建 IAM 服务角色名称。

      {
        "SSMRegistrationRole": "SSMServiceRole",
        "SSMOverrideExistingRegistration": false
      }

      注意

      如果核心设备已经运行通过混合激活注册的 Systems Manager 代理，SSMOverrideExistingRegistration请更改为true。此参数指定当 Systems Manager 代理已经通过混合激活在设备上运行时，Systems Manager Agent 组件是否注册核心设备。

      您还可以指定要添加到 Systems Manager 代理组件为核心设备创建的 Systems Manager 托管节点的标签 (SSMResourceTags)。有关更多信息，请参阅 Systems Manager 代理组件配置。

   3. 选择 “确认” 关闭模式，然后选择 “下一步”。

8. 在配置高级设置页面上，保留默认配置设置，然后选择下一步。

9. 在 Review（检查）页上，选择 Deploy（部署）。

   部署最多可能需要一分钟才能完成。

1. 在Amazon IoT Greengrass控制台导航菜单中，选择核心设备。

2. 选择要验证的核心设备。

3. 在核心设备的详细信息页面上，找到Amazon Systems Manager实例属性。如果存在此属性并显示指向 Systems Manager 控制台的链接，则核心设备将被注册为托管节点。

   您还可以找到 Amazon Systems Managerping 状态属性来检查核心设备上 Systems Manager 代理的状态。当状态为 “在线” 时，您可以使用 Systems Manager 管理核心设备。

1. 在 Systems Manager 控制台导航菜单中，选择 Fleet Manager。

2. 在 “托管节点” 下，执行以下操作：

   1. 在 “来源” 类型所在的位置添加过滤器AWS::IoT::Thing。

   2. 添加一个过滤器，其中 S ource ID 是要验证的核心设备的名称。

3. 在 “托管节点” 表中找到核心设备。如果核心设备在表中，则将其注册为托管节点。

   您还可以找到 S ystems Manager 代理 ping 状态属性来检查核心设备上 Systems Manager 代理的状态。当状态为 “在线” 时，您可以使用 Systems Manager 管理核心设备。

• 使用DescribeInstanceInformation操作获取与您指定的筛选条件相匹配的托管节点列表。运行以下命令以验证核心设备是否已注册为托管节点。MyGreengrassCore替换为要验证的核心设备的名称。

  aws ssm describe-instance-information --filter Key=SourceIds,Values=MyGreengrassCore Key=SourceTypes,Values=AWS::IoT::Thing

  响应包含与过滤器匹配的托管节点列表。如果列表包含托管节点，则该核心设备将被注册为托管节点。您还可以在响应中找到有关核心设备托管节点的其他信息。如果PingStatus属性为Online，则可以使用 Systems Manager 管理核心设备。