La biblioteca de Scripts es donde mantienes los scripts que ejecutas en tus dispositivos. Sube un .sh, .py o .ps1 una vez y ejecútalo en cualquier dispositivo compatible.
Resumen
Tipos de script soportados:
| Extensión | Plataformas | Notas |
|---|---|---|
.sh |
macOS, Linux | Debe ejecutarse bajo /bin/sh, /bin/bash o /bin/zsh. |
.py |
macOS, Linux | Debe comenzar con un shebang que incluya python (por ejemplo, #!/usr/bin/env python3). |
.ps1 |
Windows | Se ejecuta en PowerShell. |
Cada script tiene un límite de 1 MiB.
Cómo usar
Abre la biblioteca de Scripts
- En la consola de IT de Factorial, abre Gestión de Dispositivos.
- Selecciona la pestaña de Scripts.
- Selecciona la subpestaña de Biblioteca de Scripts. Cada fila muestra el nombre, tipo y acciones de un script.
Agregar un script
- Haz clic en Agregar un script.
- Proporciona el script de una de dos maneras:
-
Arrastra y suelta un archivo
.sh,.pyo.ps1en el área de carga. El nombre, plataforma y contenido se completan automáticamente. - Completa los campos manualmente: elige una plataforma, escribe un nombre que termine con la extensión correcta y pega el script en el editor.
-
Arrastra y suelta un archivo
- Haz clic en Guardar.
El selector de Plataforma controla la extensión. Cambiar la plataforma reescribe la extensión en el nombre. Escribir un nombre que termine en una extensión coincidente cambia la plataforma. Ambos campos se pueden editar libremente; solo permanecen vinculados cuando el otro no deja dudas.
Editar un script
- En la fila del script, abre el menú de acciones y selecciona Editar.
- Cambia el script en el editor.
- Haz clic en Guardar. El botón permanece deshabilitado hasta que cambies algo.
Solo se pueden editar los contenidos. El nombre y la plataforma están bloqueados, porque renombrar cambiaría el tipo de script. Para renombrar un script o cambiar su tipo, elimínalo y crea uno nuevo.
Descargar un script
En la fila del script, abre el menú de acciones y selecciona Descargar. El archivo mantiene su nombre y extensión originales.
Eliminar un script
- En la fila del script, abre el menú de acciones y selecciona Eliminar.
- Confirma en el diálogo.
Las ejecuciones anteriores permanecen en el historial de scripts de cada dispositivo, porque Factorial IT mantiene el nombre y los contenidos utilizados en ese momento. Las ejecuciones que no habían terminado aún se marcan como canceladas.
Reglas de validación
Antes de guardar, Factorial IT verifica que:
- El nombre termine en
.sh,.pyo.ps1. - Los contenidos sean de 1 MiB o menos.
- Un script
.pycomience con un shebang depython, por ejemplo:#!/usr/bin/env python3 print("Hola desde Factorial IT") - Un script
.shque declare un shebang use un intérprete soportado, como#!/bin/basho#!/usr/bin/env bash.
Si una verificación falla, Guardar permanece deshabilitado y el campo en cuestión explica por qué.
Permisos
| Acción | Permiso requerido |
|---|---|
| Ver la biblioteca, descargar un script | MDM_READ |
| Agregar, editar o eliminar un script | MDM_WRITE |
Sin el permiso adecuado, la acción se muestra pero está deshabilitada, y un tooltip te dice por qué.
Consejos y Mejores Prácticas
- Arrastra y suelta el archivo. Completa el nombre, la plataforma y los contenidos por ti y evita errores de extensión.
-
Siempre agrega un shebang a los scripts de Python. Sin
#!/usr/bin/env python3o similar, el script no se puede guardar. - Descarga antes de eliminar. La eliminación no se puede deshacer, y puede que necesites el archivo más tarde.
- Elimina y recrea para cambiar de tipo. El nombre y la plataforma están bloqueados una vez que se guarda un script.
Solución de Problemas y FAQ
Solución de Problemas
Guardar está deshabilitado al agregar un script. Una regla de validación falló. Lee el mensaje debajo del campo: generalmente es una extensión incorrecta, un shebang de python faltante, una shell no soportada o un archivo de más de 1 MiB.
Guardar está deshabilitado al editar un script. No has cambiado los contenidos aún.
No puedo renombrar un script. El nombre y la plataforma están bloqueados. Elimina el script y agrégalo nuevamente con el nuevo nombre.
Una acción está deshabilitada. Te falta MDM_READ o MDM_WRITE. Pasa el cursor sobre ella para ver cuál.
FAQ
-
¿Qué plataformas pueden ejecutar scripts de la biblioteca?
macOS y Linux con.shy.py, y Windows con.ps1.
-
¿Qué pasa con las ejecuciones pasadas cuando elimino un script?
Permanecen en el historial de scripts de cada dispositivo con el nombre y los contenidos utilizados en ese momento. Las ejecuciones que no habían terminado se cancelan.
-
¿Qué tan grande puede ser un script?
Hasta 1 MiB.
-
¿Puedo cambiar la plataforma de un script después de guardarlo?
No. Elimínalo y crea uno nuevo.