Connecter des appareils

IronFlock supporte plusieurs façons de connecter des appareils, selon le matériel et le système d’exploitation. Pas de matériel sous la main ? Vous pouvez simuler un appareil sur votre ordinateur portable en quelques minutes.

Prérequis

Avant de connecter un appareil, assurez-vous d’avoir :

1. Un projet créé sur IronFlock
2. Une entrée d’appareil créée dans ce projet (cliquez sur NOUVEL APPAREIL dans le panneau Paramètres -> Appareils du projet.)
3. Le fichier de configuration de l’appareil (.flock) téléchargé

Tester d’abord : Simuler un appareil sur votre ordinateur portable

Vous n’avez pas besoin de matériel physique pour explorer IronFlock. L’application FlockFlasher peut exécuter l’agent IronFlock directement sur votre ordinateur portable, qui se fait alors passer pour un appareil réel au sein de votre projet — idéal pour tester des applications et des tableaux de bord avant de déployer sur du matériel réel.

1. Installez Docker Desktop (ou Docker Engine sous Linux) et assurez-vous qu’il est en cours d’exécution.
2. Téléchargez et installez l’application FlockFlasher pour votre OS.
3. Double-cliquez sur le fichier .flock téléchargé de votre appareil — il s’ouvre dans FlockFlasher et l’appareil apparaît dans la liste. (Vous pouvez aussi ouvrir FlockFlasher et ajouter le fichier via le bouton +.)
4. Cliquez sur Test Device (▶, « Tester l’appareil ») sur l’entrée de l’appareil. FlockFlasher télécharge automatiquement l’agent IronFlock à la première utilisation et le démarre avec la configuration de votre appareil.

Votre ordinateur portable agit désormais comme cet appareil au sein de votre projet IronFlock : il apparaît en ligne, et vous pouvez y installer et y exécuter des applications exactement comme sur un appareil réel. Les applications s’exécutent sous forme de conteneurs Docker sur votre ordinateur portable.

Une fois terminé, arrêtez le test dans FlockFlasher. Vous pourrez ensuite utiliser le même fichier .flock pour provisionner l’appareil réel — assurez-vous simplement qu’une seule machine à la fois exécute une configuration d’appareil donnée.

Méthode 1 : Flasher une carte SD

Idéal pour les Raspberry Pi et autres appareils ARM qui démarrent depuis des cartes SD.

1. Téléchargez l’application FlockFlasher pour votre OS.
2. Insérez une carte SD (16 Go minimum) dans votre ordinateur.
3. Ouvrez FlockFlasher et cliquez sur le bouton + pour charger le fichier .flock.
4. Sélectionnez le lecteur de carte SD (FlockFlasher détecte automatiquement les lecteurs externes).
5. Choisissez l’image correcte pour votre appareil (Raspberry Pi 3/4, Zero, etc.).
6. Configurez optionnellement le WiFi pour que l’appareil puisse se connecter à destination.
7. Cliquez sur Flash et attendez la fin de l’écriture, de la validation et de la configuration.
8. Insérez la carte SD dans l’appareil et mettez-le sous tension.

L’appareil devrait passer en ligne dans les 20 minutes.

Avertissement : Le processus de flash efface toutes les données sur le lecteur sélectionné. FlockFlasher masque les lecteurs internes par défaut, mais vérifiez toujours votre sélection.

Méthode 2 : Installateur USB pour PC industriels

Pour les appareils AMD64 avec démarrage EFI (ex. Siemens SIMATIC Box IPC).

1. Insérez une clé USB (16 Go minimum) et ouvrez FlockFlasher.
2. Chargez le fichier .flock et sélectionnez la clé USB.
3. Sélectionnez l’image PC industriel x86_64 (EFI).
4. Cliquez sur Flash et attendez la fin.
5. Si nécessaire, modifiez l’ordre de démarrage dans le BIOS de l’appareil pour démarrer depuis la clé USB.
6. Insérez la clé USB et mettez l’appareil sous tension.

L’appareil devrait passer en ligne dans les 60 minutes.

Méthode 3 : Installation personnalisée

Pour les appareils conservant leur OS Linux existant. Idéal pour NVIDIA Jetson et le matériel personnalisé.

Note : Cette méthode d’installation manuelle est destinée au matériel de production réel comme les PC industriels, les passerelles et les appareils embarqués — pas aux ordinateurs portables. Si vous souhaitez simplement essayer IronFlock sur votre ordinateur portable, suivez plutôt Tester d’abord : Simuler un appareil sur votre ordinateur portable — aucune installation manuelle de l’agent n’est requise.

Appareils Linux / Unix

1. Connectez-vous en SSH à l’appareil.
2. Téléchargez le binaire de configuration :

   curl -sSL https://instance-registry.ironflock.com/dl/reswarmify/install.sh | bash

3. Copiez le fichier .flock de votre ordinateur vers l’appareil :

   scp mydevice.flock user@device-ip:/home/user/

4. Exécutez l’agent :

   sudo ./ironflock-init -c mydevice.flock

Derrière un proxy d’entreprise ? Exportez votre proxy avant l’étape 2 pour que les téléchargements aboutissent, et passez --http-proxy / --https-proxy à ironflock-init à l’étape 4 pour qu’il configure le moteur Docker à votre place. Voir Derrière un proxy d’entreprise pour la commande complète et les étapes relatives au certificat CA d’entreprise.

Appareils Windows

1. Installez Docker Desktop sur l’appareil et activez Start Docker Desktop when you sign in dans les paramètres de Docker Desktop. Pour les appareils sans surveillance, configurez également la connexion automatique de Windows afin que Docker soit disponible après un redémarrage sans qu’aucun utilisateur ne se connecte.
2. Téléchargez reagent.exe.
3. Copiez le fichier .flock sur l’appareil.
4. Installez et démarrez l’agent en tant que service Windows depuis une invite de commandes élevée (Administrateur) :

   reagent.exe service install -config path\to\config.flock

   Le service démarre immédiatement, puis à chaque démarrage du système, redémarre automatiquement en cas d’échec et maintient l’agent à jour. Ajoutez -noStart pour l’installer sans le démarrer, et vérifiez son état à tout moment avec reagent.exe service status.

Derrière un proxy d’entreprise ? Ajoutez -proxy http://proxy.example.com:3128 à la commande service install et configurez le proxy de Docker Desktop sous Settings → Resources → Proxies. Consultez Derrière un proxy d’entreprise pour les détails et les étapes relatives à l’autorité de certification d’entreprise.

Vérification de la connexion

Après la connexion, vérifiez le statut de l’appareil dans votre projet :

• Indicateur vert — L’appareil est en ligne et communique avec IronFlock.
• Indicateur rouge — L’appareil est hors ligne. Vérifiez la connexion réseau et assurez-vous que l’agent est en cours d’exécution.

La vue carte des appareils montre l’emplacement géographique de tous les appareils du projet.