AWS Systems Manager エージェントのインストール

1. [IAM console] (IAM コンソール) ナビゲーションメニューで、[Roles] (ロール) を選択します。

2. AWS IoT Greengrass Core ソフトウェアをインストールする際にトークン交換ロールとして設定した IAM ロールを選択します。AWS IoT Greengrass Core ソフトウェアのインストール時にトークン交換ロールの名前を指定しなかった場合は、GreengrassV2TokenExchangeRole という名前のロールが作成されます。

3. [Permissions] (アクセス許可) タブを選択し、[Add permissions] (アクセス許可の追加) を選択してから、[Attach policies] (ポリシーの添付) を選択します。

4. [Create policy] (ポリシーの作成) を選択します。[ポリシーの作成] ページが新しいブラウザタブで開きます。

5. [ポリシーの作成] ページで、次の操作を行います。

   1. [JSON] を選択して JSON エディタを開きます。

   2. 以下の ポリシーを JSON エディタに貼り付けます。SSMServiceRole を で作成したサービスロールの名前に置き換えますステップ 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. [Add permissions] (アクセス許可を追加) ページで更新ボタンを選択して、前のステップで作成した Greengrass Systems Manager エージェントポリシーを選択します。

7. [ポリシーのアタッチ] を選択します。

   これで、このトークン交換ロールを使用するコアデバイスには、Systems Manager サービスとやり取りする権限が付与されます。

Systems Manager を使用するアクセス許可を付与するポリシーを追加するには

1. ssm-agent-component-policy.json という名前のファイルを作成して、次の JSON をファイルにコピーします。SSMServiceRole を で作成したサービスロールの名前に置き換えますステップ 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. 次のコマンドを実行して、ポリシーをトークン交換ロールにアタッチします。

   • GreengrassV2TokenExchangeRole を、 AWS IoT Greengrass Core ソフトウェアをインストールしたときに指定したトークン交換ロールの名前に置き換えます。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 コンソールのナビゲーションメニューで、[Components] (コンポーネント) を選択します。

2. [Components] (コンポーネント) ページで、[Public components] (公開コンポーネント) タブを選択し、次に aws.greengrass.SystemsManagerAgent を選択します。

3. aws.greengrass.SystemsManagerAgent ページで、[Deploy] (デプロイ) を選択します。

4. [Add to deployment] (デプロイに追加) で、改訂する既存のデプロイを選択するか、新しいデプロイを作成することを選択して、[Next] (次へ) を選択します。

5. 新しいデプロイの作成を選択した場合、デプロイのターゲットコアデバイスまたはモノグループを選択します。リポジトリの [Specify target] (ターゲットを指定) ページの、[Deployment target] (ターゲットのデプロイ) で、コアデバイスまたはモノグループを選択し、[Next] (次へ) を選択します。

6. [Select components] (コンポーネントを選択) ページで、aws.greengrass.SystemsManagerAgent コンポーネントが選択されていることを確認し、[Next] (次) を選択します。

7. [Configure components] (コンポーネントを設定) ページで、aws.greengrass.SystemsManagerAgent を選択したら、次の操作を行います。

   1. [Configure component] (コンポーネントを設定) を選択します。

   2. [aws.greengrass.SystemsManagerAgent の設定] モーダルの [設定の更新] の下にある [マージする設定] に、次の設定更新を入力します。SSMServiceRole を で作成したサービスロールの名前に置き換えますステップ 2: Systems Manager の IAM サービスロールを作成する。

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

      注記

      コアデバイスで、ハイブリッドアクティベーションに登録されている Systems Manager Agent がすでに実行されている場合は、SSMOverrideExistingRegistration を true に変更します。このパラメータは、デバイスでハイブリッドアクティベーションが行なわれた Systems Manager Agent がすでに実行されている場合に、Systems Manager Agent コンポーネントがコアデバイスの登録を行うかどうか指定するものです。

      Systems Manager Agent コンポーネントがコアデバイス用に作成する Systems Manager マネージドノードに追加するタグ (SSMResourceTags) を指定することもできます。詳細については、「Systems Manager Agent コンポーネントの設定」を参照してください。

   3. [Confirm] (確認) を選択してモーダルを閉じ、次に [Next] (次) を選択します。

8. [Configure advanced settings] (詳細設定) ページはデフォルト設定のままにし、[Next] (次へ) を選択します。

9. [Review] ページで、[デプロイ] を選択します。

   デプロイに最大 1 分かかる場合があります。

1. AWS IoT Greengrass コンソールのナビゲーションメニューで、[Core devices] (コアデバイス) を選択します。

2. 検証するコアデバイスを選択します。

3. コアデバイスの詳細ページで、AWS Systems Manager インスタンスプロパティを探します。このプロパティが存在し、Systems Manager コンソールへのリンクが表示されている場合、このコアデバイスはマネージドノードとして登録されています。

   また、AWS Systems Manager ping ステータスプロパティを探して、コアデバイスの Systems Manager Agent のステータスを確認することもできます。ステータスが [Online] (オンライン) のときは、Systems Manager でコアデバイスを管理できます。

1. [Systems Manager console] (Systems Manager コンソール) ナビゲーションメニューで、Fleet Manager を選択します。

2. [Managed nodes] (マネージドノード) で以下を実行します。

   1. [Source type] (ソースタイプ) を AWS::IoT::Thing に設定して、フィルターを追加します。

   2. [Source ID] (ソース ID) を検証するコアデバイスの名前に設定して、フィルターを追加します。

3. [Managed nodes] (マネージドノード) の表でコアデバイスを探します。コアデバイスが表内に見つかった場合、これはマネージドノードとして登録されています。

   また、[Systems Manager Agent ping status] (Systems Manager Agent ping ステータス) プロパティを探して、コアデバイスの Systems Manager Agent のステータスを確認することもできます。ステータスが [Online] (オンライン) のときは、Systems Manager でコアデバイスを管理できます。

• DescribeInstanceInformation オペレーションを使用して、指定したフィルターに一致するマネージドノードのリストを取得します。次のコマンドを実行して、コアデバイスがマネージドノードとして登録されているかどうかを確認します。を検証するコアデバイスの名前MyGreengrassCoreに置き換えます。

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

  レスポンスには、フィルターに一致するマネージドノードのリストが含まれます。リストにマネージドノードが含まれているなら、コアデバイスはマネージドノードとして登録されています。また、コアデバイスのマネージドノードに関するその他の情報もレスポンスで確認できます。PingStatus のプロパティが Online であれば、Systems Manager でコアデバイスを管理できます。