Endpoint FIPS

1. Ottieni l'endpoint di dati FIPS per la tua regione negli endpoint del piano dati AWS IoT Core FIPS. L'endpoint di dati FIPS per te dovrebbe avere il seguente aspetto: Account AWS data.iot-fips.us-west-2.amazonaws.com

2. Ottieni l'endpoint delle credenziali FIPS per la tua regione negli endpoint del AWS IoT Core piano dati FIPS. L'endpoint di credenziali FIPS per il tuo dovrebbe avere il seguente aspetto: Account AWS data.credentials.iot-fips.us-west-2.amazonaws.com

1. Ottieni l'endpoint di dati FIPS per la tua regione negli endpoint del piano dati AWS IoT Core FIPS. L'endpoint di dati FIPS per te dovrebbe avere il seguente aspetto: Account AWS data.iot-fips.us-west-2.amazonaws.com

2. Ottieni l'endpoint delle credenziali FIPS per la tua regione negli endpoint del AWS IoT Core piano dati FIPS. L'endpoint di credenziali FIPS per il tuo dovrebbe avere il seguente aspetto: Account AWS data.credentials.iot-fips.us-west-2.amazonaws.com

Per creare qualsiasi AWS IoT cosa

1. Crea AWS IoT qualcosa per il tuo dispositivo. Sul tuo computer di sviluppo, esegui il seguente comando.

   • Sostituisci MyGreengrassCore con il nome dell'oggetto da usare. Questo nome è anche il nome del dispositivo principale Greengrass.

     Nota

     Il nome dell'oggetto non può contenere i due punti (:).

   aws iot create-thing --thing-name MyGreengrassCore

   La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

   {
     "thingName": "MyGreengrassCore",
     "thingArn": "arn:aws:iot:us-west-2:123456789012:thing/MyGreengrassCore",
     "thingId": "8cb4b6cd-268e-495d-b5b9-1713d71dbf42"
   }

2. (Facoltativo) Aggiungere l' AWS IoT oggetto a un gruppo di oggetti nuovo o esistente. Utilizzi i gruppi di cose per gestire flotte di dispositivi core Greengrass. Quando distribuisci componenti software sui tuoi dispositivi, puoi scegliere come target singoli dispositivi o gruppi di dispositivi. È possibile aggiungere un dispositivo a un gruppo di cose con una distribuzione Greengrass attiva per distribuire i componenti software di quel gruppo di cose sul dispositivo. Esegui questa operazione:

   1. (Facoltativo) Crea un gruppo di AWS IoT cose.

      • Sostituirlo MyGreengrassCoreGroup con il nome del gruppo di oggetti da creare.

        Nota

        Il nome del gruppo di cose non può contenere i due punti (:).

      aws iot create-thing-group --thing-group-name MyGreengrassCoreGroup

      La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

      {
        "thingGroupName": "MyGreengrassCoreGroup",
        "thingGroupArn": "arn:aws:iot:us-west-2:123456789012:thinggroup/MyGreengrassCoreGroup",
        "thingGroupId": "4df721e1-ff9f-4f97-92dd-02db4e3f03aa"
      }

   2. Aggiungere l' AWS IoT oggetto a un gruppo di oggetti.

      • Sostituiscilo MyGreengrassCore con il nome del tuo AWS IoT oggetto.

      • Sostituisci MyGreengrassCoreGroup con il nome del gruppo di oggetti.

      aws iot add-thing-to-thing-group --thing-name MyGreengrassCore --thing-group-name MyGreengrassCoreGroup

      Il comando non produce alcun output se la richiesta ha esito positivo.

Per creare il certificato dell'oggetto

1. Crea una cartella in cui scaricare i certificati relativi all' AWS IoT oggetto.

   mkdir greengrass-v2-certs

2. Crea e scarica i certificati relativi all' AWS IoT oggetto.

   aws iot create-keys-and-certificate --set-as-active --certificate-pem-outfile greengrass-v2-certs/device.pem.crt --public-key-outfile greengrass-v2-certs/public.pem.key --private-key-outfile greengrass-v2-certs/private.pem.key

   La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

   {
     "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4",
     "certificateId": "aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4",
     "certificatePem": "-----BEGIN CERTIFICATE-----
   MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w
    0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZ
    WF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIw
    EAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5
    jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh
    MCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb
    WF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx
    HzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE
    BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI
    k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ
    ITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr
    AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auN
    KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6Guo
    EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw
    3rrszlaEXAMPLE=
   -----END CERTIFICATE-----",
     "keyPair": {
       "PublicKey": "-----BEGIN PUBLIC KEY-----\
   MIIBIjANBgkqhkEXAMPLEQEFAAOCAQ8AMIIBCgKCAQEAEXAMPLE1nnyJwKSMHw4h\
   MMEXAMPLEuuN/dMAS3fyce8DW/4+EXAMPLEyjmoF/YVF/gHr99VEEXAMPLE5VF13\
   59VK7cEXAMPLE67GK+y+jikqXOgHh/xJTwo+sGpWEXAMPLEDz18xOd2ka4tCzuWEXAMPLEahJbYkCPUBSU8opVkR7qkEXAMPLE1DR6sx2HocliOOLtu6Fkw91swQWEXAMPLE\\GB3ZPrNh0PzQYvjUStZeccyNCx2EXAMPLEvp9mQOUXP6plfgxwKRX2fEXAMPLEDa\
   hJLXkX3rHU2xbxJSq7D+XEXAMPLEcw+LyFhI5mgFRl88eGdsAEXAMPLElnI9EesG\
   FQIDAQAB\
   -----END PUBLIC KEY-----\
   ",
       "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----\
   key omitted for security reasons\
   -----END RSA PRIVATE KEY-----\
   "
     }
   }

   Salva l'Amazon Resource Name (ARN) del certificato da utilizzare per configurare il certificato in un secondo momento.

Per creare il certificato Thing

1. Sul dispositivo principale, inizializza un token PKCS #11 nell'HSM e genera una chiave privata. La chiave privata deve essere una chiave RSA con una dimensione di chiave RSA-2048 (o superiore) o una chiave ECC.

   Nota

   Per utilizzare un modulo di sicurezza hardware con chiavi ECC, è necessario utilizzare Greengrass nucleus v2.5.6 o versione successiva.

   Per utilizzare un modulo di sicurezza hardware e un gestore segreto, è necessario utilizzare un modulo di sicurezza hardware con chiavi RSA.

   Consulta la documentazione del tuo HSM per scoprire come inizializzare il token e generare la chiave privata. Se il tuo HSM supporta gli oggetti IDs, specifica un ID dell'oggetto quando generi la chiave privata. Salva l'ID dello slot, il PIN utente, l'etichetta dell'oggetto, l'ID dell'oggetto (se il tuo HSM ne utilizza uno) che specifichi quando inizializzi il token e generi la chiave privata. Questi valori vengono utilizzati successivamente quando si importa il certificato dell'oggetto nell'HSM e si configura il AWS IoT Greengrass software Core.

2. Crea una richiesta di firma del certificato (CSR) dalla chiave privata. AWS IoT utilizza questa CSR per creare un thing certificate per la chiave privata generata nell'HSM. Per informazioni su come creare una CSR dalla chiave privata, consulta la documentazione del tuo HSM. La CSR è un file, ad esempio. iotdevicekey.csr

3. Copia la CSR dal dispositivo al tuo computer di sviluppo. Se SSH e SCP sono abilitati sul computer di sviluppo e sul dispositivo, puoi usare il scp comando sul tuo computer di sviluppo per trasferire la CSR. Sostituiscilo device-ip-address con l'indirizzo IP del dispositivo e sostituiscilo ~/iotdevicekey.csr con il percorso del file CSR sul dispositivo.

   scp device-ip-address:~/iotdevicekey.csr iotdevicekey.csr

4. Sul tuo computer di sviluppo, crea una cartella in cui scaricare il certificato relativo all' AWS IoT oggetto.

   mkdir greengrass-v2-certs

5. Usa il file CSR per creare e scaricare il certificato relativo all' AWS IoT oggetto sul tuo computer di sviluppo.

   aws iot create-certificate-from-csr --set-as-active --certificate-signing-request=file://iotdevicekey.csr --certificate-pem-outfile greengrass-v2-certs/device.pem.crt

   La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

   {
     "certificateArn": "arn:aws:iot:us-west-2:123456789012:cert/aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4",
     "certificateId": "aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4",
     "certificatePem": "-----BEGIN CERTIFICATE-----
   MIICiTCCAfICCQD6m7oRw0uXOjANBgkqhkiG9w
    0BAQUFADCBiDELMAkGA1UEBhMCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZ
    WF0dGxlMQ8wDQYDVQQKEwZBbWF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIw
    EAYDVQQDEwlUZXN0Q2lsYWMxHzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5
    jb20wHhcNMTEwNDI1MjA0NTIxWhcNMTIwNDI0MjA0NTIxWjCBiDELMAkGA1UEBh
    MCVVMxCzAJBgNVBAgTAldBMRAwDgYDVQQHEwdTZWF0dGxlMQ8wDQYDVQQKEwZBb
    WF6b24xFDASBgNVBAsTC0lBTSBDb25zb2xlMRIwEAYDVQQDEwlUZXN0Q2lsYWMx
    HzAdBgkqhkiG9w0BCQEWEG5vb25lQGFtYXpvbi5jb20wgZ8wDQYJKoZIhvcNAQE
    BBQADgY0AMIGJAoGBAMaK0dn+a4GmWIWJ21uUSfwfEvySWtC2XADZ4nB+BLYgVI
    k60CpiwsZ3G93vUEIO3IyNoH/f0wYK8m9TrDHudUZg3qX4waLG5M43q7Wgc/MbQ
    ITxOUSQv7c7ugFFDzQGBzZswY6786m86gpEIbb3OhjZnzcvQAaRHhdlQWIMm2nr
    AgMBAAEwDQYJKoZIhvcNAQEFBQADgYEAtCu4nUhVVxYUntneD9+h8Mg9q6q+auN
    KyExzyLwaxlAoo7TJHidbtS4J5iNmZgXL0FkbFFBjvSfpJIlJ00zbhNYS5f6Guo
    EDmFJl0ZxBHjJnyp378OD8uTs7fLvjx79LjSTbNYiytVbZPQUQ5Yaxu2jXnimvw
    3rrszlaEXAMPLE=
   -----END CERTIFICATE-----"
   }

   Salva l'ARN del certificato da utilizzare per configurare il certificato in un secondo momento.

