Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du logiciel AWS IoT Greengrass de base

Le logiciel AWS IoT Greengrass Core propose des options que vous pouvez utiliser pour configurer le logiciel. Vous pouvez créer des déploiements pour configurer le logiciel AWS IoT Greengrass principal sur chaque appareil principal.

Déployez le composant Greengrass nucleus

AWS IoT Greengrass fournit le logiciel AWS IoT Greengrass Core sous forme de composant que vous pouvez déployer sur vos appareils principaux Greengrass. Vous pouvez créer un déploiement pour appliquer la même configuration à plusieurs appareils principaux de Greengrass. Pour plus d’informations, consultez Noyau de Greengrass et Mettre à jour le logiciel AWS IoT Greengrass principal (OTA).

Configurer le noyau Greengrass en tant que service système

Vous devez configurer le logiciel AWS IoT Greengrass Core en tant que service système dans le système d'initialisation de votre appareil pour effectuer les opérations suivantes :

Configurer le noyau en tant que service système (Linux)

Les appareils Linux prennent en charge différents systèmes d'initialisation, tels que initd, systemd et systemV. Vous utilisez --setup-system-service true cet argument lorsque vous installez le logiciel AWS IoT Greengrass Core pour démarrer le noyau en tant que service système et le configurez pour qu'il soit lancé au démarrage du périphérique. Le programme d'installation configure le logiciel AWS IoT Greengrass Core en tant que service système avec systemd.

Vous pouvez également configurer manuellement le noyau pour qu'il s'exécute en tant que service système. L'exemple suivant est un fichier de service pour systemd.

[Unit]
Description=Greengrass Core

[Service]
Type=simple
PIDFile=/greengrass/v2/alts/loader.pid
RemainAfterExit=no
Restart=on-failure
RestartSec=10
ExecStart=/bin/sh /greengrass/v2/alts/current/distro/bin/loader

[Install]
WantedBy=multi-user.target

Après avoir configuré le service système, vous pouvez exécuter les commandes suivantes pour configurer le démarrage du périphérique au démarrage et pour démarrer ou arrêter le logiciel AWS IoT Greengrass Core.

Configuration du noyau en tant que service système (Windows)

Vous utilisez --setup-system-service true cet argument lorsque vous installez le logiciel AWS IoT Greengrass Core pour démarrer le noyau en tant que service Windows et le configurez pour qu'il démarre au démarrage du périphérique.

Après avoir configuré le service, vous pouvez exécuter les commandes suivantes pour configurer le démarrage du périphérique au démarrage et pour démarrer ou arrêter le logiciel AWS IoT Greengrass Core. Vous devez exécuter l'invite de commande ou PowerShell en tant qu'administrateur pour exécuter ces commandes.

Windows Command Prompt (CMD)

• Pour vérifier l'état du service

  sc query "greengrass"

• Pour permettre au noyau de démarrer au démarrage de l'appareil.

  sc config "greengrass" start=auto

• Pour empêcher le noyau de démarrer au démarrage de l'appareil.

  sc config "greengrass" start=disabled

• Pour démarrer le logiciel AWS IoT Greengrass Core.

  sc start "greengrass"

• Pour arrêter le logiciel AWS IoT Greengrass Core.

  sc stop "greengrass"

  Note

  Sur les appareils Windows, le logiciel AWS IoT Greengrass Core ignore ce signal d'arrêt lorsqu'il arrête les processus des composants Greengrass. Si le logiciel AWS IoT Greengrass Core ignore le signal d'arrêt lorsque vous exécutez cette commande, attendez quelques secondes, puis réessayez.

PowerShell

• Pour vérifier l'état du service

  Get-Service -Name "greengrass"

• Pour permettre au noyau de démarrer au démarrage de l'appareil.

  Set-Service -Name "greengrass" -Status stopped -StartupType automatic

• Pour empêcher le noyau de démarrer au démarrage de l'appareil.

  Set-Service -Name "greengrass" -Status stopped -StartupType disabled

