Opérer
Ces guides vous montrent comment agir sur des appareils déjà déployés : mettre à jour leur micrologiciel, leur envoyer des actions, échanger des fichiers avec eux, et ouvrir un terminal ou un tunnel vers eux, le tout sans déplacement sur site.
Pour une vue d'ensemble du produit, consultez Opérer à distance.
Avant de commencer
-
Vos appareils sont provisionnés et connectés. Consultez Appareils.
-
Vous pouvez appeler la Public API, ou vous avez installé la CLI
funet vous êtes connecté :fun login -
Vous connaissez votre
<project-id>et votre<registry-id>, ainsi que les identifiants d'appareil ou les numéros de série des appareils sur lesquels vous souhaitez agir. -
Certaines fonctionnalités nécessitent un logiciel sur l'appareil. Les composants Edge implémentent le côté appareil pour les appareils Linux et MCU.
Choisir le bon outil
| Vous souhaitez… | Utilisez | Guide |
|---|---|---|
| Installer un nouveau micrologiciel sur un appareil ou sur un parc entier | Commande de mise à jour du micrologiciel, unitaire ou par lot | Mises à jour du micrologiciel (OTA) |
| Envoyer vos propres instructions avec délais d'expiration, nouvelles tentatives et priorité | Actions, éventuellement avec des capabilities et des encodeurs | Actions et encodeurs personnalisés |
| Envoyer un fichier à un appareil, ou récupérer un fichier journal depuis celui-ci | Transferts de fichiers | Transferts de fichiers |
| Ouvrir un shell, ou atteindre un service exécuté sur l'appareil | Terminal distant, redirection de ports | Terminal distant et redirection de ports |
Comprendre l'articulation des éléments
- Les commandes sont les opérations intégrées à la plateforme, telles que
firmware-updateetreboot. Vous les envoyez à un appareil, ou à plusieurs appareils sous forme de lot suivi appareil par appareil. - Les actions sont vos propres opérations. Un type d'action définit les délais d'expiration, le nombre de nouvelles tentatives et la priorité. Chaque action est suivie par appareil, de
pendingàsuccess,failure,timeoutoucancel. - Les capabilities et les encodeurs permettent à une même action de fonctionner sur plusieurs types d'appareils et versions de micrologiciel. Votre encodeur, une fonction cloud, convertit l'action au format de chaque appareil.
- Les transferts de fichiers envoient des URL présignées à l'appareil, qui télécharge ou téléverse ensuite le fichier via HTTPS. Chaque fichier apparaît comme une action sur l'appareil.
- Le terminal distant et la redirection de ports passent par la connexion existante de l'appareil vers Fundamentum, de sorte que l'appareil n'a besoin d'aucun port entrant.
Tout cela apparaît en direct dans le Hub, sur la page de l'appareil ainsi que dans les vues des lots et des actions.
Une première session type
-
Vérifiez que l'appareil est en ligne, puis ouvrez-y un terminal depuis le Hub pour explorer. Consultez Terminal distant et redirection de ports.
-
Récupérez son fichier journal sur votre machine :
fun devices transfer device-to-cloud -p <project-id> -r <registry-id> -s <serial-number> \ --remote-path /var/log/myapp.log -n myapp.log -
Renvoyez un fichier de configuration corrigé :
fun devices transfer cloud-to-device -p <project-id> -r <registry-id> -s <serial-number> \ -f app.toml --remote-path /etc/myapp/app.toml -
Une fois le correctif intégré à un nouveau micrologiciel, déployez-le sur le parc sous forme de lot et suivez-le appareil par appareil. Consultez Mises à jour du micrologiciel (OTA).
Règles communes
- Chaque opération est limitée à un projet, et la plupart à un registre. Votre rôle sur le projet détermine ce que vous pouvez faire. Consultez Rôles et autorisations.
- Les commandes et les actions attendent leur appareil : un appareil hors ligne les reçoit lorsqu'il se reconnecte, dans les délais d'expiration que vous avez définis.
- Tout ce que fait le Hub passe par la Public API, vous pouvez donc l'automatiser avec
fun apiou de simples requêtes HTTP.