Per configurare il certificato dell'oggetto

1. Allega il certificato all' AWS IoT oggetto.

   • Sostituiscilo MyGreengrassCore con il nome del tuo AWS IoT oggetto.

   • Sostituisci il certificato Amazon Resource Name (ARN) con l'ARN del certificato che hai creato nel passaggio precedente.

   aws iot attach-thing-principal --thing-name MyGreengrassCore --principal arn:aws:iot:us-west-2:123456789012:cert/aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4

   Il comando non produce alcun output se la richiesta ha esito positivo.

2. Crea e allega una AWS IoT policy che definisca le AWS IoT autorizzazioni per il tuo dispositivo principale Greengrass. La seguente politica consente l'accesso a tutti gli argomenti MQTT e alle operazioni di Greengrass, in modo che il dispositivo funzioni con applicazioni personalizzate e modifiche future che richiedono nuove operazioni Greengrass. È possibile limitare questa politica in base al proprio caso d'uso. Per ulteriori informazioni, consulta AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali.

   Se hai già configurato un dispositivo Greengrass core, puoi allegare la AWS IoT relativa policy invece di crearne una nuova.

   Esegui questa operazione:

   1. Crea un file che contenga il documento di AWS IoT policy richiesto dai dispositivi core Greengrass.

      Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

      nano greengrass-v2-iot-policy.json

      Copiate il seguente codice JSON nel file.

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "iot:Publish",
              "iot:Subscribe",
              "iot:Receive",
              "iot:Connect",
              "greengrass:*"
            ],
            "Resource": [
              "*"
            ]
          }
        ]
      }

   2. Crea una AWS IoT politica dal documento di policy.

      • Sostituisci GreengrassV2IoTThingPolicy con il nome della politica da creare.

      aws iot create-policy --policy-name GreengrassV2IoTThingPolicy --policy-document file://greengrass-v2-iot-policy.json

      La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

      {
        "policyName": "GreengrassV2IoTThingPolicy",
        "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GreengrassV2IoTThingPolicy",
        "policyDocument": "{
          \\"Version\\": \\"2012-10-17\\",
          \\"Statement\\": [
            {
              \\"Effect\\": \\"Allow\\",
              \\"Action\\": [
                \\"iot:Publish\\",
                \\"iot:Subscribe\\",
                \\"iot:Receive\\",
                \\"iot:Connect\\",
                \\"greengrass:*\\"
              ],
              \\"Resource\\": [
                \\"*\\"
              ]
            }
          ]
        }",
        "policyVersionId": "1"
      }

   3. Allega la AWS IoT policy al certificato dell' AWS IoT oggetto.

      • Sostituisci GreengrassV2IoTThingPolicy con il nome della politica da allegare.

      • Sostituisci l'ARN di destinazione con l'ARN del certificato per il tuo oggetto. AWS IoT

      aws iot attach-policy --policy-name GreengrassV2IoTThingPolicy --target arn:aws:iot:us-west-2:123456789012:cert/aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4

      Il comando non ha alcun output se la richiesta ha esito positivo.

Per creare un ruolo IAM per lo scambio di token

1. Crea un ruolo IAM che il tuo dispositivo possa utilizzare come ruolo di scambio di token. Esegui questa operazione:

   1. Crea un file che contenga il documento sulla politica di fiducia richiesto dal ruolo di scambio di token.

      Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

      nano device-role-trust-policy.json

      Copiate il seguente codice JSON nel file.

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Effect": "Allow",
            "Principal": {
              "Service": "credentials.iot.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
          }
        ]
      }

   2. Crea il ruolo di scambio di token con il documento sulla politica di fiducia.

      • Sostituiscilo GreengrassV2TokenExchangeRole con il nome del ruolo IAM da creare.

      aws iam create-role --role-name GreengrassV2TokenExchangeRole --assume-role-policy-document file://device-role-trust-policy.json

      La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

      {
        "Role": {
          "Path": "/",
          "RoleName": "GreengrassV2TokenExchangeRole",
          "RoleId": "AROAZ2YMUHYHK5OKM77FB",
          "Arn": "arn:aws:iam::123456789012:role/GreengrassV2TokenExchangeRole",
          "CreateDate": "2021-02-06T00:13:29+00:00",
          "AssumeRolePolicyDocument": {
            "Version": "2012-10-17",
            "Statement": [
              {
                "Effect": "Allow",
                "Principal": {
                  "Service": "credentials.iot.amazonaws.com"
                },
                "Action": "sts:AssumeRole"
              }
            ]
          }
        }

   3. Crea un file che contenga il documento sulla politica di accesso richiesto dal ruolo di scambio di token.

      Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

      nano device-role-access-policy.json

      Copiate il seguente codice JSON nel file.

      {
        "Version": "2012-10-17",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": [
              "logs:CreateLogGroup",
              "logs:CreateLogStream",
              "logs:PutLogEvents",
              "logs:DescribeLogStreams",
              "s3:GetBucketLocation"
            ],
            "Resource": "*"
          }
        ]
      }

      Nota

      Questa politica di accesso non consente l'accesso agli artefatti dei componenti nei bucket S3. Per distribuire componenti personalizzati che definiscono gli artefatti in Amazon S3, devi aggiungere autorizzazioni al ruolo per consentire al dispositivo principale di recuperare gli artefatti dei componenti. Per ulteriori informazioni, consulta Consenti l'accesso ai bucket S3 per gli artefatti dei componenti.

      Se non disponi ancora di un bucket S3 per gli artefatti dei componenti, puoi aggiungere queste autorizzazioni in un secondo momento dopo aver creato un bucket.

   4. Crea la policy IAM dal documento di policy.

      • Sostituiscila GreengrassV2TokenExchangeRoleAccess con il nome della policy IAM da creare.

      aws iam create-policy --policy-name GreengrassV2TokenExchangeRoleAccess --policy-document file://device-role-access-policy.json

      La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

      {
        "Policy": {
          "PolicyName": "GreengrassV2TokenExchangeRoleAccess",
          "PolicyId": "ANPAZ2YMUHYHACI7C5Z66",
          "Arn": "arn:aws:iam::123456789012:policy/GreengrassV2TokenExchangeRoleAccess",
          "Path": "/",
          "DefaultVersionId": "v1",
          "AttachmentCount": 0,
          "PermissionsBoundaryUsageCount": 0,
          "IsAttachable": true,
          "CreateDate": "2021-02-06T00:37:17+00:00",
          "UpdateDate": "2021-02-06T00:37:17+00:00"
        }
      }

   5. Allega la policy IAM al ruolo di scambio di token.

      • Sostituisci GreengrassV2TokenExchangeRole con il nome del ruolo IAM.

      • Sostituisci l'ARN della policy con l'ARN della policy IAM che hai creato nel passaggio precedente.

      aws iam attach-role-policy --role-name GreengrassV2TokenExchangeRole --policy-arn arn:aws:iam::123456789012:policy/GreengrassV2TokenExchangeRoleAccess

      Il comando non ha alcun output se la richiesta ha esito positivo.

2. Crea un alias di AWS IoT ruolo che punti al ruolo di scambio di token.

   • Sostituiscilo GreengrassCoreTokenExchangeRoleAlias con il nome dell'alias del ruolo da creare.

   • Sostituisci il ruolo ARN con l'ARN del ruolo IAM creato nel passaggio precedente.

   aws iot create-role-alias --role-alias GreengrassCoreTokenExchangeRoleAlias --role-arn arn:aws:iam::123456789012:role/GreengrassV2TokenExchangeRole

   La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

   {
     "roleAlias": "GreengrassCoreTokenExchangeRoleAlias",
     "roleAliasArn": "arn:aws:iot:us-west-2:123456789012:rolealias/GreengrassCoreTokenExchangeRoleAlias"
   }

   Nota

   Per creare un alias di ruolo, devi disporre dell'autorizzazione a passare il ruolo IAM per lo scambio di token a. AWS IoT Se ricevi un messaggio di errore quando tenti di creare un alias di ruolo, verifica che AWS l'utente disponga di questa autorizzazione. Per ulteriori informazioni, consulta Concessione a un utente delle autorizzazioni per il trasferimento di un ruolo a un AWS servizio nella Guida per l'AWS Identity and Access Management utente.