• Pour démarrer le logiciel AWS IoT Greengrass Core.

  Start-Service -Name "greengrass"

• Pour arrêter le logiciel AWS IoT Greengrass Core.

  Stop-Service -Name "greengrass"

  Note

  Sur les appareils Windows, le logiciel AWS IoT Greengrass Core ignore ce signal d'arrêt lorsqu'il arrête les processus des composants Greengrass. Si le logiciel AWS IoT Greengrass Core ignore le signal d'arrêt lorsque vous exécutez cette commande, attendez quelques secondes, puis réessayez.

Contrôlez l'allocation de mémoire à l'aide JVM d'options

Si vous utilisez AWS IoT Greengrass un appareil dont la mémoire est limitée, vous pouvez utiliser les options de machine virtuelle Java (JVM) pour contrôler la taille maximale du tas, les modes de collecte des déchets et les options du compilateur, qui contrôlent la quantité de mémoire utilisée par le logiciel AWS IoT Greengrass Core. La taille du segment de mémoire JVM détermine la quantité de mémoire qu'une application peut utiliser avant la collecte des déchets ou avant que l'application ne manque de mémoire. La taille maximale du tas indique la quantité maximale de mémoire qu'il est JVM possible d'allouer lors de l'extension du tas lors d'une activité intense.

Pour contrôler l'allocation de mémoire, créez un nouveau déploiement ou révisez un déploiement existant qui inclut le composant noyau, et spécifiez vos JVM options dans le paramètre de jvmOptions configuration de la configuration du composant noyau.

Selon vos besoins, vous pouvez exécuter le logiciel AWS IoT Greengrass Core avec une allocation de mémoire réduite ou avec une allocation de mémoire minimale.

Allocation de mémoire réduite

Pour exécuter le logiciel AWS IoT Greengrass Core avec une allocation de mémoire réduite, nous vous recommandons d'utiliser l'exemple de mise à jour de fusion de configuration suivant pour définir JVM les options de votre configuration Nucleus :

{
  "jvmOptions": "-XX:+UseSerialGC -XX:TieredStopAtLevel=1"
}

Allocation de mémoire minimale

Pour exécuter le logiciel AWS IoT Greengrass Core avec une allocation de mémoire minimale, nous vous recommandons d'utiliser l'exemple de mise à jour de fusion de configuration suivant pour définir JVM les options de votre configuration Nucleus :

{
  "jvmOptions": "-Xmx32m -XX:+UseSerialGC -Xint"
}

Ces exemples de mise à jour par fusion de configuration utilisent les JVM options suivantes :

Pour plus d'informations sur la création de mises à jour de fusion de configuration, consultezMettre à jour les configurations des composants.

Configurer l'utilisateur qui exécute les composants

Le logiciel AWS IoT Greengrass Core peut exécuter des processus de composants en tant qu'utilisateur du système et en tant que groupe différent de celui qui exécute le logiciel. Cela augmente la sécurité, car vous pouvez exécuter le logiciel AWS IoT Greengrass principal en tant que root ou en tant qu'utilisateur administrateur, sans accorder ces autorisations aux composants qui s'exécutent sur le périphérique principal.

Le tableau suivant indique les types de composants que le logiciel AWS IoT Greengrass Core peut exécuter en tant qu'utilisateur que vous spécifiez. Pour de plus amples informations, veuillez consulter Types de composants.

Vous devez créer l'utilisateur du composant avant de pouvoir le spécifier dans une configuration de déploiement. Sur les appareils Windows, vous devez également enregistrer le nom d'utilisateur et le mot de passe de l'utilisateur dans l'instance du gestionnaire d'informations d'identification du LocalSystem compte. Pour de plus amples informations, veuillez consulter Configuration d'un utilisateur de composant sur les appareils Windows.

Lorsque vous configurez l'utilisateur du composant sur un appareil basé sur Linux, vous pouvez éventuellement spécifier un groupe. Vous spécifiez l'utilisateur et le groupe séparés par deux points (:) au format suivant : user:group Si vous ne spécifiez aucun groupe, le logiciel AWS IoT Greengrass Core utilise par défaut le groupe principal de l'utilisateur. Vous pouvez utiliser le nom ou l'ID pour identifier l'utilisateur et le groupe.

