La bibliothèque de scripts est l'endroit où tu conserves les scripts que tu exécutes sur tes appareils. Charge un script .sh, .py ou .ps1 une fois, puis exécute-le sur n'importe quel appareil compatible.
Vue d'ensemble
Types de scripts pris en charge :
| Extension | Plateformes | Remarques |
|---|---|---|
.sh |
macOS, Linux | Doit s'exécuter sous /bin/sh, /bin/bash ou /bin/zsh. |
.py |
macOS, Linux | Doit commencer par un shebang incluant python (par exemple, #!/usr/bin/env python3). |
.ps1 |
Windows | S'exécute dans PowerShell. |
Chaque script est limité à 1 Mio.
Étapes
Ouvrir la bibliothèque de scripts
- Dans la console Factorial IT, ouvre Gestion des appareils.
- Sélectionne l'onglet Scripts.
- Sélectionne le sous-onglet Bibliothèque de scripts. Chaque ligne affiche le nom, le type et les actions d'un script.
Ajouter un script
- Clique sur Ajouter un script.
- Fournis le script de l'une de ces deux manières :
-
Glisse-dépose un fichier
.sh,.pyou.ps1dans la zone de chargement. Le nom, la plateforme et le contenu sont renseignés pour toi. - Renseigne les champs manuellement : choisis une plateforme, saisis un nom se terminant par la bonne extension et colle le script dans l'éditeur.
-
Glisse-dépose un fichier
- Clique sur Enregistrer.
Le sélecteur Plateforme contrôle l'extension. Changer la plateforme réécrit l'extension dans le nom. Saisir un nom se terminant par une extension correspondante change la plateforme. Tu peux modifier librement les deux champs ; ils ne restent liés que lorsque l'un permet de déduire l'autre sans ambiguïté.
Modifier un script
- Dans la ligne du script, ouvre le menu d'actions et sélectionne Modifier.
- Modifie le script dans l'éditeur.
- Clique sur Enregistrer. Le bouton reste désactivé tant que tu n'as rien modifié.
Seul le contenu peut être modifié. Le nom et la plateforme sont verrouillés, car renommer changerait le type de script. Pour renommer un script ou changer son type, supprime-le et crée-en un nouveau.
Télécharger un script
Dans la ligne du script, ouvre le menu d'actions et sélectionne Télécharger. Le fichier conserve son nom et son extension d'origine.
Supprimer un script
- Dans la ligne du script, ouvre le menu d'actions et sélectionne Supprimer.
- Confirme dans la boîte de dialogue.
Les exécutions antérieures restent dans l'historique des scripts de chaque appareil, car Factorial IT conserve le nom et le contenu utilisés à l'époque. Les exécutions qui n'étaient pas encore terminées sont marquées annulées.
Règles de validation
Avant d'enregistrer, Factorial IT vérifie que :
- Le nom se termine par
.sh,.pyou.ps1. - Le contenu ne dépasse pas 1 Mio.
- Un script
.pycommence par un shebangpython, par exemple :#!/usr/bin/env python3 print("Hello from Factorial IT") - Un script
.shqui déclare un shebang utilise un interpréteur pris en charge, comme#!/bin/bashou#!/usr/bin/env bash.
Si une vérification échoue, Enregistrer reste désactivé et le champ concerné en explique la raison.
Autorisations
| Action | Autorisation requise |
|---|---|
| Consulter la bibliothèque, télécharger un script | MDM_READ |
| Ajouter, modifier ou supprimer un script | MDM_WRITE |
Sans la bonne autorisation, l'action reste affichée mais désactivée, et une info-bulle t'en explique la raison.
Conseils et bonnes pratiques
- Utilise le glisser-déposer. Il renseigne le nom, la plateforme et le contenu à ta place et évite les erreurs d'extension.
-
Ajoute toujours un shebang aux scripts Python. Sans
#!/usr/bin/env python3ou équivalent, le script ne peut pas être enregistré. - Télécharge le script avant de le supprimer. La suppression est irréversible, et tu pourrais avoir besoin du fichier plus tard.
- Supprime et recrée le script pour changer de type. Le nom et la plateforme sont verrouillés une fois le script enregistré.
Résolution des problèmes et FAQ
Résolution des problèmes
-
Enregistrer est désactivé lors de l'ajout d'un script. Une règle de validation a échoué. Lis le message sous le champ : il s'agit généralement d'une mauvaise extension, d'un shebang
pythonmanquant, d'un shell non pris en charge ou d'un fichier de plus de 1 Mio. - Enregistrer est désactivé lors de la modification d'un script. Tu n'as pas encore modifié le contenu.
- Je ne peux pas renommer un script. Le nom et la plateforme sont verrouillés. Supprime le script et ajoute-le à nouveau avec le nouveau nom.
-
Une action est grisée. Il te manque
MDM_READouMDM_WRITE. Survole l'action pour voir laquelle.
FAQ
-
Quelles plateformes peuvent exécuter les scripts de la bibliothèque ?
macOS et Linux avec.shet.py, et Windows avec.ps1.
-
Que deviennent les exécutions passées lorsque je supprime un script ?
Elles restent dans l'historique des scripts de chaque appareil, avec le nom et le contenu utilisés à l'époque. Les exécutions qui n'étaient pas terminées sont annulées.
-
Quelle taille peut avoir un script ?
Jusqu'à 1 Mio.
-
Puis-je changer la plateforme d'un script après l'avoir enregistré ?
Non. Supprime-le et crée-en un nouveau.