Installare l'agente AWS Systems Manager

1. Nel menu di navigazione della console IAM, scegli Ruoli.

2. Scegli il ruolo IAM che hai impostato come ruolo di scambio di token quando hai installato il software AWS IoT Greengrass Core. Se non hai specificato un nome per il ruolo di scambio di token quando hai installato il software AWS IoT Greengrass Core, è stato creato un ruolo denominatoGreengrassV2TokenExchangeRole.

3. In Autorizzazioni, scegli Aggiungi autorizzazioni, quindi scegli Allega politiche.

4. Scegli Crea policy. La pagina Crea policy si apre in una nuova scheda del browser.

5. Nella pagina Create policy (Crea policy), eseguire le operazioni seguenti:

   1. Scegli JSON per aprire l'editor JSON.

   2. Incollare la seguente policy nell'editor JSON. Sostituisci SSM ServiceRole con il nome del ruolo di servizio in cui hai creato. Fase 2: Creare un ruolo di servizio IAM per 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. Scegliere Next: Tags (Successivo: Tag).

   4. Scegliere Next:Review (Successivo: Rivedi).

   5. Immettere un Name (Nome) per la policy, ad esempio GreengrassSSMAgentComponentPolicy.

   6. Scegli Crea policy.

   7. Passa alla scheda precedente del browser in cui è aperto il ruolo di scambio di token.

6. Nella pagina Aggiungi autorizzazioni, scegli il pulsante di aggiornamento, quindi seleziona la politica dell'agente Greengrass Systems Manager creata nel passaggio precedente.

7. Scegli Collega policy.

   I dispositivi principali che utilizzano questo ruolo di scambio di token ora sono autorizzati a interagire con il servizio Systems Manager.

Per aggiungere una politica che conceda l'autorizzazione all'uso di Systems Manager

1. Crea un file chiamato ssm-agent-component-policy.json e copia il seguente codice JSON nel file. Sostituisci SSM ServiceRole con il nome del ruolo di servizio in cui hai creato. Fase 2: Creare un ruolo di servizio IAM per 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. Esegui il comando seguente per creare la politica dal documento di policy inssm-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

   Copia la policy Amazon Resource Name (ARN) dai metadati della policy nell'output. Utilizzerai questo ARN per collegare questa policy al ruolo principale del dispositivo nel passaggio successivo.

3. Esegui il comando seguente per allegare la policy al ruolo di scambio di token.

   • Sostituisci GreenGrassV2 TokenExchangeRole con il nome del ruolo di scambio di token specificato al momento dell'installazione del AWS IoT Greengrass software Core. Se non hai specificato un nome per il ruolo di scambio di token quando hai installato il software AWS IoT Greengrass Core, è stato creato un ruolo denominato. GreengrassV2TokenExchangeRole

   • Sostituisci l'ARN della policy con l'ARN del passaggio precedente.

   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

   Se il comando non ha alcun risultato, è riuscito. I dispositivi principali che utilizzano questo ruolo di scambio di token ora sono autorizzati a interagire con il servizio Systems Manager.

1. Nel menu di navigazione AWS IoT Greengrassdella console, scegli Componenti.

2. Nella pagina Componenti, scegli la scheda Componenti pubblici, quindi scegli aws.greengrass.SystemsManagerAgent.

3. Nella pagina aws.greengrass.SystemsManagerAgent, scegli (Distribuisci).

4. Da Aggiungi alla distribuzione, scegli una distribuzione esistente da modificare oppure scegli di creare una nuova distribuzione, quindi scegli Avanti.

5. Se hai scelto di creare una nuova distribuzione, scegli il dispositivo principale o il gruppo di oggetti di destinazione per la distribuzione. Nella pagina Specificare la destinazione, in Obiettivo di distribuzione, scegli un dispositivo principale o un gruppo di oggetti, quindi scegli Avanti.

6. Nella pagina Seleziona componenti, verifica che il aws.greengrass.SystemsManagerAgentcomponente sia selezionato, scegli Avanti.

7. Nella pagina Configura componenti aws.greengrass.SystemsManagerAgent, selezionate e quindi effettuate le seguenti operazioni:

   1. Scegli Configura componente.

   2. Nella aws.greengrass.SystemsManagerAgent modalità Configura, in Aggiornamento della configurazione, in Configurazione da unire, inserisci il seguente aggiornamento di configurazione. Sostituisci SSM ServiceRole con il nome del ruolo di servizio in cui hai creato. Fase 2: Creare un ruolo di servizio IAM per Systems Manager

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

      Nota

      Se il dispositivo principale esegue già il Systems Manager Agent registrato con un'attivazione ibrida, passare SSMOverrideExistingRegistration atrue. Questo parametro specifica se il componente Systems Manager Agent registra il dispositivo principale quando Systems Manager Agent è già in esecuzione sul dispositivo con un'attivazione ibrida.

      È inoltre possibile specificare tag (SSMResourceTags) da aggiungere al nodo gestito di Systems Manager creato dal componente Systems Manager Agent per il dispositivo principale. Per ulteriori informazioni, vedere Configurazione dei componenti Systems Manager Agent.

   3. Scegli Conferma per chiudere la modalità, quindi scegli Avanti.

8. Nella pagina Configura impostazioni avanzate, mantieni le impostazioni di configurazione predefinite e scegli Avanti.

9. Nella pagina Review (Verifica), scegli Deploy (Distribuisci).

   Il completamento della distribuzione può richiedere fino a un minuto.

1. Nel menu di navigazione della AWS IoT Greengrassconsole, scegli Dispositivi principali.

2. Scegli il dispositivo principale da verificare.

3. Nella pagina dei dettagli del dispositivo principale, trova la proprietà dell'AWS Systems Manageristanza. Se questa proprietà è presente e visualizza un collegamento alla console Systems Manager, il dispositivo principale viene registrato come nodo gestito.

   È inoltre possibile trovare la proprietà AWS Systems Managerping status per verificare lo stato del Systems Manager Agent sul dispositivo principale. Quando lo stato è Online, è possibile gestire il dispositivo principale con Systems Manager.

1. Nel menu di navigazione della console Systems Manager, scegli Fleet Manager.

2. In Nodi gestiti, procedi come segue:

   1. Aggiungi un filtro dove si trova il tipo di origine AWS::IoT::Thing.

   2. Aggiungi un filtro in cui Source ID è il nome del dispositivo principale da verificare.

3. Trova il dispositivo principale nella tabella Nodi gestiti. Se il dispositivo principale è nella tabella, è registrato come nodo gestito.

   È inoltre possibile trovare la proprietà ping status di Systems Manager Agent per verificare lo stato di Systems Manager Agent sul dispositivo principale. Quando lo stato è Online, è possibile gestire il dispositivo principale con Systems Manager.

• Utilizzate l'DescribeInstanceInformationoperazione per ottenere l'elenco dei nodi gestiti che corrispondono a un filtro specificato. Esegui il comando seguente per verificare se un dispositivo principale è registrato come nodo gestito. Sostituiscilo MyGreengrassCorecon il nome del dispositivo principale da verificare.

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

  La risposta contiene l'elenco dei nodi gestiti che corrispondono al filtro. Se l'elenco contiene un nodo gestito, il dispositivo principale viene registrato come nodo gestito. Puoi anche trovare altre informazioni sul nodo gestito del dispositivo principale nella risposta. Se la PingStatus proprietà èOnline, è possibile gestire il dispositivo principale con Systems Manager.