La biblioteca de scripts es donde guardas los scripts que ejecutas en tus dispositivos. Sube un .sh, .py o .ps1 una vez y ejecútalo en cualquier dispositivo compatible.

Descripción general

Tipos de scripts soportados:

Cada script tiene un límite de 1 MiB.

Cómo usar

Abre la biblioteca de scripts

1. En la consola de IT de Factorial, abre Gestión de dispositivos.
2. Selecciona la pestaña Scripts.
3. Selecciona la subpestaña Biblioteca de scripts. Cada fila muestra el nombre, tipo y acciones de un script.

Agregar un script

1. Haz clic en Agregar un script.
2. Proporciona el script de una de dos maneras:
   • Arrastra y suelta un archivo .sh, .py o .ps1 en el área de carga. El nombre, la plataforma y el contenido se completan automáticamente.
   • Completa los campos a mano: elige una plataforma, escribe un nombre que termine con la extensión correcta y pega el script en el editor.
3. 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

1. En la fila del script, abre el menú de acciones y selecciona Editar.
2. Cambia el script en el editor.
3. 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

1. En la fila del script, abre el menú de acciones y selecciona Eliminar.
2. 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 están marcadas como canceladas.

Reglas de validación

Antes de guardar, Factorial IT verifica que:

• El nombre termine en .sh, .py o .ps1.
• Los contenidos sean de 1 MiB o menos.
• Un script .py comience con un shebang python, por ejemplo:

  #!/usr/bin/env python3
  print("Hola desde Factorial IT")

• Un script .sh que declare un shebang use un intérprete soportado, como #!/bin/bash o #!/usr/bin/env bash.

Si falla una verificación, Guardar permanece deshabilitado y el campo en cuestión explica por qué.

Permisos

Sin el permiso adecuado, la acción aún se muestra pero está deshabilitada, y un tooltip te dice por qué.

Resolución de problemas y FAQ

Resolución de problemas

Guardar está deshabilitado al agregar un script. Una regla de validación falló. Lee el mensaje debajo del campo: generalmente una extensión incorrecta, un shebang python faltante, una shell no soportada, o un archivo mayor a 1 MiB.

Guardar está deshabilitado al editar un script. Aún no has cambiado los contenidos.

No puedo renombrar un script. El nombre y la plataforma están bloqueados. Elimina el script y agrégalo de nuevo 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

1. ¿Qué plataformas pueden ejecutar scripts de la biblioteca?
   macOS y Linux con .sh y .py, y Windows con .ps1.
    
2. ¿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 son canceladas.
    
3. ¿Qué tan grande puede ser un script?
   Hasta 1 MiB.
    
4. ¿Puedo cambiar la plataforma de un script después de guardarlo?
   No. Elimínalo y crea uno nuevo.