3. Crea e allega una AWS IoT policy che consenta al tuo dispositivo principale Greengrass di utilizzare l'alias del ruolo per assumere il ruolo di scambio di token. Se hai già configurato un dispositivo principale Greengrass, puoi allegare la sua AWS IoT politica di alias di ruolo invece di crearne uno nuovo. Esegui questa operazione:

   1. (Facoltativo) Create un file che contenga il documento di AWS IoT policy richiesto dall'alias di ruolo.

      Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

      nano greengrass-v2-iot-role-alias-policy.json

      Copiate il seguente codice JSON nel file.

      • Sostituisci l'ARN della risorsa con l'ARN del tuo alias di ruolo.

      {
        "Version":"2012-10-17",
        "Statement": [
          {
            "Effect": "Allow",
            "Action": "iot:AssumeRoleWithCertificate",
            "Resource": "arn:aws:iot:us-west-2:123456789012:rolealias/GreengrassCoreTokenExchangeRoleAlias"
          }
        ]
      }

   2. Crea una AWS IoT politica dal documento di policy.

      • Sostituisci GreengrassCoreTokenExchangeRoleAliasPolicy con il nome della AWS IoT politica da creare.

      aws iot create-policy --policy-name GreengrassCoreTokenExchangeRoleAliasPolicy --policy-document file://greengrass-v2-iot-role-alias-policy.json

      La risposta è simile all'esempio seguente, se la richiesta ha esito positivo.

      {
        "policyName": "GreengrassCoreTokenExchangeRoleAliasPolicy",
        "policyArn": "arn:aws:iot:us-west-2:123456789012:policy/GreengrassCoreTokenExchangeRoleAliasPolicy",
        "policyDocument": "{
          \\"Version\\":\\"2012-10-17\\",
          \\"Statement\\": [
            {
              \\"Effect\\": \\"Allow\\",
              \\"Action\\": \\"iot:AssumeRoleWithCertificate\\",
              \\"Resource\\": \\"arn:aws:iot:us-west-2:123456789012:rolealias/GreengrassCoreTokenExchangeRoleAlias\\"
            }
          ]
        }",
        "policyVersionId": "1"
      }

   3. Allega la AWS IoT policy al certificato dell' AWS IoT oggetto.

      • Sostituisci GreengrassCoreTokenExchangeRoleAliasPolicy con il nome della AWS IoT politica relativa agli alias del ruolo.

      • Sostituisci l'ARN di destinazione con l'ARN del certificato per il tuo oggetto. AWS IoT

      aws iot attach-policy --policy-name GreengrassCoreTokenExchangeRoleAliasPolicy --target arn:aws:iot:us-west-2:123456789012:cert/aa0b7958770878eabe251d8a7ddd547f4889c524c9b574ab9fbf65f32248b1d4

      Il comando non ha alcun output se la richiesta ha esito positivo.

Per scaricare i certificati sul dispositivo

1. Copia il certificato AWS IoT Thing dal tuo computer di sviluppo al dispositivo. Se SSH e SCP sono abilitati sul computer di sviluppo e sul dispositivo, puoi usare il scp comando sul tuo computer di sviluppo per trasferire il certificato. device-ip-addressSostituiscilo con l'indirizzo IP del tuo dispositivo.

   scp -r greengrass-v2-certs/ device-ip-address:~

2. Crea la cartella principale Greengrass sul dispositivo. Successivamente installerai il software AWS IoT Greengrass Core in questa cartella.

   Nota

   In Windows esiste un limite di lunghezza del percorso di 260 caratteri. Se usi Windows, usa una cartella principale come C:\greengrass\v2 o D:\greengrass\v2 per mantenere i percorsi dei componenti Greengrass al di sotto del limite di 260 caratteri.

   Linux or Unix

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

   Windows Command Prompt

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   PowerShell

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt
   • PowerShell

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

3. (Solo Linux) Imposta le autorizzazioni del genitore della cartella principale di Greengrass.

   • Sostituiscilo /greengrass con quello principale della cartella principale.

   sudo chmod 755 /greengrass