Sur les appareils basés sur Linux, vous pouvez également exécuter des composants en tant qu'utilisateur du système qui n'existe pas, également appelé utilisateur inconnu, pour renforcer la sécurité. Un processus Linux peut signaler tout autre processus exécuté par le même utilisateur. Un utilisateur inconnu n'exécute aucun autre processus. Vous pouvez donc exécuter des composants en tant qu'utilisateur inconnu pour empêcher les composants de signaler d'autres composants sur le périphérique principal. Pour exécuter des composants en tant qu'utilisateur inconnu, spécifiez un ID utilisateur qui n'existe pas sur le périphérique principal. Vous pouvez également spécifier un ID de groupe qui n'existe pas pour fonctionner en tant que groupe inconnu.

Vous pouvez configurer l'utilisateur pour chaque composant et pour chaque périphérique principal.

Configuration d'un utilisateur de composant sur les appareils Windows

Configuration de l'utilisateur du composant par défaut

Vous pouvez utiliser un déploiement pour configurer l'utilisateur par défaut sur un appareil principal. Dans ce déploiement, vous mettez à jour la configuration des composants du noyau.

Créez un déploiement qui spécifie la mise à jour de configuration suivante pour le aws.greengrass.Nucleus composant.

Linux

{
  "runWithDefault": {
    "posixUser": "ggc_user:ggc_group"
  }
}

Windows

{
  "runWithDefault": {
    "windowsUser": "ggc_user"
  }
}

Note

L'utilisateur que vous spécifiez doit exister, et le nom d'utilisateur et le mot de passe de cet utilisateur doivent être stockés dans l'instance du gestionnaire d'informations d'identification du LocalSystem compte sur votre appareil Windows. Pour de plus amples informations, veuillez consulter Configuration d'un utilisateur de composant sur les appareils Windows.

L'exemple suivant définit un déploiement pour un appareil basé sur Linux configuré en tant qu'utilisateur par défaut et ggc_user ggc_group en tant que groupe par défaut. La mise à jour de merge configuration nécessite un JSON objet sérialisé.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"posixUser\":\"ggc_user:ggc_group\"}}"
      }
    }
  }
}

Configuration des limites de ressources système pour les composants

Vous pouvez configurer la quantité CPU et l'RAMutilisation maximales que les processus de chaque composant peuvent utiliser sur le périphérique principal.

Le tableau suivant indique les types de composants compatibles avec les limites de ressources du système. Pour de plus amples informations, veuillez consulter Types de composants.

Vous pouvez configurer les limites de ressources système pour chaque composant et pour chaque périphérique principal.

Configuration des limites de ressources système par défaut

Vous pouvez déployer le composant Greengrass nucleus pour configurer les limites de ressources système par défaut pour un périphérique principal. Pour configurer les limites de ressources système par défaut, créez un déploiement qui spécifie la mise à jour de configuration suivante pour le aws.greengrass.Nucleus composant.

{
  "runWithDefault": {
    "systemResourceLimits": {
      "cpu": cpuTimeLimit,
      "memory": memoryLimitInKb
    }
  }
}

L'exemple suivant définit un déploiement qui configure la limite de CPU temps à2, ce qui équivaut à 50 % d'utilisation sur un appareil à 4 CPU cœurs. Cet exemple configure également l'utilisation de la mémoire à 100 Mo.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"runWithDefault\":{\"systemResourceLimits\":\"cpus\":2,\"memory\":102400}}}"
      }
    }
  }
}

Connexion au port 443 ou via un proxy réseau

