Zaznamenejte svou terminálovou relaci pomocí Asciinema

Telefonáty na podporu jsou důležité a často nakonec uspokojivé, ale akt jasné komunikace může být náročný pro všechny zúčastněné. Pokud jste někdy volali na podporu, pravděpodobně jste strávili několik minut vysvětlováním i těch nejkratších příkazů a podrobným vysvětlováním, kde padají mezery a návraty. I když je často snazší převzít kontrolu nad počítačem uživatele, ve skutečnosti to není nejlepší způsob vzdělávání. Místo toho můžete zkusit poslat uživateli záznam obrazovky, ale takový, ze kterého může zkopírovat příkazy a vložit je do svého vlastního terminálu.

Asciinema je open source terminálový záznamník relací. Podobné jako script a scriptreplay příkazy, Asciinema zaznamenává přesně to, co váš terminál zobrazuje. Váš „filmový“ záznam uloží do textového souboru a poté jej na požádání přehraje. Svůj film můžete nahrát na Asciinema.org a sdílet je stejně jako jakékoli jiné video na internetu a dokonce můžete svůj film vložit na webovou stránku.

Nainstalujte Asciinema

V Linuxu můžete Asciinemu nainstalovat pomocí správce balíčků.

Na Fedoře, CentOS, Mageia nebo podobných:

$ sudo dnf install asciinema

V systému Debian, Linux Mint nebo podobných:

$ sudo apt install asciinema

V systému macOS můžete nainstalovat pomocí Homebrew:

$ sudo brew install asciinema

Na BSD a jakékoli jiné platformě používající Pkgsrc:

$ cd /usr/pkgsrc/misc/py-asciinema



$ sudo bmake install clean

Vytváření filmů z textu

Chcete-li zahájit nahrávání pomocí Asciinema, použijte rec dílčí příkaz:

$ asciinema rec mymovie.cast



asciinema: recording asciicast to mymovie.cast



asciinema: press <ctrl-d> or type "exit" when you're done

Nějaký přátelský výstup vás upozorní, že nahráváte, a řekne vám, jak přestat:Stiskněte Ctrl+D nebo stačí napsat exit .

Všechno, co děláte ve svém terminálu, když je Asciinema aktivní, se zaznamenává. To zahrnuje vstup, výstup, chyby, nepříjemné pauzy, chyby nebo úspěchy. Pokud to během nahrávání uvidíte v terminálu, provede se střih.

Až skončíte s předváděním, jak terminál funguje, stiskněte Ctrl+D nebo zadejte exit pro zastavení nahrávání.

V tomto příkladu je výsledný soubor mymovie.cast je sbírka časových razítek a akcí, které slouží jako scénář (ve smyslu filmového scénáře) pro mechanismus přehrává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"]



[...]

Pokud jste udělali chybu, můžete chybu odstranit odstraněním řádků, které chybu znovu vytvoří. Pokud zjistíte, že během nahrávání provádíte mnoho úprav nebo se trápíte dlouhými pauzami, můžete si nainstalovat a používat utilitu asciinema-edit, která dokáže oříznout bloky „záznamu“ podle časových razítek vaší definice nebo tím, že eliminuje dobu nečinnosti.

Přehrávání filmu Asciinema

Asciinemu můžete přehrát pomocí play dílčí příkaz:

$ asciinema play mymovie.cast

To převezme vaši terminálovou relaci a udělá z ní nejbližší ekvivalent stříbrné obrazovky, jak pravděpodobně kdy bude (kromě té doby, kdy jste sledovali Star Wars v ASCII přes telnet ). Přehrávání vašeho textového filmu – ukazuje vašim uživatelům, jak přesně se provádí složitý úkol. Samozřejmě, skutečný přehrávané příkazy se ve skutečnosti neprovádějí. Toto není shell skript v akci, takže i když jste možná vytvořili soubor hello.txt ve vašem filmu nebude nový hello.txt po přehrání. To je jen pro ukázku.

A přitom je to víc než pouhá show. Můžete pozastavit filmy Asciinema, vybrat text, který vidíte na obrazovce, a vložit jej do aktivního terminálu pro spuštění příkazu. Asciinema je užitečná dokumentace. Ukazuje uživatelům, jak provést úkol, a umožňuje jim kopírovat a vkládat, aby byla zajištěna přesnost.

Nahrajte svůj film Asciinema 

Žádný film Asciinema ještě nedosáhl statusu trháku, ale můžete ten svůj nahrát na Asciinema.org a sdílet ho se světem.

$ asciinema upload mymovie.cast

Další zdroje pro Linux

• Cheat pro příkazy Linuxu
• Cheat sheet pro pokročilé příkazy systému Linux
• Bezplatný online kurz:Technický přehled RHEL
• Síťový cheat pro Linux
• Cheat sheet SELinux
• Cheat pro běžné příkazy pro Linux
• Co jsou kontejnery systému Linux?
• Naše nejnovější články o Linuxu

Pokud jste zvyklí na časy nahrávání na YouTube, budete příjemně překvapeni, jak rychle se filmy Asciinema přenášejí. .cast soubor má obvykle jen několik kilobajtů nebo maximálně několik megabajtů, takže nahrání je téměř okamžité. Ke sdílení filmu nepotřebujete účet, ale všechny nenárokované filmy budou po sedmi dnech smazány. Chcete-li zachovat své mistrovské dílo, můžete si otevřít účet na Asciinemě a pak se pohodlně usadit a čekat, až se ozve Akademie.

Asciinema jako dokumentace

Asciinema je skvělý způsob, jak demonstrovat i ty nejzákladnější koncepty. Protože si zachovává možnost kopírovat a vkládat kód ze záznamu, poskytuje možnost pozastavení a přehrávání na vyžádání a je zcela přesný v tom, co zobrazuje, není jen tak dobrý jako záznam obrazovky. Je to mnohem, mnohem lepší. Asciinema je neocenitelný, sociální a přístupný nástroj, ať už jej používáte k předvádění svých terminálových dovedností svým přátelům, nebo jej používáte ke vzdělávání kolegů a studentů.