安裝 AWS Systems Manager 代理程式

1. 在 IAM 主控台導覽功能表中，選擇 [角色]。

2. 選擇安裝 AWS IoT Greengrass Core 軟體時設定為權杖交換角色的 IAM 角色。如果您在安裝 AWS IoT Greengrass Core 軟體時未指定權杖交換角色的名稱，則會建立名為的角色GreengrassV2TokenExchangeRole。

3. 在 [權限] 下，選擇 [新增權限]，然後選擇 [附加原則]。

4. 選擇建立政策。[建立原則] 頁面會在新的瀏覽器索引標籤中開啟。

5. 在 Create policy (建立政策) 頁面上，執行下列動作：

   1. 選擇 JSON 以開啟 JSON 編輯器。

   2. 將以下 政策貼到 JSON 編輯器。以您在步驟 2：為 Systems Manager 建立 IAM 服務角色中建立的服務角色名稱取代 SSM ServiceRole。

      {
        "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. 為政策輸入 Name (名稱)，例如 GreengrassSSMAgentComponentPolicy。

   6. 選擇建立政策。

   7. 切換到上一個瀏覽器標籤，您可以在其中打開令牌交換角色。

6. 在 [新增權限] 頁面上，選擇 [重新整理] 按鈕，然後選取您在上一個步驟中建立的 Greengrass 系統管理員代理程式原則。

7. 選擇連接政策。

   使用此權杖交換角色的核心裝置現在具有與 Systems Manager 服務互動的權限。

若要新增授與使用 Systems Manager 之權限的原則

1. 創建一個名為的文件，ssm-agent-component-policy.json並將以下 JSON 複製到該文件中。以您在步驟 2：為 Systems Manager 建立 IAM 服務角色中建立的服務角色名稱取代 SSM ServiceRole。

   {
     "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. 執行下列命令，將原則附加至權杖交換角色。

   • 將 GreenRassv2 TokenExchangeRole 取代為您在安裝核心軟體時指定的權杖交換角色名稱。AWS IoT Greengrass如果您在安裝 AWS IoT Greengrass Core 軟體時未指定權杖交換角色的名稱，則會建立名為的角色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. 在AWS 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強制回應的組態更新下，在要合併的組態中，輸入下列組態更新。以您在步驟 2：為 Systems Manager 建立 IAM 服務角色中建立的服務角色名稱取代 SSM ServiceRole。

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

      注意

      如果核心裝置已執行以混合式啟動方式註冊的系統管理員代理程式，請變更SSMOverrideExistingRegistration為true。此參數指定當系統管理員代理程式已在具有混合式啟動的裝置上執行時，系統管理員代理程式元件是否註冊核心裝置。

      您也可以指定標籤 (SSMResourceTags)，以新增至系統管理員管理的節點，此節點是系統管理員代理程式元件為核心裝置建立的。如需詳細資訊，請參閱系統管理員代理程式元件組態

   3. 選擇「確認」以關閉強制回應，然後選擇「下一步」。

8. 在設定進階設定頁面上，保留預設組態設定，然後選擇 下一步。

9. 在 Review (檢閱) 頁面，選擇 Deploy (部署)。

   部署最多可能需要一分鐘的時間才能完成。

1. 在AWS IoT Greengrass主控台瀏覽功能表中，選擇 [核心裝置]。

2. 選擇要驗證的核心裝置。

3. 在核心裝置的詳細資料頁面上，找到AWS Systems Manager執行個體屬性。如果存在此內容並顯示 Systems Manager 主控台的連結，則核心裝置會註冊為受管理節點。

   您也可以找到 AWS Systems Managerping 狀態屬性，以檢查核心裝置上系統管理員代理程式的狀態。當狀態為 [線上] 時，您可以使用系統管理員來管理核心裝置。

1. 在 [Systems Manager] 主控台瀏覽功能表中，選擇 [叢集管理

2. 在受管節點下，執行下列動作：

   1. 新增「來源」類型為的篩選器AWS::IoT::Thing。

   2. 添加一個過濾器，其中源 ID 是要驗證的核心設備的名稱。

3. 在「受管理的節點」表格中找到核心裝置。如果核心裝置位於表格中，則會註冊為受管理節點。

   您也可以找到系統管理員代理程式偵測狀態屬性，以檢查核心裝置上系統管理員代理程式的狀態。當狀態為 [線上] 時，您可以使用系統管理員來管理核心裝置。

• 使用此DescribeInstanceInformation作業可取得符合您指定之篩選器的受管理節點清單。執行下列命令以驗證核心裝置是否已註冊為受管理節點。以核心裝置的名稱取MyGreengrassCore代以進行驗證。

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

  回應包含符合篩選器的受管節點清單。如果清單包含受管理節點，則核心裝置會註冊為受管理節點。您也可以在回應中找到有關核心裝置受管理節點的其他資訊。如果PingStatus屬性是Online，您可以使用系統管理員來管理核心裝置。