4. Copia i AWS IoT Thing Certificates nella cartella principale di Greengrass.

   Linux or Unix

   • Sostituisci /greengrass/v2 con la cartella principale di Greengrass.

   sudo cp -R ~/greengrass-v2-certs/* /greengrass/v2

   Windows Command Prompt

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   robocopy %USERPROFILE%\greengrass-v2-certs C:\greengrass\v2 /E

   PowerShell

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   cp -Path ~\greengrass-v2-certs\* -Destination C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt
   • PowerShell

   • Sostituisci /greengrass/v2 con la cartella principale di Greengrass.

   sudo cp -R ~/greengrass-v2-certs/* /greengrass/v2

5. Scarica il certificato Amazon Root Certificate Authority (CA). AWS IoT per impostazione predefinita, i certificati sono associati al certificato CA root di Amazon. Scarica il CA1 certificato e il CA3certificato.

   Linux or Unix

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

   Windows Command Prompt (CMD)

   curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   PowerShell

   iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

Per scaricare i certificati sul dispositivo

1. Copia il certificato AWS IoT Thing dal tuo computer di sviluppo al dispositivo. Se SSH e SCP sono abilitati sul computer di sviluppo e sul dispositivo, puoi usare il scp comando sul tuo computer di sviluppo per trasferire il certificato. device-ip-addressSostituiscilo con l'indirizzo IP del tuo dispositivo.

   scp -r greengrass-v2-certs/ device-ip-address:~

2. Crea la cartella principale Greengrass sul dispositivo. Successivamente installerai il software AWS IoT Greengrass Core in questa cartella.

   Nota

   In Windows esiste un limite di lunghezza del percorso di 260 caratteri. Se usi Windows, usa una cartella principale come C:\greengrass\v2 o D:\greengrass\v2 per mantenere i percorsi dei componenti Greengrass al di sotto del limite di 260 caratteri.

   Linux or Unix

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

   Windows Command Prompt

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   PowerShell

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt
   • PowerShell

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

3. (Solo Linux) Imposta le autorizzazioni del genitore della cartella principale di Greengrass.

   • Sostituiscilo /greengrass con quello principale della cartella principale.

   sudo chmod 755 /greengrass

4. Importa il file del certificato dell'oggetto~/greengrass-v2-certs/device.pem.crt, nell'HSM. Consulta la documentazione del tuo HSM per scoprire come importare i certificati al suo interno. Importa il certificato utilizzando lo stesso token, ID slot, PIN utente, etichetta dell'oggetto e ID oggetto (se il tuo HSM ne utilizza uno) con cui hai generato la chiave privata nell'HSM in precedenza.

   Nota

   Se hai generato la chiave privata in precedenza senza un ID di oggetto e il certificato ha un ID oggetto, imposta l'ID dell'oggetto della chiave privata sullo stesso valore del certificato. Consultate la documentazione del vostro HSM per scoprire come impostare l'ID dell'oggetto per l'oggetto chiave privata.

5. (Facoltativo) Eliminare il file del certificato dell'oggetto, in modo che esista solo nell'HSM.

   rm ~/greengrass-v2-certs/device.pem.crt

6. Scarica il certificato Amazon Root Certificate Authority (CA). AWS IoT per impostazione predefinita, i certificati sono associati al certificato CA root di Amazon. Scarica sia il CA1 certificato che il CA3certificato.

   Linux or Unix

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

   Windows Command Prompt (CMD)

   curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   PowerShell

   iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   sudo curl -o /greengrass/v2/AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem
   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

Per configurare un dispositivo Linux per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva. I seguenti comandi mostrano come installare OpenJDK sul tuo dispositivo.

   • Per le distribuzioni basate su Debian o basate su Ubuntuu:

     sudo apt install default-jdk

   • Per le distribuzioni basate su Red Hat:

     sudo yum install java-11-openjdk-devel

   • Per Amazon Linux 2:

     sudo amazon-linux-extras install java-openjdk11

   • Per Amazon Linux 2023:

     sudo dnf install java-11-amazon-corretto -y

   Al termine dell'installazione, esegui il comando seguente per verificare che Java funzioni sul tuo dispositivo Linux.

   java -version

   Il comando stampa la versione di Java in esecuzione sul dispositivo. Ad esempio, su una distribuzione basata su Debian, l'output potrebbe essere simile all'esempio seguente.

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. (Facoltativo) Crea l'utente e il gruppo di sistema predefiniti che eseguono i componenti sul dispositivo. Puoi anche scegliere di lasciare che il programma di installazione del software AWS IoT Greengrass Core crei questo utente e gruppo durante l'installazione con l'argomento --component-default-user installer. Per ulteriori informazioni, consulta Argomenti dell'installatore.

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. Verificate che l'utente che esegue il software AWS IoT Greengrass Core (in genereroot) sia autorizzato a funzionare sudo con qualsiasi utente e gruppo.

   1. Eseguite il comando seguente per aprire il /etc/sudoers file.

      sudo visudo

   2. Verificate che l'autorizzazione per l'utente sia simile all'esempio seguente.

      root    ALL=(ALL:ALL) ALL

4. (Facoltativo) Per eseguire funzioni Lambda containerizzate, è necessario abilitare cgroups v1 e abilitare e montare i cgroup di memoria e dispositivi. Se non intendi eseguire funzioni Lambda containerizzate, puoi saltare questo passaggio.

   Per abilitare queste opzioni di cgroups, avvia il dispositivo con i seguenti parametri del kernel Linux.

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   Per informazioni sulla visualizzazione e l'impostazione dei parametri del kernel per il tuo dispositivo, consulta la documentazione del tuo sistema operativo e del boot loader. Segui le istruzioni per impostare in modo permanente i parametri del kernel.

5. Installa tutte le altre dipendenze richieste sul tuo dispositivo come indicato dall'elenco dei requisiti in. Requisiti per il dispositivo

Per configurare un dispositivo Windows per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva.

2. Controlla se Java è disponibile nella variabile di sistema PATH e aggiungilo in caso contrario. L' LocalSystem account esegue il software AWS IoT Greengrass Core, quindi è necessario aggiungere Java alla variabile di sistema PATH anziché alla variabile utente PATH per l'utente. Esegui questa operazione:

   1. Premi il tasto Windows per aprire il menu di avvio.

   2. Digita environment variables per cercare le opzioni di sistema dal menu di avvio.

   3. Nei risultati della ricerca del menu di avvio, scegli Modifica le variabili di ambiente di sistema per aprire la finestra delle proprietà del sistema.

   4. Scegli Variabili di ambiente... per aprire la finestra Variabili d'ambiente.

   5. In Variabili di sistema, seleziona Percorso, quindi scegli Modifica. Nella finestra Modifica variabile di ambiente, puoi visualizzare ogni percorso su una riga separata.

   6. Controlla se è presente il percorso della bin cartella di installazione di Java. Il percorso potrebbe essere simile all'esempio seguente.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. Se la bin cartella di installazione Java non è presente in Path, scegliete Nuovo per aggiungerla, quindi scegliete OK.

3. Aprite il prompt dei comandi di Windows (cmd.exe) come amministratore.

4. Crea l'utente predefinito nell' LocalSystem account sul dispositivo Windows. Sostituiscilo password con una password sicura.

   net user /add ggc_user password

   Suggerimento

   A seconda della configurazione di Windows, la password dell'utente potrebbe essere impostata per scadere in date future. Per garantire che le tue applicazioni Greengrass continuino a funzionare, tieni traccia della scadenza della password e aggiornala prima che scada. Puoi anche impostare la password dell'utente in modo che non scada mai.

   • Per verificare la scadenza di un utente e della relativa password, esegui il comando seguente.

     net user ggc_user | findstr /C:expires

   • Per impostare la password di un utente in modo che non scada mai, esegui il comando seguente.

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • Se utilizzi Windows 10 o versioni successive in cui il wmiccomando è obsoleto, esegui il comando seguente. PowerShell

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. Scarica e installa l'PsExecutilità di Microsoft sul dispositivo.

6. Utilizzate l' PsExec utilità per memorizzare il nome utente e la password per l'utente predefinito nell'istanza di Credential Manager per l' LocalSystem account. Sostituiscila password con la password dell'utente che hai impostato in precedenza.

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   Se l'icona PsExec License Agreementapre, scegli Acceptper accettare la licenza ed eseguire il comando.

   Nota

   Sui dispositivi Windows, l' LocalSystem account esegue il Greengrass nucleus ed è necessario utilizzare l' PsExec utilità per memorizzare le informazioni utente predefinite nell'account. LocalSystem L'utilizzo dell'applicazione Credential Manager archivia queste informazioni nell'account Windows dell'utente attualmente connesso, anziché nell'account. LocalSystem

Per scaricare il software AWS IoT Greengrass Core

1. Sul dispositivo principale, scaricate il software AWS IoT Greengrass Core in un file denominatogreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

2. (Facoltativo) Per verificare la firma del software Greengrass nucleus

   Nota

   Questa funzionalità è disponibile con Greengrass nucleus versione 2.9.5 e successive.

   1. Usa il seguente comando per verificare la firma del tuo artefatto Greengrass nucleus:

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

      anchoranchoranchor
      • Linux or Unix
      • Windows Command Prompt (CMD)
      • PowerShell

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   2. L'jarsignerinvocazione produce un output che indica i risultati della verifica.

      1. Se il file zip Greengrass nucleus è firmato, l'output contiene la seguente dichiarazione:

         jar verified.

      2. Se il file zip Greengrass nucleus non è firmato, l'output contiene la seguente dichiarazione:

         jar is unsigned.

   3. Se hai fornito l'-certsopzione Jarsigner insieme alle -verbose opzioni -verify e, l'output include anche informazioni dettagliate sul certificato del firmatario.

3. Decomprimi il software AWS IoT Greengrass Core in una cartella sul tuo dispositivo. Sostituiscilo GreengrassInstaller con la cartella che desideri utilizzare.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

4. (Facoltativo) Eseguite il comando seguente per visualizzare la versione del software AWS IoT Greengrass Core.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Per installare il software AWS IoT Greengrass Core

1. Controlla la versione del software AWS IoT Greengrass Core.

   • Sostituisci GreengrassInstaller con il percorso della cartella che contiene il software.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

2. Utilizzate un editor di testo per creare un file di configurazione denominato config.yaml da fornire all'installatore.

   Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

   nano GreengrassInstaller/config.yaml

   Copiate il seguente contenuto YAML nel file. Questo file di configurazione parziale specifica i parametri di sistema e i parametri del nucleo di Greengrass.

   ---
   system:
     certificateFilePath: "/greengrass/v2/device.pem.crt"
     privateKeyPath: "/greengrass/v2/private.pem.key"
     rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
     rootpath: "/greengrass/v2"
     thingName: "MyGreengrassCore"
   services:
     aws.greengrass.Nucleus:
       componentType: "NUCLEUS"
       version: "2.14.0"
       configuration:
         awsRegion: "us-west-2"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         fipsMode: "true"
         iotDataEndpoint: "data.iot-fips.us-west-2.amazonaws.com"
         greengrassDataPlaneEndpoint: "iotData"
         iotCredEndpoint: "data.credentials.iot-fips.us-west-2.amazonaws.com"

   Successivamente, esegui queste operazioni:

   • Sostituisci ogni istanza di /greengrass/v2 con la cartella principale di Greengrass.

   • Sostituisci MyGreengrassCore con il nome della AWS IoT cosa.

   • Sostituire 2.14.0 con la versione del software AWS IoT Greengrass Core.

   • Sostituisci us-west-2 con la Regione AWS posizione in cui hai creato le risorse.

   • Sostituisci GreengrassCoreTokenExchangeRoleAlias con il nome dell'alias del ruolo di scambio di token.

   • Sostituiscilo iotDataEndpoint con il tuo endpoint di AWS IoT dati.

   • Sostituisci l'iotCredEndpointendpoint con AWS IoT le tue credenziali.

3. Eseguite il programma di installazione e specificate di --init-config fornire il file di configurazione.

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   • Sostituisci ogni istanza di GreengrassInstaller con la cartella in cui hai decompresso il programma di installazione.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --init-config ./GreengrassInstaller/config.yaml ^
     --component-default-user ggc_user ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --init-config ./GreengrassInstaller/config.yaml `
     --component-default-user ggc_user `
     --setup-system-service true

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Importante

   Nei dispositivi Windows Core, è necessario specificare --setup-system-service true di configurare il software AWS IoT Greengrass Core come servizio di sistema.

   Se si specifica--setup-system-service true, il programma di installazione stampa Successfully set up Nucleus as a system service se ha configurato ed eseguito il software come servizio di sistema. In caso contrario, il programma di installazione non emette alcun messaggio se installa il software correttamente.

   Nota

   Non è possibile utilizzare l'deploy-dev-toolsargomento per distribuire strumenti di sviluppo locali quando si esegue il programma di installazione senza l'argomento. --provision true Per informazioni sulla distribuzione della CLI Greengrass direttamente sul dispositivo, consulta. Interfaccia a riga di comando Greengrass

4. Verifica l'installazione visualizzando i file nella cartella principale.

   Linux or Unix

   ls /greengrass/v2

   Windows Command Prompt (CMD)

   dir C:\greengrass\v2

   PowerShell

   ls C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   ls /greengrass/v2

   Se l'installazione è riuscita, la cartella principale contiene diverse cartelle, ad esempio configpackages, elogs.

Per installare il software AWS IoT Greengrass Core

1. Controlla la versione del software AWS IoT Greengrass Core.

   • Sostituisci GreengrassInstaller con il percorso della cartella che contiene il software.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

2. Per consentire al software AWS IoT Greengrass Core di utilizzare la chiave privata e il certificato nell'HSM, installate il componente del provider PKCS #11 quando installate il software AWS IoT Greengrass Core. Il componente del provider PKCS #11 è un plug-in che è possibile configurare durante l'installazione. È possibile scaricare la versione più recente del componente del provider PKCS #11 dalla seguente posizione:

   • https://d2s8p88vqu9w66.cloudfront. net/releases/Pkcs11Provider/aws.greengrass.crypto.pkcs11Provider-latest.jar

   Scarica il plugin del provider PKCS #11 in un file denominato. aws.greengrass.crypto.Pkcs11Provider.jar Sostituiscilo GreengrassInstaller con la cartella che desideri utilizzare.

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/Pkcs11Provider/aws.greengrass.crypto.Pkcs11Provider-latest.jar > GreengrassInstaller/aws.greengrass.crypto.Pkcs11Provider.jar

   Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

3. Utilizzate un editor di testo per creare un file di configurazione denominato config.yaml da fornire all'installatore.

   Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

   nano GreengrassInstaller/config.yaml

   Copiate il seguente contenuto YAML nel file. Questo file di configurazione parziale specifica i parametri di sistema, i parametri Greengrass nucleus e i parametri del provider PKCS #11.

   ---
   system:
     certificateFilePath: "/greengrass/v2/device.pem.crt"
     privateKeyPath: "/greengrass/v2/private.pem.key"
     rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
     rootpath: "/greengrass/v2"
     thingName: "MyGreengrassCore"
   services:
     aws.greengrass.Nucleus:
       componentType: "NUCLEUS"
       version: "2.14.0"
       configuration:
         awsRegion: "us-west-2"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         fipsMode: "true"
         iotDataEndpoint: "data.iot-fips.us-west-2.amazonaws.com"
         greengrassDataPlaneEndpoint: "iotData"
         iotCredEndpoint: "data.credentials.iot-fips.us-west-2.amazonaws.com"

   Successivamente, esegui queste operazioni:

   • Sostituisci ogni istanza di iotdevicekey PKCS #11 URIs con l'etichetta dell'oggetto in cui hai creato la chiave privata e importato il certificato.

   • Sostituisci ogni istanza di /greengrass/v2 con la cartella principale di Greengrass.

   • Sostituisci MyGreengrassCore con il nome della AWS IoT cosa.

   • Sostituire 2.14.0 con la versione del software AWS IoT Greengrass Core.

   • Sostituisci us-west-2 con la Regione AWS posizione in cui hai creato le risorse.

   • Sostituisci GreengrassCoreTokenExchangeRoleAlias con il nome dell'alias del ruolo di scambio di token.

   • Sostituiscilo iotDataEndpoint con il tuo endpoint di AWS IoT dati.

   • Sostituisci l'iotCredEndpointendpoint con AWS IoT le tue credenziali.

   • Sostituisci i parametri di configurazione per il aws.greengrass.crypto.Pkcs11Provider componente con i valori per la configurazione HSM sul dispositivo principale.

4. Eseguite il programma di installazione e specificate --init-config di fornire il file di configurazione.

   • Sostituisci /greengrass/v2 con la cartella principale di Greengrass.

   • Sostituisci ogni istanza di GreengrassInstaller con la cartella in cui hai decompresso il programma di installazione.

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.crypto.Pkcs11Provider.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Importante

   Nei dispositivi Windows Core, è necessario specificare --setup-system-service true di configurare il software AWS IoT Greengrass Core come servizio di sistema.

   Se si specifica--setup-system-service true, il programma di installazione stampa Successfully set up Nucleus as a system service se ha configurato ed eseguito il software come servizio di sistema. In caso contrario, il programma di installazione non emette alcun messaggio se installa il software correttamente.

   Nota

   Non è possibile utilizzare l'deploy-dev-toolsargomento per distribuire strumenti di sviluppo locali quando si esegue il programma di installazione senza l'argomento. --provision true Per informazioni sulla distribuzione della CLI Greengrass direttamente sul dispositivo, consulta. Interfaccia a riga di comando Greengrass

5. Verifica l'installazione visualizzando i file nella cartella principale.

   Linux or Unix

   ls /greengrass/v2

   Windows Command Prompt (CMD)

   dir C:\greengrass\v2

   PowerShell

   ls C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   ls /greengrass/v2

   Se l'installazione è riuscita, la cartella principale contiene diverse cartelle, ad esempio configpackages, elogs.

1. Ottieni l'endpoint di dati FIPS per la tua regione negli endpoint del piano dati AWS IoT Core FIPS. L'endpoint di dati FIPS per te dovrebbe avere il seguente aspetto: Account AWS data.iot-fips.us-west-2.amazonaws.com

2. Ottieni l'endpoint delle credenziali FIPS per la tua regione negli endpoint del AWS IoT Core piano dati FIPS. L'endpoint di credenziali FIPS per il tuo dovrebbe avere il seguente aspetto: Account AWS data.credentials.iot-fips.us-west-2.amazonaws.com

Per scaricare i certificati di richiesta sul dispositivo

1. Copia il certificato di richiesta e la chiave privata sul dispositivo. Se SSH e SCP sono abilitati sul computer di sviluppo e sul dispositivo, puoi utilizzare il scp comando sul tuo computer di sviluppo per trasferire il certificato di richiesta e la chiave privata. Il comando di esempio seguente trasferisce questi file in una cartella denominata claim-certs sul computer di sviluppo al dispositivo. Sostituiscilo device-ip-address con l'indirizzo IP del tuo dispositivo.

   scp -r claim-certs/ device-ip-address:~

2. Crea la cartella principale Greengrass sul dispositivo. Successivamente installerai il software AWS IoT Greengrass Core in questa cartella.

   Nota

   In Windows esiste un limite di lunghezza del percorso di 260 caratteri. Se usi Windows, usa una cartella principale come C:\greengrass\v2 o D:\greengrass\v2 per mantenere i percorsi dei componenti Greengrass al di sotto del limite di 260 caratteri.

   Linux or Unix

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

   Windows Command Prompt

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   PowerShell

   • Sostituisci C:\greengrass\v2 con la cartella da usare.

   mkdir C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt
   • PowerShell

   • /greengrass/v2Sostituiscilo con la cartella da usare.

   sudo mkdir -p /greengrass/v2

3. (Solo Linux) Imposta le autorizzazioni del genitore della cartella principale di Greengrass.

   • Sostituiscilo /greengrass con quello principale della cartella principale.

   sudo chmod 755 /greengrass

4. Sposta i certificati di reclamo nella cartella principale di Greengrass.

   • Sostituisci /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

   Linux or Unix

   sudo mv ~/claim-certs /greengrass/v2

   Windows Command Prompt (CMD)

   move %USERPROFILE%\claim-certs C:\greengrass\v2

   PowerShell

   mv -Path ~\claim-certs -Destination C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo mv ~/claim-certs /greengrass/v2

5. Scarica sia il CA1 certificato che il CA3certificato.

   Linux or Unix

   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

   Windows Command Prompt (CMD)

   curl -o C:\greengrass\v2\\AmazonRootCA1.pem https://www.amazontrust.com/repository/AmazonRootCA1.pem

   PowerShell

   iwr -Uri https://www.amazontrust.com/repository/AmazonRootCA1.pem -OutFile C:\greengrass\v2\\AmazonRootCA1.pem

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo curl -o - https://www.amazontrust.com/repository/AmazonRootCA3.pem >> /greengrass/v2/AmazonRootCA1.pem

Per configurare un dispositivo Linux per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva. I seguenti comandi mostrano come installare OpenJDK sul tuo dispositivo.

   • Per le distribuzioni basate su Debian o basate su Ubuntuu:

     sudo apt install default-jdk

   • Per le distribuzioni basate su Red Hat:

     sudo yum install java-11-openjdk-devel

   • Per Amazon Linux 2:

     sudo amazon-linux-extras install java-openjdk11

   • Per Amazon Linux 2023:

     sudo dnf install java-11-amazon-corretto -y

   Al termine dell'installazione, esegui il comando seguente per verificare che Java funzioni sul tuo dispositivo Linux.

   java -version

   Il comando stampa la versione di Java in esecuzione sul dispositivo. Ad esempio, su una distribuzione basata su Debian, l'output potrebbe essere simile all'esempio seguente.

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. (Facoltativo) Crea l'utente e il gruppo di sistema predefiniti che eseguono i componenti sul dispositivo. Puoi anche scegliere di lasciare che il programma di installazione del software AWS IoT Greengrass Core crei questo utente e gruppo durante l'installazione con l'argomento --component-default-user installer. Per ulteriori informazioni, consulta Argomenti dell'installatore.

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. Verificate che l'utente che esegue il software AWS IoT Greengrass Core (in genereroot) sia autorizzato a funzionare sudo con qualsiasi utente e gruppo.

   1. Eseguite il comando seguente per aprire il /etc/sudoers file.

      sudo visudo

   2. Verificate che l'autorizzazione per l'utente sia simile all'esempio seguente.

      root    ALL=(ALL:ALL) ALL

4. (Facoltativo) Per eseguire funzioni Lambda containerizzate, è necessario abilitare cgroups v1 e abilitare e montare i cgroup di memoria e dispositivi. Se non intendi eseguire funzioni Lambda containerizzate, puoi saltare questo passaggio.

   Per abilitare queste opzioni di cgroups, avvia il dispositivo con i seguenti parametri del kernel Linux.

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   Per informazioni sulla visualizzazione e l'impostazione dei parametri del kernel per il tuo dispositivo, consulta la documentazione del tuo sistema operativo e del boot loader. Segui le istruzioni per impostare in modo permanente i parametri del kernel.

5. Installa tutte le altre dipendenze richieste sul tuo dispositivo come indicato dall'elenco dei requisiti in. Requisiti per il dispositivo

Per configurare un dispositivo Windows per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva.

2. Controlla se Java è disponibile nella variabile di sistema PATH e aggiungilo in caso contrario. L' LocalSystem account esegue il software AWS IoT Greengrass Core, quindi è necessario aggiungere Java alla variabile di sistema PATH anziché alla variabile utente PATH per l'utente. Esegui questa operazione:

   1. Premi il tasto Windows per aprire il menu di avvio.

   2. Digita environment variables per cercare le opzioni di sistema dal menu di avvio.

   3. Nei risultati della ricerca del menu di avvio, scegli Modifica le variabili di ambiente di sistema per aprire la finestra delle proprietà del sistema.

   4. Scegli Variabili di ambiente... per aprire la finestra Variabili d'ambiente.

   5. In Variabili di sistema, seleziona Percorso, quindi scegli Modifica. Nella finestra Modifica variabile di ambiente, puoi visualizzare ogni percorso su una riga separata.

   6. Controlla se è presente il percorso della bin cartella di installazione di Java. Il percorso potrebbe essere simile all'esempio seguente.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. Se la bin cartella di installazione Java non è presente in Path, scegliete Nuovo per aggiungerla, quindi scegliete OK.

3. Aprite il prompt dei comandi di Windows (cmd.exe) come amministratore.

4. Crea l'utente predefinito nell' LocalSystem account sul dispositivo Windows. Sostituiscilo password con una password sicura.

   net user /add ggc_user password

   Suggerimento

   A seconda della configurazione di Windows, la password dell'utente potrebbe essere impostata per scadere in date future. Per garantire che le tue applicazioni Greengrass continuino a funzionare, tieni traccia della scadenza della password e aggiornala prima che scada. Puoi anche impostare la password dell'utente in modo che non scada mai.

   • Per verificare la scadenza di un utente e della relativa password, esegui il comando seguente.

     net user ggc_user | findstr /C:expires

   • Per impostare la password di un utente in modo che non scada mai, esegui il comando seguente.

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • Se utilizzi Windows 10 o versioni successive in cui il wmiccomando è obsoleto, esegui il comando seguente. PowerShell

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. Scarica e installa l'PsExecutilità di Microsoft sul dispositivo.

6. Utilizzate l' PsExec utilità per memorizzare il nome utente e la password per l'utente predefinito nell'istanza di Credential Manager per l' LocalSystem account. Sostituiscila password con la password dell'utente che hai impostato in precedenza.

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   Se l'icona PsExec License Agreementapre, scegli Acceptper accettare la licenza ed eseguire il comando.

   Nota

   Sui dispositivi Windows, l' LocalSystem account esegue il Greengrass nucleus ed è necessario utilizzare l' PsExec utilità per memorizzare le informazioni utente predefinite nell'account. LocalSystem L'utilizzo dell'applicazione Credential Manager archivia queste informazioni nell'account Windows dell'utente attualmente connesso, anziché nell'account. LocalSystem

Per scaricare il software AWS IoT Greengrass Core

1. Sul dispositivo principale, scaricate il software AWS IoT Greengrass Core in un file denominatogreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

2. (Facoltativo) Per verificare la firma del software Greengrass nucleus

   Nota

   Questa funzionalità è disponibile con Greengrass nucleus versione 2.9.5 e successive.

   1. Usa il seguente comando per verificare la firma del tuo artefatto Greengrass nucleus:

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

      anchoranchoranchor
      • Linux or Unix
      • Windows Command Prompt (CMD)
      • PowerShell

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   2. L'jarsignerinvocazione produce un output che indica i risultati della verifica.

      1. Se il file zip Greengrass nucleus è firmato, l'output contiene la seguente dichiarazione:

         jar verified.

      2. Se il file zip Greengrass nucleus non è firmato, l'output contiene la seguente dichiarazione:

         jar is unsigned.

   3. Se hai fornito l'-certsopzione Jarsigner insieme alle -verbose opzioni -verify e, l'output include anche informazioni dettagliate sul certificato del firmatario.

3. Decomprimi il software AWS IoT Greengrass Core in una cartella sul tuo dispositivo. Sostituiscilo GreengrassInstaller con la cartella che desideri utilizzare.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

4. (Facoltativo) Eseguite il comando seguente per visualizzare la versione del software AWS IoT Greengrass Core.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Per scaricare il plug-in per il provisioning AWS IoT della flotta

• Sul tuo dispositivo, scarica il plug-in AWS IoT Fleet Provisioning in un file denominato. aws.greengrass.FleetProvisioningByClaim.jar Sostituiscilo GreengrassInstaller con la cartella che desideri utilizzare.

  Linux or Unix

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  Windows Command Prompt (CMD)

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  PowerShell

  iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar -OutFile GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  anchoranchoranchor
  • Linux or Unix
  • Windows Command Prompt (CMD)
  • PowerShell

  curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/aws-greengrass-FleetProvisioningByClaim/fleetprovisioningbyclaim-latest.jar > GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar

  Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

Per installare il software Core AWS IoT Greengrass

1. Controlla la versione del software AWS IoT Greengrass Core.

   • Sostituisci GreengrassInstaller con il percorso della cartella che contiene il software.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

2. Utilizzate un editor di testo per creare un file di configurazione denominato config.yaml da fornire all'installatore.

   Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

   nano GreengrassInstaller/config.yaml

   Copiate il seguente contenuto YAML nel file. Questo file di configurazione parziale specifica i parametri per il plug-in Fleet Provisioning. Per ulteriori informazioni sulle opzioni che è possibile specificare, vedere. Configurare il plug-in per il provisioning AWS IoT della flotta

   Linux or Unix

   
   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
       configuration:
         fipsMode: "true"
         greengrassDataPlaneEndpoint: "iotData"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "data.iot-fips.us-west-2.amazonaws.com"
         iotCredEndpoint: "data.credentials.iot-fips.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   Windows

   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "C:\\greengrass\\v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "device-data-prefix-ats.iot.us-west-2.amazonaws.com"
         iotCredentialEndpoint: "device-credentials-prefix.credentials.iot.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "C:\\greengrass\\v2\\claim-certs\\claim.pem.crt"
         claimCertificatePrivateKeyPath: "C:\\greengrass\\v2\\claim-certs\\claim.private.pem.key"
         rootCaPath: "C:\\greengrass\\v2\\AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   anchoranchor
   • Linux or Unix
   • Windows

   
   ---
   services:
     aws.greengrass.Nucleus:
       version: "2.14.0"
       configuration:
         fipsMode: "true"
         greengrassDataPlaneEndpoint: "iotData"
     aws.greengrass.FleetProvisioningByClaim:
       configuration:
         rootPath: "/greengrass/v2"
         awsRegion: "us-west-2"
         iotDataEndpoint: "data.iot-fips.us-west-2.amazonaws.com"
         iotCredEndpoint: "data.credentials.iot-fips.us-west-2.amazonaws.com"
         iotRoleAlias: "GreengrassCoreTokenExchangeRoleAlias"
         provisioningTemplate: "GreengrassFleetProvisioningTemplate"
         claimCertificatePath: "/greengrass/v2/claim-certs/claim.pem.crt"
         claimCertificatePrivateKeyPath: "/greengrass/v2/claim-certs/claim.private.pem.key"
         rootCaPath: "/greengrass/v2/AmazonRootCA1.pem"
         templateParameters:
           ThingName: "MyGreengrassCore"
           ThingGroupName: "MyGreengrassCoreGroup"

   Successivamente, esegui queste operazioni:

   • Sostituire 2.14.0 con la versione del software AWS IoT Greengrass Core.

   • Sostituisci ogni istanza di /greengrass/v2 o C:\greengrass\v2 con la cartella principale di Greengrass.

     Nota

     Sui dispositivi Windows, è necessario specificare i separatori di percorso come doppie barre rovesciate (\\), ad esempio. C:\\greengrass\\v2

   • us-west-2Sostituiscilo con la AWS regione in cui hai creato il modello di provisioning e altre risorse.

   • Sostituiscilo iotDataEndpoint con il tuo endpoint di AWS IoT dati.

   • Sostituisci l'iotCredentialEndpointendpoint con AWS IoT le tue credenziali.

   • Sostituisci GreengrassCoreTokenExchangeRoleAlias con il nome dell'alias del ruolo di scambio di token.

   • Sostituiscilo GreengrassFleetProvisioningTemplate con il nome del modello di approvvigionamento della flotta.

   • Sostituisci il claimCertificatePath con il percorso del certificato di richiesta sul dispositivo.

   • Sostituiscilo claimCertificatePrivateKeyPath con il percorso della chiave privata del certificato di richiesta sul dispositivo.

   • Sostituisci i parametri del modello (templateParameters) con i valori da utilizzare per il provisioning del dispositivo. Questo esempio si riferisce al modello di esempio che definisce ThingName i ThingGroupName parametri.

3. Eseguire il programma di installazione. Specificate --trusted-plugin di fornire il plug-in Fleet Provisioning e specificate --init-config di fornire il file di configurazione.

   • Sostituisci /greengrass/v2 con la cartella principale di Greengrass.

   • Sostituisci ogni istanza di GreengrassInstaller con la cartella in cui hai decompresso il programma di installazione.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar ^
     --init-config ./GreengrassInstaller/config.yaml ^
     --component-default-user ggc_user ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar `
     --init-config ./GreengrassInstaller/config.yaml `
     --component-default-user ggc_user `
     --setup-system-service true

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --trusted-plugin ./GreengrassInstaller/aws.greengrass.FleetProvisioningByClaim.jar \
     --init-config ./GreengrassInstaller/config.yaml \
     --component-default-user ggc_user:ggc_group \
     --setup-system-service true

   Importante

   Nei dispositivi Windows Core, è necessario specificare --setup-system-service true di configurare il software AWS IoT Greengrass Core come servizio di sistema.

   Se si specifica--setup-system-service true, il programma di installazione stampa Successfully set up Nucleus as a system service se ha configurato ed eseguito il software come servizio di sistema. In caso contrario, il programma di installazione non emette alcun messaggio se installa il software correttamente.

   Nota

   Non è possibile utilizzare l'deploy-dev-toolsargomento per distribuire strumenti di sviluppo locali quando si esegue il programma di installazione senza l'argomento. --provision true Per informazioni sulla distribuzione della CLI Greengrass direttamente sul dispositivo, consulta. Interfaccia a riga di comando Greengrass

4. Verifica l'installazione visualizzando i file nella cartella principale.

   Linux or Unix

   ls /greengrass/v2

   Windows Command Prompt (CMD)

   dir C:\greengrass\v2

   PowerShell

   ls C:\greengrass\v2

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   ls /greengrass/v2

   Se l'installazione è riuscita, la cartella principale contiene diverse cartelle, ad esempio configpackages, elogs.

Per configurare un dispositivo Linux per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva. I seguenti comandi mostrano come installare OpenJDK sul tuo dispositivo.

   • Per le distribuzioni basate su Debian o basate su Ubuntuu:

     sudo apt install default-jdk

   • Per le distribuzioni basate su Red Hat:

     sudo yum install java-11-openjdk-devel

   • Per Amazon Linux 2:

     sudo amazon-linux-extras install java-openjdk11

   • Per Amazon Linux 2023:

     sudo dnf install java-11-amazon-corretto -y

   Al termine dell'installazione, esegui il comando seguente per verificare che Java funzioni sul tuo dispositivo Linux.

   java -version

   Il comando stampa la versione di Java in esecuzione sul dispositivo. Ad esempio, su una distribuzione basata su Debian, l'output potrebbe essere simile all'esempio seguente.

   openjdk version "11.0.9.1" 2020-11-04
   OpenJDK Runtime Environment (build 11.0.9.1+1-post-Debian-1deb10u2)
   OpenJDK 64-Bit Server VM (build 11.0.9.1+1-post-Debian-1deb10u2, mixed mode)

2. (Facoltativo) Crea l'utente e il gruppo di sistema predefiniti che eseguono i componenti sul dispositivo. Puoi anche scegliere di lasciare che il programma di installazione del software AWS IoT Greengrass Core crei questo utente e gruppo durante l'installazione con l'argomento --component-default-user installer. Per ulteriori informazioni, consulta Argomenti dell'installatore.

   sudo useradd --system --create-home ggc_user
   sudo groupadd --system ggc_group

3. Verificate che l'utente che esegue il software AWS IoT Greengrass Core (in genereroot) sia autorizzato a funzionare sudo con qualsiasi utente e gruppo.

   1. Eseguite il comando seguente per aprire il /etc/sudoers file.

      sudo visudo

   2. Verificate che l'autorizzazione per l'utente sia simile all'esempio seguente.

      root    ALL=(ALL:ALL) ALL

4. (Facoltativo) Per eseguire funzioni Lambda containerizzate, è necessario abilitare cgroups v1 e abilitare e montare i cgroup di memoria e dispositivi. Se non intendi eseguire funzioni Lambda containerizzate, puoi saltare questo passaggio.

   Per abilitare queste opzioni di cgroups, avvia il dispositivo con i seguenti parametri del kernel Linux.

   cgroup_enable=memory cgroup_memory=1 systemd.unified_cgroup_hierarchy=0

   Per informazioni sulla visualizzazione e l'impostazione dei parametri del kernel per il tuo dispositivo, consulta la documentazione del tuo sistema operativo e del boot loader. Segui le istruzioni per impostare in modo permanente i parametri del kernel.

5. Installa tutte le altre dipendenze richieste sul tuo dispositivo come indicato dall'elenco dei requisiti in. Requisiti per il dispositivo

Per configurare un dispositivo Windows per AWS IoT Greengrass V2

1. Installa il runtime Java, necessario per l'esecuzione del software AWS IoT Greengrass Core. Ti consigliamo di utilizzare le versioni di supporto a lungo termine di Amazon Corretto o OpenJDK. È richiesta la versione 8 o successiva.

2. Controlla se Java è disponibile nella variabile di sistema PATH e aggiungilo in caso contrario. L' LocalSystem account esegue il software AWS IoT Greengrass Core, quindi è necessario aggiungere Java alla variabile di sistema PATH anziché alla variabile utente PATH per l'utente. Esegui questa operazione:

   1. Premi il tasto Windows per aprire il menu di avvio.

   2. Digita environment variables per cercare le opzioni di sistema dal menu di avvio.

   3. Nei risultati della ricerca del menu di avvio, scegli Modifica le variabili di ambiente di sistema per aprire la finestra delle proprietà del sistema.

   4. Scegli Variabili di ambiente... per aprire la finestra Variabili d'ambiente.

   5. In Variabili di sistema, seleziona Percorso, quindi scegli Modifica. Nella finestra Modifica variabile di ambiente, puoi visualizzare ogni percorso su una riga separata.

   6. Controlla se è presente il percorso della bin cartella di installazione di Java. Il percorso potrebbe essere simile all'esempio seguente.

      C:\\Program Files\\Amazon Corretto\\jdk11.0.13_8\\bin

   7. Se la bin cartella di installazione Java non è presente in Path, scegliete Nuovo per aggiungerla, quindi scegliete OK.

3. Aprite il prompt dei comandi di Windows (cmd.exe) come amministratore.

4. Crea l'utente predefinito nell' LocalSystem account sul dispositivo Windows. Sostituiscilo password con una password sicura.

   net user /add ggc_user password

   Suggerimento

   A seconda della configurazione di Windows, la password dell'utente potrebbe essere impostata per scadere in date future. Per garantire che le tue applicazioni Greengrass continuino a funzionare, tieni traccia della scadenza della password e aggiornala prima che scada. Puoi anche impostare la password dell'utente in modo che non scada mai.

   • Per verificare la scadenza di un utente e della relativa password, esegui il comando seguente.

     net user ggc_user | findstr /C:expires

   • Per impostare la password di un utente in modo che non scada mai, esegui il comando seguente.

     wmic UserAccount where "Name='ggc_user'" set PasswordExpires=False

   • Se utilizzi Windows 10 o versioni successive in cui il wmiccomando è obsoleto, esegui il comando seguente. PowerShell

     Get-CimInstance -Query "SELECT * from Win32_UserAccount WHERE name = 'ggc_user'" | Set-CimInstance -Property @{PasswordExpires="False"}

5. Scarica e installa l'PsExecutilità di Microsoft sul dispositivo.

6. Utilizzate l' PsExec utilità per memorizzare il nome utente e la password per l'utente predefinito nell'istanza di Credential Manager per l' LocalSystem account. Sostituiscila password con la password dell'utente che hai impostato in precedenza.

   psexec -s cmd /c cmdkey /generic:ggc_user /user:ggc_user /pass:password

   Se l'icona PsExec License Agreementapre, scegli Acceptper accettare la licenza ed eseguire il comando.

   Nota

   Sui dispositivi Windows, l' LocalSystem account esegue il Greengrass nucleus ed è necessario utilizzare l' PsExec utilità per memorizzare le informazioni utente predefinite nell'account. LocalSystem L'utilizzo dell'applicazione Credential Manager archivia queste informazioni nell'account Windows dell'utente attualmente connesso, anziché nell'account. LocalSystem

Per fornire AWS le credenziali al dispositivo

• Fornisci AWS le tue credenziali al dispositivo in modo che l'installatore possa fornire le risorse AWS IoT e IAM per il tuo dispositivo principale. Per aumentare la sicurezza, ti consigliamo di ottenere credenziali temporanee per un ruolo IAM che consenta solo le autorizzazioni minime necessarie per il provisioning. Per ulteriori informazioni, consulta Policy IAM minima per l'installatore per il provisioning delle risorse.

  Nota

  Il programma di installazione non salva né archivia le tue credenziali.

  Sul dispositivo, esegui una delle seguenti operazioni per recuperare le credenziali e renderle disponibili al programma di installazione del AWS IoT Greengrass software Core:

  • (Consigliato) Utilizza credenziali temporanee da AWS IAM Identity Center

    1. Fornisci l'ID della chiave di accesso, la chiave di accesso segreta e il token di sessione dall'IAM Identity Center. Per ulteriori informazioni, consulta Aggiornamento manuale delle credenziali in Acquisizione e aggiornamento delle credenziali temporanee nella guida per l'utente di IAM Identity Center.

    2. Esegui i seguenti comandi per fornire le credenziali al software Core. AWS IoT Greengrass

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

       anchoranchoranchor
       • Linux or Unix
       • Windows Command Prompt (CMD)
       • PowerShell

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

  • Utilizza credenziali di sicurezza temporanee da un ruolo IAM:

    1. Fornisci l'ID della chiave di accesso, la chiave di accesso segreta e il token di sessione da un ruolo IAM che assumi. Per ulteriori informazioni su come recuperare queste credenziali, consulta la sezione Richiesta di credenziali di sicurezza temporanee nella Guida per l'utente IAM.

    2. Esegui i seguenti comandi per fornire le credenziali al software Core. AWS IoT Greengrass

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       set AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
       $env:AWS_SESSION_TOKEN="AQoDYXdzEJr1K...o5OytwEXAMPLE="

       anchoranchoranchor
       • Linux or Unix
       • Windows Command Prompt (CMD)
       • PowerShell

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
       export AWS_SESSION_TOKEN=AQoDYXdzEJr1K...o5OytwEXAMPLE=

  • Utilizza le credenziali a lungo termine di un utente IAM:

    1. Fornisci l'ID della chiave di accesso e la chiave di accesso segreta per il tuo utente IAM. Puoi creare un utente IAM per il provisioning da eliminare successivamente. Per la policy IAM da fornire all'utente, consultaPolicy IAM minima per l'installatore per il provisioning delle risorse. Per ulteriori informazioni su come recuperare le credenziali a lungo termine, consulta Managing access keys for IAM users nella IAM User Guide.

    2. Esegui i seguenti comandi per fornire le credenziali al AWS IoT Greengrass software Core.

       Linux or Unix

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       Windows Command Prompt (CMD)

       set AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       set AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

       PowerShell

       $env:AWS_ACCESS_KEY_ID="AKIAIOSFODNN7EXAMPLE"
       $env:AWS_SECRET_ACCESS_KEY="wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"

       anchoranchoranchor
       • Linux or Unix
       • Windows Command Prompt (CMD)
       • PowerShell

       export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
       export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

    3. (Facoltativo) Se hai creato un utente IAM per il provisioning del tuo dispositivo Greengrass, elimina l'utente.

    4. (Facoltativo) Se hai utilizzato l'ID della chiave di accesso e la chiave di accesso segreta di un utente IAM esistente, aggiorna le chiavi dell'utente in modo che non siano più valide. Per ulteriori informazioni, consulta Aggiornamento delle chiavi di accesso nella guida AWS Identity and Access Management per l'utente.

Per scaricare il software AWS IoT Greengrass Core

1. Sul dispositivo principale, scaricate il software AWS IoT Greengrass Core in un file denominatogreengrass-nucleus-latest.zip.

   Linux or Unix

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   PowerShell

   iwr -Uri https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip -OutFile greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   curl -s https://d2s8p88vqu9w66.cloudfront.net/releases/greengrass-nucleus-latest.zip > greengrass-nucleus-latest.zip

   Scaricando questo software accetti l'Accordo di licenza del software Greengrass Core.

2. (Facoltativo) Per verificare la firma del software Greengrass nucleus

   Nota

   Questa funzionalità è disponibile con Greengrass nucleus versione 2.9.5 e successive.

   1. Usa il seguente comando per verificare la firma del tuo artefatto Greengrass nucleus:

      Linux or Unix

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

      Windows Command Prompt (CMD)

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      "C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe" -verify -certs -verbose greengrass-nucleus-latest.zip

      PowerShell

      Il nome del file potrebbe avere un aspetto diverso a seconda della versione di JDK installata. jdk17.0.6_10Sostituiscilo con la versione JDK che hai installato.

      'C:\\Program Files\\Amazon Corretto\\jdk17.0.6_10\\bin\\jarsigner.exe' -verify -certs -verbose greengrass-nucleus-latest.zip

      anchoranchoranchor
      • Linux or Unix
      • Windows Command Prompt (CMD)
      • PowerShell

      jarsigner -verify -certs -verbose greengrass-nucleus-latest.zip

   2. L'jarsignerinvocazione produce un output che indica i risultati della verifica.

      1. Se il file zip Greengrass nucleus è firmato, l'output contiene la seguente dichiarazione:

         jar verified.

      2. Se il file zip Greengrass nucleus non è firmato, l'output contiene la seguente dichiarazione:

         jar is unsigned.

   3. Se hai fornito l'-certsopzione Jarsigner insieme alle -verbose opzioni -verify e, l'output include anche informazioni dettagliate sul certificato del firmatario.

3. Decomprimi il software AWS IoT Greengrass Core in una cartella sul tuo dispositivo. Sostituiscilo GreengrassInstaller con la cartella che desideri utilizzare.

   Linux or Unix

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

   Windows Command Prompt (CMD)

   mkdir GreengrassInstaller && tar -xf greengrass-nucleus-latest.zip -C GreengrassInstaller && del greengrass-nucleus-latest.zip

   PowerShell

   Expand-Archive -Path greengrass-nucleus-latest.zip -DestinationPath .\\GreengrassInstaller
   rm greengrass-nucleus-latest.zip

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   unzip greengrass-nucleus-latest.zip -d GreengrassInstaller && rm greengrass-nucleus-latest.zip

4. (Facoltativo) Eseguite il comando seguente per visualizzare la versione del software AWS IoT Greengrass Core.

   java -jar ./GreengrassInstaller/lib/Greengrass.jar --version

Per installare il software Core AWS IoT Greengrass

1. Utilizzate un editor di testo per creare un file di configurazione denominato config.yaml da fornire all'installatore.

   Ad esempio, su un sistema basato su Linux, è possibile eseguire il comando seguente per utilizzare GNU nano per creare il file.

   nano GreengrassInstaller/config.yaml

   Copiate il seguente contenuto YAML nel file. Questo file di configurazione parziale specifica i parametri di sistema e i parametri del nucleo di Greengrass.

   
   ---
   services:
     aws.greengrass.Nucleus:
       configuration:
         fipsMode: "true"
         iotDataEndpoint: "data.iot-fips.us-west-2.amazonaws.com"
         iotCredEndpoint: "data.credentials.iot-fips.us-west-2.amazonaws.com"
         greengrassDataPlaneEndpoint: "iotData"                        
                       

   • us-west-2Sostituiscilo con il Regione AWS punto in cui hai creato le risorse.

   • Sostituiscilo iotDataEndpoint con il tuo endpoint di AWS IoT dati.

   • Sostituisci l'iotCredEndpointendpoint con AWS IoT le tue credenziali.

2. Esegui il programma di installazione AWS IoT Greengrass Core. Sostituisci i valori degli argomenti nel tuo comando come segue.

   Nota

   In Windows esiste un limite di lunghezza del percorso di 260 caratteri. Se usi Windows, usa una cartella principale come C:\greengrass\v2 o D:\greengrass\v2 per mantenere i percorsi dei componenti Greengrass al di sotto del limite di 260 caratteri.

   1. /greengrass/v2oppureC:\greengrass\v2: il percorso della cartella principale da utilizzare per installare il software AWS IoT Greengrass Core.

   2. GreengrassInstaller. Il percorso della cartella in cui è stato decompresso il programma di installazione del software AWS IoT Greengrass Core.

   3. region. Il Regione AWS luogo in cui trovare o creare risorse.

   4. MyGreengrassCore. Il nome del AWS IoT dispositivo principale Greengrass. Se l'oggetto non esiste, l'installatore lo crea. Il programma di installazione scarica i certificati per autenticarsi come oggetto. AWS IoT Per ulteriori informazioni, consulta Autenticazione e autorizzazione del dispositivo per AWS IoT Greengrass.

      Nota

      Il nome dell'oggetto non può contenere i due punti (:).

   5. MyGreengrassCoreGroup. Il nome del AWS IoT gruppo di oggetti per il tuo dispositivo principale Greengrass. Se il gruppo di oggetti non esiste, il programma di installazione lo crea e vi aggiunge l'oggetto. Se il gruppo di oggetti esiste e dispone di una distribuzione attiva, il dispositivo principale scarica ed esegue il software specificato dalla distribuzione.

      Nota

      Il nome del gruppo di cose non può contenere i due punti (:).

   6. GreengrassV2IoTThingPolicy. Il nome della AWS IoT policy che consente ai dispositivi core Greengrass di comunicare con AWS IoT e. AWS IoT Greengrass Se la AWS IoT politica non esiste, il programma di installazione crea una AWS IoT politica permissiva con questo nome. Puoi limitare le autorizzazioni di questa politica in base al tuo caso d'uso. Per ulteriori informazioni, consulta AWS IoT Politica minima per i dispositivi AWS IoT Greengrass V2 principali.

   7. GreengrassV2TokenExchangeRole. Il nome del ruolo IAM che consente al dispositivo principale Greengrass di ottenere credenziali temporanee AWS . Se il ruolo non esiste, l'installatore lo crea e crea e allega una policy denominata. GreengrassV2TokenExchangeRoleAccess Per ulteriori informazioni, consulta Autorizza i dispositivi principali a interagire con i servizi AWS.

   8. GreengrassCoreTokenExchangeRoleAlias. L'alias del ruolo IAM che consente al dispositivo principale Greengrass di ottenere credenziali temporanee in un secondo momento. Se l'alias del ruolo non esiste, il programma di installazione lo crea e lo indirizza al ruolo IAM specificato. Per ulteriori informazioni, consulta Autorizza i dispositivi principali a interagire con i servizi AWS.

   Linux or Unix

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --init-config ./GreengrassInstaller/config.yaml \
     --setup-system-service true

   Windows Command Prompt (CMD)

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" ^
     -jar ./GreengrassInstaller/lib/Greengrass.jar ^
     --aws-region region ^
     --thing-name MyGreengrassCore ^
     --thing-group-name MyGreengrassCoreGroup ^
     --thing-policy-name GreengrassV2IoTThingPolicy ^
     --tes-role-name GreengrassV2TokenExchangeRole ^
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias ^
     --component-default-user ggc_user ^
     --provision true ^
     --setup-system-service true

   PowerShell

   java -Droot="C:\greengrass\v2" "-Dlog.store=FILE" `
     -jar ./GreengrassInstaller/lib/Greengrass.jar `
     --aws-region region `
     --thing-name MyGreengrassCore `
     --thing-group-name MyGreengrassCoreGroup `
     --thing-policy-name GreengrassV2IoTThingPolicy `
     --tes-role-name GreengrassV2TokenExchangeRole `
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias `
     --component-default-user ggc_user `
     --provision true `
     --setup-system-service true

   anchoranchoranchor
   • Linux or Unix
   • Windows Command Prompt (CMD)
   • PowerShell

   sudo -E java -Droot="/greengrass/v2" -Dlog.store=FILE \
     -jar ./GreengrassInstaller/lib/Greengrass.jar \
     --aws-region region \
     --thing-name MyGreengrassCore \
     --thing-group-name MyGreengrassCoreGroup \
     --thing-policy-name GreengrassV2IoTThingPolicy \
     --tes-role-name GreengrassV2TokenExchangeRole \
     --tes-role-alias-name GreengrassCoreTokenExchangeRoleAlias \
     --component-default-user ggc_user:ggc_group \
     --provision true \
     --init-config ./GreengrassInstaller/config.yaml \
     --setup-system-service true

   Importante

   Nei dispositivi Windows core, è necessario specificare --setup-system-service true di configurare il software AWS IoT Greengrass Core come servizio di sistema.

   Il programma di installazione stampa i seguenti messaggi se riesce:

   • Se si specifica--provision, il programma di installazione stampa Successfully configured Nucleus with provisioned resource details se ha configurato correttamente le risorse.

   • Se si specifica--deploy-dev-tools, il programma di installazione stampa Configured Nucleus to deploy aws.greengrass.Cli component se ha creato la distribuzione con successo.

   • Se si specifica--setup-system-service true, il programma di installazione stampa Successfully set up Nucleus as a system service se ha configurato ed eseguito il software as a service.

   • Se non viene specificato--setup-system-service true, il programma di installazione stampa Launched Nucleus successfully se l'operazione è riuscita ed ha eseguito il software.

3. Salta questo passaggio se hai installato Nucleo Greengrass la versione 2.0.4 o successiva. Se hai scaricato la versione più recente del software, hai installato la versione 2.0.4 o successiva.

   Esegui il comando seguente per impostare le autorizzazioni di file richieste per la cartella AWS IoT Greengrass principale del software Core. Sostituitela /greengrass/v2 con la cartella principale specificata nel comando di installazione e /greengrass sostituitela con la cartella principale della cartella principale.

   sudo chmod 755 /greengrass/v2 && sudo chmod 755 /greengrass