AWS IoT Greengrass les périphériques principaux communiquent avec eux AWS IoT Core en utilisant le protocole MQTT de messagerie avec authentification TLS du client. Par convention, MQTT over TLS utilise le port 8883. Toutefois, par mesure de sécurité, les environnements restrictifs peuvent limiter le trafic entrant et sortant à un petit nombre de TCP ports. Par exemple, un pare-feu d'entreprise peut ouvrir le port 443 pour le HTTPS trafic, mais fermer d'autres ports utilisés pour des protocoles moins courants, tels que le port 8883 pour le MQTT trafic. D'autres environnements restrictifs peuvent exiger que tout le trafic passe par un proxy avant de se connecter à Internet.

Pour activer la communication dans ces scénarios, AWS IoT Greengrass propose les options de configuration suivantes :

Configuration MQTT via le port 443

Vous pouvez configurer MQTT via le port 443 sur des périphériques principaux existants ou lorsque vous installez le logiciel AWS IoT Greengrass Core sur un nouveau périphérique principal.

Configuration MQTT via le port 443 sur les périphériques principaux existants

Vous pouvez utiliser un déploiement pour configurer MQTT via le port 443 sur un périphérique central ou un groupe de périphériques principaux. Dans ce déploiement, vous mettez à jour la configuration des composants du noyau. Le noyau redémarre lorsque vous mettez à jour sa mqtt configuration.

Pour configurer MQTT via le port 443, créez un déploiement qui spécifie la mise à jour de configuration suivante pour le aws.greengrass.Nucleus composant.

{
  "mqtt": {
    "port": 443
  }
}

L'exemple suivant définit un déploiement configuré MQTT via le port 443. La mise à jour de merge configuration nécessite un JSON objet sérialisé.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"mqtt\":{\"port\":443}}"
      }
    }
  }
}

Configuration MQTT via le port 443 lors de l'installation

Vous pouvez configurer MQTT via le port 443 lorsque vous installez le logiciel AWS IoT Greengrass Core sur un périphérique principal. Utilisez l'argument du programme d'--init-configinstallation pour configurer MQTT via le port 443. Vous pouvez spécifier cet argument lors de l'installation à l'aide du provisionnement manuel, du provisionnement du parc ou du provisionnement personnalisé.

Configuration HTTPS via le port 443

Cette fonctionnalité nécessite la Noyau de Greengrass version 2.0.4 ou ultérieure.

Vous pouvez configurer HTTPS via le port 443 sur des périphériques principaux existants ou lorsque vous installez le logiciel AWS IoT Greengrass Core sur un nouveau périphérique principal.

Configuration HTTPS via le port 443 sur les périphériques principaux existants

Vous pouvez utiliser un déploiement pour configurer HTTPS via le port 443 sur un périphérique central ou un groupe de périphériques principaux. Dans ce déploiement, vous mettez à jour la configuration des composants du noyau.

Pour configurer HTTPS via le port 443, créez un déploiement qui spécifie la mise à jour de configuration suivante pour le aws.greengrass.Nucleus composant.

{
  "greengrassDataPlanePort": 443
}

L'exemple suivant définit un déploiement configuré HTTPS via le port 443. La mise à jour de merge configuration nécessite un JSON objet sérialisé.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"greengrassDataPlanePort\":443}"
      }
    }
  }
}

Configuration HTTPS via le port 443 lors de l'installation

Vous pouvez configurer HTTPS via le port 443 lorsque vous installez le logiciel AWS IoT Greengrass Core sur un périphérique principal. Utilisez l'argument du programme d'--init-configinstallation pour configurer HTTPS via le port 443. Vous pouvez spécifier cet argument lors de l'installation à l'aide du provisionnement manuel, du provisionnement du parc ou du provisionnement personnalisé.

Configuration d'un proxy réseau

Suivez la procédure décrite dans cette section pour configurer les appareils principaux de Greengrass afin qu'ils se connectent à Internet via un proxy HTTP ou un proxy HTTPS réseau. Pour plus d'informations sur les points de terminaison et les ports utilisés par les appareils principaux, consultezAutoriser le trafic des appareils via un proxy ou un pare-feu.

Configuration d'un proxy réseau sur les appareils principaux existants

