Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Agente de Systems Manager
<a name="systems-manager-agent-component"></a>

El componente AWS Systems Manager Agent (`aws.greengrass.SystemsManagerAgent`) instala el agente de Systems Manager para que pueda administrar los dispositivos principales con Systems Manager. Systems Manager es un AWS servicio que puede utilizar para ver y controlar su infraestructura AWS, incluidas las EC2 instancias de Amazon, los servidores y máquinas virtuales locales (VMs) y los dispositivos periféricos. Systems Manager le permite ver los datos operativos, automatizar las tareas operativas y mantener la seguridad y la conformidad. Para obtener más información, consulte [¿Qué es? AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) y [Acerca de Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) en la *Guía AWS Systems Manager del usuario*.

<a name="about-systems-manager-capabilities"></a>Las herramientas y características de Systems Manager se denominan *capacidades*. Los dispositivos principales de Greengrass admiten todas las capacidades de Systems Manager. Para obtener más información sobre estas capacidades y sobre cómo usar Systems Manager para administrar los dispositivos principales, consulte [Capacidades de Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) en la *Guía del usuario de AWS Systems Manager *.

**Topics**
+ [Versiones](#systems-manager-agent-component-versions)
+ [Tipo](#systems-manager-agent-component-type)
+ [Sistema operativo](#systems-manager-agent-component-os-support)
+ [Requisitos](#systems-manager-agent-component-requirements)
+ [Dependencias](#systems-manager-agent-component-dependencies)
+ [Configuración](#systems-manager-agent-component-configuration)
+ [Archivo de registro local](#systems-manager-agent-component-log-file)
+ [Véase también](#systems-manager-agent-component-see-also)
+ [Registros de cambios](#systems-manager-agent-component-changelog)

## Versiones
<a name="systems-manager-agent-component-versions"></a>

Este componente tiene las siguientes versiones:
+ 1.3.x
+ 1.2.x
+ 1.1.x
+ 1.0.x

## Tipo
<a name="systems-manager-agent-component-type"></a>

<a name="public-component-type-generic"></a>Este <a name="public-component-type-generic-phrase"></a>componente es un componente genérico (`aws.greengrass.generic`). El [núcleo de Greengrass](greengrass-nucleus-component.md) ejecuta los scripts del ciclo de vida del componente.

<a name="public-component-type-more-information"></a>Para obtener más información, consulte [Tipos de componentes](develop-greengrass-components.md#component-types).

## Sistema operativo
<a name="systems-manager-agent-component-os-support"></a>

Este componente solo se puede instalar en los dispositivos principales de Linux.

## Requisitos
<a name="systems-manager-agent-component-requirements"></a>

Este componente tiene los siguientes requisitos:
+ Un dispositivo principal de Greengrass que se ejecuta en una plataforma Linux de 64 bits: Armv8 () AArch64 o x86\$164.
+ Debe tener una función de servicio AWS Identity and Access Management (IAM) que pueda asumir Systems Manager. Esta función debe incluir la política SSMManaged InstanceCore gestionada por [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una política personalizada que defina permisos equivalentes. Para obtener más información, consulte [Creación de un rol de servicio de IAM para dispositivos periféricos](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) en la *Guía del usuario de AWS Systems Manager *.

  Al implementar este componente, debe especificar el nombre de este rol para el parámetro de configuración `SSMRegistrationRole`.
+ El [rol de dispositivo de Greengrass](device-service-role.md) debe permitir las acciones `ssm:AddTagsToResource` y`ssm:RegisterManagedInstance`. El rol de dispositivo también debe permitir la acción `iam:PassRole` del rol de servicio de IAM que cumpla con el requisito anterior. El siguiente ejemplo de política de IAM concede estos permisos.

  ```
  {
    "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": "*"
      }
    ]
  }
  ```

### Puntos de conexión y puertos
<a name="systems-manager-agent-component-endpoints"></a>

Este componente debe poder realizar solicitudes salientes a los siguientes puntos de conexión y puertos, además de a los puntos de conexión y puertos necesarios para el funcionamiento básico. Para obtener más información, consulte [Cómo permitir el tráfico del dispositivo a través de un proxy o firewall](allow-device-traffic.md).


| punto de enlace | Puerto | Obligatorio | Description (Descripción) | 
| --- | --- | --- | --- | 
|  `ec2messages.region.amazonaws.com`  | 443 | Sí |  Comuníquese con el servicio de Systems Manager en la Nube de AWS.  | 
|  `ssm.region.amazonaws.com`  | 443 | Sí |  Registre el dispositivo principal como un nodo administrado por Systems Manager.  | 
|  `ssmmessages.region.amazonaws.com`  | 443 | Sí |  Comuníquese con Session Manager, una capacidad de Systems Manager, en la Nube de AWS.  | 

Para obtener más información, consulte [Referencia: ec2messages, ssmmessages y otras llamadas a la API](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html) en la *Guía del usuario de AWS Systems Manager *.

## Dependencias
<a name="systems-manager-agent-component-dependencies"></a>

Al implementar un componente, AWS IoT Greengrass también despliega versiones compatibles de sus dependencias. Esto significa que debe cumplir los requisitos del componente y de todas sus dependencias para poder implementar el componente correctamente. En esta sección, se enumeran las dependencias de las [versiones publicadas](#systems-manager-agent-component-changelog) de este componente y las restricciones de las versiones semánticas que definen las versiones de los componentes para cada dependencia. También puede ver las dependencias de cada versión del componente en la [consola de AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). En la página de detalles del componente, busque la lista de **Dependencias**.

En la siguiente tabla se enumeran las dependencias de las versiones 1.0.0 a 1.3.0 de este componente.


| Dependencia | Versiones compatibles | Tipo de dependencia | 
| --- | --- | --- | 
| [Servicio de intercambio de token](token-exchange-service-component.md) |  >=2.0.0 <3.0.0 | Rígido | 

Para obtener más información sobre las dependencias del componente, consulte la [referencia de receta de componentes](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuración
<a name="systems-manager-agent-component-configuration"></a>

Este componente ofrece los siguientes parámetros de configuración que puede personalizar cuando implemente el componente.

`SSMRegistrationRole`  
La función de servicio de IAM que puede asumir Systems Manager y que incluye la política SSMManaged InstanceCore gestionada por [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una política personalizada que defina permisos equivalentes. Para obtener más información, consulte [Creación de un rol de servicio de IAM para dispositivos periféricos](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) en la *Guía del usuario de AWS Systems Manager *.

`SSMOverrideExistingRegistration`  
(Opcional) Si el dispositivo principal ya ejecuta el Agente de Systems Manager registrado con una activación híbrida, puede anular el registro del Agente de Systems Manager existente del dispositivo. Defina esta opción en `true` para registrar el dispositivo principal como nodo administrado mediante el Agente de Systems Manager que proporciona este componente.  
Esta opción solo se aplica a los dispositivos que están registrados con una activación híbrida. Si el dispositivo principal se ejecuta en una EC2 instancia de Amazon con el Agente de Systems Manager instalado y un rol de perfil de instancia configurado, el ID de nodo gestionado existente de la EC2 instancia de Amazon empieza por`i-`. Al instalar el componente Agente de Systems Manager, el agente de Systems Manager registra un nuevo nodo administrado cuyo identificador empieza por `mi-` en lugar de `i-`. A continuación, puede utilizar el nodo administrado cuyo ID comienza con `mi-` para administrar el dispositivo principal con Systems Manager.
Valor predeterminado: `false`

`SSMResourceTags`  
(Opcional) Las etiquetas que se van a agregar al nodo administrado por Systems Manager que este componente crea para el dispositivo principal. Puede usar estas etiquetas para administrar grupos de dispositivos principales con Systems Manager. Por ejemplo, puede ejecutar un comando en todos los dispositivos que tengan una etiqueta que especifique.  
Especifique una lista en la que cada etiqueta sea un objeto con una `Key` y un `Value`. Por ejemplo, el siguiente valor de `SSMResourceTags` indica a este componente que establezca la etiqueta **Owner** en **richard-roe** en el nodo administrado del dispositivo principal.  

```
[
  {
    "Key": "Owner",
    "Value": "richard-roe"
  }
]
```
Este componente ignora estas etiquetas si el nodo administrado ya existe y `SSMOverrideExistingRegistration` es `false`.

**Example Ejemplo: actualización de la combinación de configuraciones**  
El siguiente ejemplo de configuración especifica el uso de un rol de servicio denominado `SSMServiceRole` para permitir que el dispositivo principal se registre y se comunique con Systems Manager.  

```
{
  "SSMRegistrationRole": "SSMServiceRole",
  "SSMOverrideExistingRegistration": false,
  "SSMResourceTags": [
    {
      "Key": "Owner",
      "Value": "richard-roe"
    },
    {
      "Key": "Team",
      "Value": "solar"
    }
  ]
}
```

## Archivo de registro local
<a name="systems-manager-agent-component-log-file"></a>

El software del Agente de Systems Manager escribe los registros en una carpeta fuera de la carpeta raíz de Greengrass. Para obtener más información, consulte [Visualización de registros de Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) en la *Guía del usuario de AWS Systems Manager *.

El componente Agente de Systems Manager utiliza scripts de intérprete de comandos para instalar, iniciar y detener el agente de Systems Manager. Puede encontrar el resultado de estos scripts en el siguiente archivo de registro.

```
/greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
```

**Visualización de los registros de este componente**
+ Ejecute el siguiente comando en el dispositivo de núcleo para ver el archivo de registro de este componente en tiempo real. `/greengrass/v2`Sustitúyalo por la ruta a la carpeta AWS IoT Greengrass raíz.

  ```
  sudo tail -f /greengrass/v2/logs/aws.greengrass.SystemsManagerAgent.log
  ```

## Véase también
<a name="systems-manager-agent-component-see-also"></a>
+ [Administración de los dispositivos principales de Greengrass con AWS Systems Manager](manage-with-systems-manager.md)
+ ¿[Qué es AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) en la * Guía del usuario de AWS Systems Manager *
+ [Información del Agente de Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) en la *Guía del usuario de AWS Systems Manager *

## Registros de cambios
<a name="systems-manager-agent-component-changelog"></a>

En la siguiente tabla, se describen los cambios en cada versión del componente.


|  **Versión**  |  **Cambios**  | 
| --- | --- | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.1.0  |  Esta versión contiene correcciones de errores y mejoras.  | 
|  1.0.0  |  Versión inicial.  |