Las llamadas de soporte son importantes y, a menudo, satisfactorias al final, pero el acto de una comunicación clara puede ser arduo para todos los involucrados. Si alguna vez ha estado en una llamada de soporte, probablemente haya pasado varios minutos deletreando incluso los comandos más breves y explicando en detalle dónde caen los espacios y los retornos. Si bien a menudo es más fácil simplemente tomar el control de la computadora de un usuario, esa no es realmente la mejor manera de educar. Lo que podría intentar en su lugar es enviar a un usuario una grabación de pantalla, pero una de la que pueda copiar comandos y pegarlos en su propia terminal.
Asciinema es un grabador de sesión de terminal de código abierto. Similar al script
y scriptreplay
comandos, Asciinema registra exactamente lo que muestra su terminal. Guarda la grabación de su "película" en un archivo de texto y luego la reproduce a pedido. Puede cargar su película en Asciinema.org y compartirla como lo haría con cualquier otro video en Internet, e incluso puede incrustar su película en una página web.
Instalar Ascinema
En Linux, puede instalar Asciinema usando su administrador de paquetes.
En Fedora, CentOS, Mageia o similar:
$ sudo dnf install asciinema
En Debian, Linux Mint o similar:
$ sudo apt install asciinema
En macOS, puede instalar usando Homebrew:
$ sudo brew install asciinema
En BSD y cualquier otra plataforma que use Pkgsrc:
$ cd /usr/pkgsrc/misc/py-asciinema
$ sudo bmake install clean
Hacer películas a partir de texto
Para comenzar a grabar con Asciinema, usa el rec
subcomando:
$ asciinema rec mymovie.cast
asciinema: recording asciicast to mymovie.cast
asciinema: press <ctrl-d> or type "exit" when you're done
Algunas salidas amigables te avisan que estás grabando y te dicen cómo parar:Presiona Ctrl+D o simplemente escriba exit
.
Todo lo que haces en tu terminal mientras Asciinema está activo queda registrado. Esto incluye entrada, salida, errores, pausas incómodas, errores o éxitos. Si lo ve en su terminal durante la grabación, hace el corte.
Cuando haya terminado de demostrar cómo funciona la terminal, presione Ctrl+D o escribe exit
para detener la grabación.
En este ejemplo, el archivo resultante, mymovie.cast
es una colección de marcas de tiempo y acciones que sirven como guión (en el sentido de un guión de película) para el mecanismo de reproducción.
{"version": 2, "width": 139, "height": 36, "timestamp": 1641457358, "env": {"SHELL": "/bin/bash", "TERM": "xterm-256color"}}
[0.05351, "o", "\u001b]0;seth:~\u0007"]
[0.05393, "o", "\u001b[1;31m$ \u001b[00m"]
[1.380059, "o", "e"]
[1.443823, "o", "c"]
[1.514674, "o", "h"]
[1.595238, "o", "o"]
[1.789562, "o", " "]
[2.09658, "o", "\""]
[2.19683, "o", "h"]
[2.403994, "o", "e"]
[2.466784, "o", "l"]
[2.711183, "o", "lo"]
[3.120852, "o", "\""]
[3.427886, "o", "\r\nhello\r\n"]
[...]
Si ha cometido un error, puede eliminar el error eliminando las líneas que recrean el error. Si te encuentras haciendo muchas ediciones o haciendo largas pausas durante la grabación, puedes instalar y usar la utilidad de edición de asciinema, que puede recortar bloques de "metraje" por marcas de tiempo de tu definición, o eliminando el tiempo de inactividad.
Reproducción de una película de Asciinema
Puedes reproducir tu Asciinema usando el play
subcomando:
$ asciinema play mymovie.cast
Esto se hace cargo de la sesión de su terminal y la convierte en el equivalente más cercano a la pantalla plateada que probablemente sea (aparte de la vez que vio Star Wars en ASCII a través de telnet
). ). Se reproduce su película basada en texto, demostrando a sus usuarios exactamente cómo se realiza una tarea compleja. Por supuesto, el real los comandos que se reproducen en realidad no se ejecutan. Este no es un script de shell en acción, por lo que aunque haya creado un archivo hello.txt
en su película, no habrá un nuevo hello.txt
después de la reproducción. Esto es solo para mostrar.
Y, sin embargo, es más que un espectáculo. Puede pausar las películas de Asciinema, seleccionar el texto que ve en la pantalla y pegarlo en una terminal activa para ejecutar el comando. Asciinema es una documentación útil. Muestra a los usuarios cómo realizar una tarea y les permite copiar y pegar para garantizar la precisión.
Sube tu película Asciinema
Ninguna película de Asciinema ha alcanzado aún el estatus de éxito de taquilla, pero puedes subir la tuya a Asciinema.org y compartirla con el mundo de todos modos.
$ asciinema upload mymovie.cast
Más recursos de Linux
- Hoja de trucos de los comandos de Linux
- Hoja de trucos de comandos avanzados de Linux
- Curso en línea gratuito:Descripción general técnica de RHEL
- Hoja de trucos de red de Linux
- Hoja de trucos de SELinux
- Hoja de trucos de los comandos comunes de Linux
- ¿Qué son los contenedores de Linux?
- Nuestros últimos artículos sobre Linux
Si está acostumbrado a los tiempos de carga de YouTube, se sorprenderá gratamente de la rapidez con la que se transfieren las películas de Asciinema. Un .cast
El archivo suele tener solo unos pocos kilobytes, o como máximo unos pocos megabytes, por lo que la carga es casi instantánea. No necesita una cuenta para compartir su película, pero todas las películas no reclamadas se eliminan después de siete días. Para conservar su obra maestra, puede abrir una cuenta en Asciinema y luego sentarse y esperar a que llame la Academia.
Ascinema como documentación
Asciinema es una excelente manera de demostrar incluso los conceptos más básicos. Debido a que conserva la capacidad de copiar y pegar el código de la grabación, brinda la capacidad de pausar y reproducir a pedido, y es completamente preciso en lo que representa, no es tan bueno como una grabación de pantalla. Es mucho, mucho mejor. Ya sea que lo use para mostrar sus habilidades con la terminal a sus amigos o para educar a colegas y estudiantes, Asciinema es una herramienta invaluable, social y accesible.