Vous pouvez utiliser un déploiement pour configurer un proxy réseau sur un périphérique central unique ou sur un groupe de périphériques principaux. Dans ce déploiement, vous mettez à jour la configuration des composants du noyau. Le noyau redémarre lorsque vous mettez à jour sa networkProxy configuration.

Pour configurer un proxy réseau, créez un déploiement pour le aws.greengrass.Nucleus composant qui fusionne la mise à jour de configuration suivante. Cette mise à jour de configuration contient l'networkProxy objet.

{
  "networkProxy": {
    "noProxyAddresses": "http://192.168.0.1,www.example.com",
    "proxy": {
      "url": "https://my-proxy-server:1100"
    }
  }
}

L'exemple suivant définit un déploiement qui configure un proxy réseau. La mise à jour de merge configuration nécessite un JSON objet sérialisé.

{
  "components": {
    "aws.greengrass.Nucleus": {
      "version": "2.13.0",
      "configurationUpdate": {
        "merge": "{\"networkProxy\":{\"noProxyAddresses\":\"http://192.168.0.1,www.example.com\",\"proxy\":{\"url\":\"https://my-proxy-server:1100\",\"username\":\"Mary_Major\",\"password\":\"pass@word1357\"}}}"
      }
    }
  }
}

Configuration d'un proxy réseau lors de l'installation

Vous pouvez configurer un proxy réseau lorsque vous installez le logiciel AWS IoT Greengrass Core sur un périphérique principal. Utilisez l'argument du programme d'--init-configinstallation pour configurer le proxy réseau. Vous pouvez spécifier cet argument lors de l'installation à l'aide du provisionnement manuel, du provisionnement du parc ou du provisionnement personnalisé.

Permettre au périphérique principal de faire confiance à un HTTPS proxy

Lorsque vous configurez un périphérique principal pour utiliser un HTTPS proxy, vous devez ajouter la chaîne de certificats du serveur proxy à celle du périphérique principal pour lui permettre de faire confiance au HTTPS proxy. Dans le cas contraire, le périphérique principal risque de rencontrer des erreurs lorsqu'il tente d'acheminer le trafic via le proxy. Ajoutez le certificat CA du serveur proxy au fichier de certificat CA racine Amazon de l'appareil principal.

L' networkProxy objet

Utilisez l'objet networkProxy pour spécifier les informations sur le proxy réseau. Cet objet contient les informations suivantes :

Utiliser un certificat d'appareil signé par une autorité de certification privée

Si vous utilisez une autorité de certification privée (CA) personnalisée, vous devez définir le noyau greengrassDataPlaneEndpoint de Greengrass sur. iotdata Vous pouvez définir cette option lors du déploiement ou de l'installation à l'aide de l'argument --init-config installer.

Vous pouvez personnaliser le point de terminaison du plan de données Greengrass auquel l'appareil se connecte. Vous pouvez définir cette option de configuration iotdata pour définir le point de terminaison du plan de données Greengrass sur le même point de terminaison que le point de terminaison de données IoT, que vous pouvez spécifier avec le. iotDataEndpoint

Configuration des MQTT délais d'expiration et des paramètres de cache

Dans l' AWS IoT Greengrass environnement, les composants peuvent être utilisés MQTT pour communiquer avec AWS IoT Core. Le logiciel AWS IoT Greengrass Core gère les MQTT messages pour les composants. Lorsque le périphérique principal perd la connexion au AWS Cloud, le logiciel met en cache les MQTT messages pour réessayer ultérieurement lorsque la connexion sera rétablie. Vous pouvez configurer des paramètres tels que les délais d'expiration des messages et la taille du cache. Pour plus d'informations, consultez les paramètres de mqtt.spooler configuration mqtt et du composant Greengrass nucleus.

AWS IoT Core impose des quotas de service à son courtier de MQTT messages. Ces quotas peuvent s'appliquer aux messages que vous envoyez entre des appareils principaux et AWS IoT Core. Pour plus d'informations, consultez la section sur les quotas de service du courtier de AWS IoT Core messages dans le Références générales AWS.