Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Il componente AWS Systems Manager Agent (`aws.greengrass.SystemsManagerAgent`) installa Systems Manager Agent, in modo da poter gestire i dispositivi principali con Systems Manager. Systems Manager è un AWS servizio che puoi utilizzare per visualizzare e controllare la tua infrastruttura AWS, tra cui EC2 istanze Amazon, server e macchine virtuali locali (VMs) e dispositivi periferici. Systems Manager consente di visualizzare i dati operativi, automatizzare le attività operative e mantenere la sicurezza e la conformità. Per ulteriori informazioni, vedere [Cos'è AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) e [Informazioni su Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) nella *Guida AWS Systems Manager per l'utente*.

<a name="about-systems-manager-capabilities"></a>Gli strumenti e le funzionalità di Systems Manager sono denominati *funzionalità*. I dispositivi core Greengrass supportano tutte le funzionalità di Systems Manager. Per ulteriori informazioni su queste funzionalità e su come utilizzare Systems Manager per gestire i dispositivi principali, vedere [le funzionalità di Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/features.html) nella *Guida per l'AWS Systems Manager utente*.

**Topics**
+ [Versioni](#systems-manager-agent-component-versions)
+ [Tipo](#systems-manager-agent-component-type)
+ [Sistema operativo](#systems-manager-agent-component-os-support)
+ [Requisiti](#systems-manager-agent-component-requirements)
+ [Dipendenze](#systems-manager-agent-component-dependencies)
+ [Configurazione](#systems-manager-agent-component-configuration)
+ [File di registro locale](#systems-manager-agent-component-log-file)
+ [Consulta anche](#systems-manager-agent-component-see-also)
+ [Changelog](#systems-manager-agent-component-changelog)

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

Questo componente ha le seguenti versioni:
+ 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>Questo <a name="public-component-type-generic-phrase"></a>componente è un componente generico () `aws.greengrass.generic`. Il [nucleo Greengrass](greengrass-nucleus-component.md) esegue gli script del ciclo di vita del componente.

<a name="public-component-type-more-information"></a>Per ulteriori informazioni, consulta [Tipi di componenti](develop-greengrass-components.md#component-types).

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

Questo componente può essere installato solo sui dispositivi principali di Linux.

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

Questo componente ha i seguenti requisiti:
+ Un dispositivo core Greengrass che funziona su una piattaforma Linux a 64 bit: Armv8 () AArch64 o x86\$164.
+ È necessario disporre di un ruolo di servizio AWS Identity and Access Management (IAM) che Systems Manager possa assumere. Questo ruolo deve includere la politica SSMManaged InstanceCore gestita da [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una politica personalizzata che definisca autorizzazioni equivalenti. Per ulteriori informazioni, consulta [Create an IAM service role for edge devices](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices.html#systems-manager-setting-up-edge-devices-service-role) nella *Guida per l'AWS Systems Manager utente*.

  Quando distribuisci questo componente, devi specificare il nome di questo ruolo per il parametro di `SSMRegistrationRole` configurazione.
+ Il [ruolo del dispositivo Greengrass](device-service-role.md) deve consentire le azioni `ssm:AddTagsToResource` e`ssm:RegisterManagedInstance`. Il ruolo del dispositivo deve inoltre consentire l'`iam:PassRole`azione del ruolo del servizio IAM che soddisfa il requisito precedente. Il seguente esempio di policy IAM concede queste autorizzazioni.

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

### Endpoint e porte
<a name="systems-manager-agent-component-endpoints"></a>

Questo componente deve essere in grado di eseguire richieste in uscita verso i seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per le operazioni di base. Per ulteriori informazioni, consulta [Consenti il traffico dei dispositivi tramite un proxy o un firewall](allow-device-traffic.md).


| Endpoint | Porta | Richiesto | Description | 
| --- | --- | --- | --- | 
|  `ec2messages.region.amazonaws.com`  | 443 | Sì |  Comunica con il servizio Systems Manager in Cloud AWS.  | 
|  `ssm.region.amazonaws.com`  | 443 | Sì |  Registrare il dispositivo principale come nodo gestito da Systems Manager.  | 
|  `ssmmessages.region.amazonaws.com`  | 443 | Sì |  Comunica con Session Manager, una funzionalità di Systems Manager, in Cloud AWS.  | 

*Per ulteriori informazioni, consulta [Riferimento: ec2messages, ssmmessages e altre chiamate API](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-messageAPIs.html) nella Guida per l'utente.AWS Systems Manager *

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

Quando distribuisci un componente, distribuisce AWS IoT Greengrass anche versioni compatibili delle sue dipendenze. Ciò significa che è necessario soddisfare i requisiti per il componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le [versioni rilasciate](#systems-manager-agent-component-changelog) di questo componente e i vincoli di versione semantica che definiscono le versioni dei componenti per ogni dipendenza. [È inoltre possibile visualizzare le dipendenze per ogni versione del componente nella console.AWS IoT Greengrass](https://console.aws.amazon.com//greengrass) Nella pagina dei dettagli del componente, cerca l'elenco delle **dipendenze**.

La tabella seguente elenca le dipendenze per le versioni da 1.0.0 a 1.3.0 di questo componente.


| Dipendenza | Versioni compatibili | Tipo di dipendenza | 
| --- | --- | --- | 
| [Servizio di scambio di token](token-exchange-service-component.md) |  >=2.0.0 <3.0.0 | Rigidi | 

[Per ulteriori informazioni sulle dipendenze dei componenti, vedere il riferimento alla ricetta dei componenti.](component-recipe-reference.md#recipe-reference-component-dependencies)

## Configurazione
<a name="systems-manager-agent-component-configuration"></a>

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

`SSMRegistrationRole`  
Il ruolo del servizio IAM che Systems Manager può assumere e che include la policy SSMManaged InstanceCore gestita da [Amazon](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/AmazonSSMManagedInstanceCore) o una policy personalizzata che definisce autorizzazioni equivalenti. Per ulteriori informazioni, consulta [Creare un ruolo di servizio IAM per i dispositivi edge](https://docs.aws.amazon.com/systems-manager/latest/userguide/systems-manager-setting-up-edge-devices-service-role.html) nella *Guida per l'AWS Systems Manager utente*.

`SSMOverrideExistingRegistration`  
(Facoltativo) Se il dispositivo principale esegue già il Systems Manager Agent registrato con un'attivazione ibrida, è possibile sovrascrivere la registrazione Systems Manager Agent esistente del dispositivo. Imposta questa opzione `true` per registrare il dispositivo principale come nodo gestito utilizzando l'agente Systems Manager fornito da questo componente.  
Questa opzione si applica solo ai dispositivi registrati con un'attivazione ibrida. Se il dispositivo principale viene eseguito su un' EC2 istanza Amazon con Systems Manager Agent installato e un ruolo del profilo dell'istanza configurato, l'ID del nodo gestito esistente dell' EC2 istanza Amazon inizia con`i-`. Quando si installa il componente Systems Manager Agent, l'agente Systems Manager registra un nuovo nodo gestito il cui ID inizia con `mi-` invece di`i-`. Quindi, è possibile utilizzare il nodo gestito il cui ID inizia con `mi-` per gestire il dispositivo principale con Systems Manager.
Impostazione predefinita: `false`

`SSMResourceTags`  
(Facoltativo) I tag da aggiungere al nodo gestito di Systems Manager che questo componente crea per il dispositivo principale. È possibile utilizzare questi tag per gestire gruppi di dispositivi principali con Systems Manager. Ad esempio, è possibile eseguire un comando su tutti i dispositivi che dispongono di un tag specificato dall'utente.  
Specificate un elenco in cui ogni tag è un oggetto con un `Key` e un`Value`. Ad esempio, il seguente valore di `SSMResourceTags` indica a questo componente di impostare il **Owner** tag **richard-roe** sul nodo gestito del dispositivo principale.  

```
[
  {
    "Key": "Owner",
    "Value": "richard-roe"
  }
]
```
Questo componente ignora questi tag se il nodo gestito esiste già e `SSMOverrideExistingRegistration` lo è. `false`

**Example Esempio: fusione e aggiornamento della configurazione**  
La configurazione di esempio seguente specifica l'utilizzo di un ruolo di servizio denominato `SSMServiceRole` per consentire al dispositivo principale di registrarsi e comunicare con Systems Manager.  

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

## File di registro locale
<a name="systems-manager-agent-component-log-file"></a>

Il software Systems Manager Agent scrive i log in una cartella esterna alla cartella principale di Greengrass. Per ulteriori informazioni, vedere [Visualizzazione dei log di Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-agent-logs.html) nella *Guida per l'AWS Systems Manager utente*.

Il componente Systems Manager Agent utilizza script di shell per installare, avviare e arrestare Systems Manager Agent. È possibile trovare l'output di questi script nel seguente file di registro.

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

**Per visualizzare i log di questo componente**
+ Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituisci `/greengrass/v2` con il percorso della cartella AWS IoT Greengrass principale.

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

## Consulta anche
<a name="systems-manager-agent-component-see-also"></a>
+ [Gestisci i dispositivi core Greengrass con AWS Systems Manager](manage-with-systems-manager.md)
+ [Cos'è AWS Systems Manager?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html) nella *Guida per l'utente di AWS Systems Manager *
+ [Informazioni su Systems Manager Agent](https://docs.aws.amazon.com/systems-manager/latest/userguide/prereqs-ssm-agent.html) nella *Guida AWS Systems Manager per l'utente*

## Changelog
<a name="systems-manager-agent-component-changelog"></a>

La tabella seguente descrive le modifiche apportate a ciascuna versione del componente.


|  **Versione**  |  **Modifiche**  | 
| --- | --- | 
|  1.3.0  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.4  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.2.3  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/greengrass/v2/developerguide/systems-manager-agent-component.html)  | 
|  1.1.0  |  Questa versione contiene correzioni di bug e miglioramenti.  | 
|  1.0.0  |  Versione iniziale.  |