View a markdown version of this page

Déployer le SDK Hub avec systemd - Intégrations gérées pour AWS IoT Device Management
Présentation deConditions préalablesStructure de fichierConfiguration initiale duCopier des fichiers sur le hubConfigurer le hubGestion des services 

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.

Déployer le SDK Hub avec systemd

Important

Suivez le hubSystemdSetup répertoire readme.md du fichier release.tgz pour obtenir les dernières mises à jour.

Cette section décrit les scripts et les processus de déploiement et de configuration des services sur un périphérique du Linux-based hub.

Présentation de

Le processus de déploiement comprend deux scripts principaux :

  • copy_to_hub.sh: s'exécute sur la machine hôte pour copier les fichiers nécessaires sur le hub

  • setup_hub.sh: s'exécute sur le hub pour configurer l'environnement et déployer les services

En outre, systemd/deploy_iotshd_services_on_hub.sh gère la séquence d'amorçage des processus et la gestion des autorisations de processus, et est automatiquement déclenché parsetup_hub.sh.

Conditions préalables

Les conditions requises répertoriées sont requises pour un déploiement réussi.

  • le service systemd est disponible sur le hub

  • Accès SSH au périphérique hub

  • Privilèges Sudo sur le périphérique du hub

  • scputilitaire installé sur la machine hôte

  • sedutilitaire installé sur la machine hôte

  • utilitaire de décompression installé sur la machine hôte

Structure de fichier

La structure du fichier est conçue pour faciliter l'organisation et la gestion de ses différents composants, en permettant un accès et une navigation efficaces dans le contenu.

hubSystemdSetup/
├── README.md
├── copy_to_hub.sh 
├── setup_hub.sh
├── iotshd_config.json  # Sample configuration file
├── local_certs/  # Directory for DHA certificates
└── systemd/ 
    ├── *.service.template  # Systemd service templates 
    └── deploy_iotshd_services_on_hub.sh

Dans le fichier tgz de la version SDK, la structure globale du fichier est la suivante :

IoT-managed-integrations-Hub-SDK-aarch64-v1.0.0.tgz
├──package/
    ├──greengrass/
        ├──artifacts/
        ├──recipes/
    ├──hubSystemdSetup/
        ├── REAME.md
        ├── copy_to_hub.sh 
        ├── setup_hub.sh
        ├── iotshd_config.json  # Sample configuration file
        ├── local_certs/  # Directory for DHA certificates
        └── systemd/ 
            ├── *.service.template  # Systemd service templates 
            └── deploy_iotshd_services_on_hub.sh

Configuration initiale du

Extraire le package du SDK

tar -xzf managed-integrations-Hub-SDK-vVersion-linux-aarch64-timestamp.tgz

Accédez au répertoire extrait et préparez le package :

# Create package.zip containing required artifacts
zip -r package.zip package/greengrass/artifacts
# Move package.zip to the hubSystemdSetup directory
mv package.zip ../hubSystemdSetup/

Ajouter des fichiers de configuration de l'appareil

Suivez les deux étapes répertoriées pour créer les fichiers de configuration de l'appareil et copiez-les dans le hub.

  1. Ajoutez des fichiers de configuration de périphérique pour créer les fichiers de configuration de périphérique nécessaires. Le SDK utilise ce fichier pour sa fonction.

  2. Copiez les fichiers de configuration pour copier les fichiers de configuration créés sur le hub.

Copier des fichiers sur le hub

Exécutez le script de déploiement depuis votre machine hôte :

chmod +x copy_to_hub.sh
./copy_to_hub.sh hub_ip_address package_file
Exemple Exemple
./copy_to_hub.sh 192.168.50.223 ~/Downloads/EAR3-package.zip

Cela copie :

  • Le fichier du package (renommé package.zip sur le hub)

  • Fichiers de configuration

  • Certificates

  • fichiers de service Systemd

Configurer le hub

Une fois les fichiers copiés, connectez-vous au hub en SSH et exécutez le script de configuration :

ssh hub@hub_ip
chmod +x setup_hub.sh
sudo ./setup_hub.sh

Configurations des utilisateurs et des groupes

Par défaut, nous utilisons le hub utilisateur et le hub de groupe pour les composants du SDK. Il existe plusieurs manières de les configurer :

  • Utilisez une option personnalisée user/group :

    sudo ./setup_hub.sh --user=USERNAME --group=GROUPNAME

  • Créez-les manuellement avant d'exécuter le script de configuration :

    sudo groupadd -f GROUPNAME
sudo useradd -r -g GROUPNAME USERNAME

  • Ajoutez les commandessetup_hub.sh.

Gestion des services 

Pour redémarrer tous les services, exécutez le script suivant depuis le hub :

sudo /usr/local/bin/deploy_iotshd_services_on_hub.sh

Le script de configuration créera les répertoires nécessaires, définira les autorisations appropriées et déploiera les services automatiquement. Si vous ne l'utilisez pas SSH/SCP, vous devez le modifier en copy_to_hub.sh fonction de votre méthode de déploiement spécifique. Assurez-vous que tous les fichiers de certificats et toutes les configurations sont correctement configurés avant le déploiement.