Différences

Ci-dessous, les différences entre deux révisions de la page.

--- enregistrement_de_sessions_ssh_avec_asciinema [2023/04/15 13:32] – créée superadmin
+++ enregistrement_de_sessions_ssh_avec_asciinema [2023/04/15 14:13] (Version actuelle) – [Sources] superadmin
@@ Ligne 1: / Ligne 1: @@
-====== Enregistrement de sessions SSH avec asciinema ======
+====== Enregistrement de sessions CLI avec Asciinema ======
+===== Introduction =====
+Asciinema est un programme qui permet d'enregistrer des sessions CLI.
+Il s'installe sous Linux par le biais des gestionnaires de paquets traditionnels, et peut être utilisé pour enregistrer des commandes tapées dans des sessions SSH.
+===== Utilisation =====
+==== Enregistrer une session ====
+**Lancer l'enregistrement :**
+<code>asciinema rec</code>
+On peut aussi préciser le chemin du fichier dans lequel seront enregistrées les commandes :
+<code>asciinema rec /home/test/enregistrement.cast</code>
+**Arrêter l'enregistrement :**
+Faire ''CTRL-D'' ou :
+<code>exit</code>
+:!: Si asciinema est utilisé pour enregistrer des sessions à distance via SSH ou dans un mode superutilisateur, il faut d'abord utiliser la commande ''exit'' pour sortir de ces modes / se déconnecter, avant de pouvoir arrêter l'enregistrement.
+==== Rejouer une session ====
+:!: Lors du rejeu d'une session enregistrée par Asciinema, les commandes sont simplement affichées dans la console à la vitesse où elles ont été exécutées lors de l'enregistrement, elles ne sont en aucun cas ré-exécutées.
+**Rejouer un enregistrement stocké en local :**
+<code>asciinema play /home/test/enregistrement.cast</code>
+**Rejouer un enregistrement en ligne :**
+<code>asciinema play https://asciinema.org/a/22124.cast</code>
+L'argument ''-i'' permet de limiter les temps d'inactivité en précisant une durée (en secondes). Ici on souhaite les limiter à 10 sec maximum :
+<code>asciinema play /home/test/enregistrement.cast -i 10</code>
+On peut aussi régler la vitesse de lecture de l'enregistrement en ajoutant l'argument ''-s'' suivi d'une valeur. Par exemple, pour lire un enregistrement 2x plus vite qu'il n'a été enregistré :
+<code>asciinema play /home/test/enregistrement.cast -s 2</code>
+Les options précédentes sont bien évidemment cumulables.
+**Mettre sur pause le rejeu d'un enregistrement :**
+Utiliser le raccourci clavier ''Espace'' pour mettre sur pause ou continuer la lecture.
+**Interrompre le rejeu d'un enregistrement :**
+Utiliser le raccourci clavier ''CTRL+C''
+**Lister les commandes dans un enregistrement :**
+Asciinema peut aussi simplement afficher l'historique des commandes utilisées dans un enregistrement avec la commande suivante :
+<code>asciinema cat /home/test/enregistrement</code>
+==== Partager un enregistrement en ligne ====
+Un enregistrement peut être envoyé sur les serveur d'asciinema.org pour une durée limitée afin de le partager avec d'autres personnes :
+<code>asciinema upload demo.cast</code>
+===== Sources =====
+[[https://asciinema.org/docs/usage|Documentation officielle d'Asciinema]]