Instalar el AWS Systems Manager agente

1. En el menú de navegación de la consola de IAM, elija Roles.

2. Elija la función de IAM que configuró como función de intercambio de fichas al instalar el software AWS IoT Greengrass Core. Si no especificó un nombre para la función de intercambio de fichas al instalar el software AWS IoT Greengrass Core, se creó una función denominadaGreengrassV2TokenExchangeRole.

3. En la pestaña Permisos, elija Agregar permisos y, a continuación, Asociar políticas.

4. Elija Crear política. Se abre la página Crear política en una nueva pestaña del navegador.

5. En la página Create policy (Crear política), haga lo siguiente:

   1. Elija JSON para abrir el editor JSON.

   2. Pegue la siguiente política de en el editor JSON. SSMServiceRoleSustitúyalo por el nombre del rol de servicio en el que lo creastePaso 2: Crear un rol de servicio de IAM para Systems Manager.

      {
        "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. Elija Siguiente: Etiquetas.

   4. Elija Siguiente: Revisar.

   5. Introduzca un Nombre para la política, como GreengrassSSMAgentComponentPolicy.

   6. Elija Crear política.

   7. Cambie a la pestaña anterior del navegador en la que tenía abierto el rol de intercambio de token.

6. En la página Agregar permisos, pulse el botón de actualización y, a continuación, seleccione la política de agente de Systems Manager en Greengrass que creó en el paso anterior.

7. Seleccione Asociar políticas.

   Los dispositivos principales que utilizan este rol de intercambio de token ahora tienen permiso para interactuar con el servicio Systems Manager.

Cómo agregar una política que conceda permiso para usar Systems Manager

1. Cree un archivo llamado ssm-agent-component-policy.json y copie el siguiente JSON en el archivo. SSMServiceRoleSustitúyalo por el nombre del rol de servicio en el que lo creastePaso 2: Crear un rol de servicio de IAM para Systems Manager.

   {
     "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. Ejecute el siguiente comando para crear la política del documento de política en 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

   Copie la política del nombre de recurso de Amazon (ARN) de la política de los metadatos de salida. Utilice este ARN para asociar la política al rol del dispositivo principal en el siguiente paso.

3. Ejecute el siguiente comando para asociar la política al rol de intercambio de token.

   • GreengrassV2TokenExchangeRoleSustitúyalo por el nombre de la función de intercambio de fichas que especificó al instalar el software AWS IoT Greengrass principal. Si no especificó un nombre para la función de intercambio de fichas al instalar el software AWS IoT Greengrass Core, se creó una función denominadaGreengrassV2TokenExchangeRole.

   • Sustituya el ARN de la política por el ARN del paso anterior.

   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

   Si todo es correcto, el comando no tiene salida. Los dispositivos principales que utilizan este rol de intercambio de token ahora tienen permiso para interactuar con el servicio Systems Manager.

1. En el menú de navegación de la consola de AWS IoT Greengrass, elija Componentes.

2. En la página Componentes, seleccione la pestaña Componentes públicos y, a continuación, elija aws.greengrass.SystemsManagerAgent.

3. En la página aws.greengrass.SystemsManagerAgentEn esta página, seleccione Implementar.

4. En Agregar a la implementación, elija una implementación existente para revisarla o cree una nueva y, a continuación, elija Siguiente.

5. Si opta por crear una nueva implementación, elija el dispositivo principal o el grupo de objetos de destino para la implementación. En la página Especificar el destino, en Destino de la implementación, elija un dispositivo principal o un grupo de objetos y, a continuación, elija Siguiente.

6. En la página Seleccionar componentes, compruebe que aws.greengrass.SystemsManagerAgentel componente está seleccionado, elija Siguiente.

7. En la página Configurar componentes, seleccione aws.greengrass.SystemsManagerAgenty, a continuación, haga lo siguiente:

   1. Seleccione Configurar componente.

   2. En la configuración aws.greengrass.SystemsManagerAgentmodal, en Actualización de configuración, en Configuración para fusionar, introduzca la siguiente actualización de configuración. SSMServiceRoleSustitúyalo por el nombre del rol de servicio en el que lo creastePaso 2: Crear un rol de servicio de IAM para Systems Manager.

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

      nota

      Si el dispositivo principal ya ejecuta el Agente de Systems Manager registrado con una activación híbrida, cambie SSMOverrideExistingRegistration a true. Este parámetro especifica si el componente agente de Systems Manager registra el dispositivo principal cuando el Agente de Systems Manager ya se está ejecutando en el dispositivo con una activación híbrida.

      También puede especificar etiquetas (SSMResourceTags) para agregarlas al nodo administrado por Systems Manager que el componente agente de Systems Manager crea para el dispositivo principal. Para obtener más información, consulte Configuración del componente agente de Systems Manager.

   3. Elija Confirmar para cerrar el cuadro y, a continuación, elija Siguiente.

8. En la página Configurar ajustes avanzados, mantenga los ajustes de configuración predeterminados y seleccione Siguiente.

9. En la página Revisar, elija Implementar.

   La implementación puede tardar hasta un minuto para completarse.

1. En el menú de navegación de la consola de AWS IoT Greengrass, elija Dispositivos principales.

2. Elija el dispositivo principal que desee verificar.

3. En la página de detalles del dispositivo principal, busque la propiedad de la Instancia de AWS Systems Manager . Si esta propiedad está presente y muestra un enlace a la consola de Systems Manager, el dispositivo principal está registrado como nodo administrado.

   También puede encontrar la propiedad estado de ping AWS Systems Manager para comprobar el estado del Agente de Systems Manager en el dispositivo principal. Cuando el estado es En línea, puede administrar el dispositivo principal con Systems Manager.

1. En el menú de navegación de la consola de Systems Manager, seleccione Administrador de flotas.

2. En Nodos administrados, haga lo siguiente:

   1. Agregue un filtro donde esté el tipo de fuente AWS::IoT::Thing.

   2. Agregue un filtro en el que ID de origen sea el nombre del dispositivo principal que se va a verificar.

3. Busque el dispositivo principal en la tabla de Nodos administrados. Si el dispositivo principal está en la tabla, está registrado como nodo administrado.

   También puede encontrar la propiedad estado de ping del agente de Systems Manager para comprobar el estado del Agente de Systems Manager en el dispositivo principal. Cuando el estado es En línea, puede administrar el dispositivo principal con Systems Manager.

• Utilice la DescribeInstanceInformationoperación para obtener la lista de nodos gestionados que coinciden con el filtro que especifique. Ejecute el siguiente comando para verificar si un dispositivo principal está registrado como nodo administrado. MyGreengrassCoreSustitúyalo por el nombre del dispositivo principal para verificarlo.

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

  La respuesta contiene la lista de nodos administrados que coinciden con el filtro. Si la lista contiene un nodo administrado, el dispositivo principal se registra como nodo administrado. También puede encontrar más información sobre el nodo administrado del dispositivo principal en la respuesta. Cuando la propiedad PingStatus está Online, puede administrar el dispositivo principal con Systems Manager.