Le cockpit, expliqué

Un cockpit, c'est la cabine du pilote dans un avion : un seul endroit, avec tous les boutons à portée de main. Ici c'est pareil, mais pour ton ordinateur. Cette page explique chaque morceau, sans rien sauter.

C'est quoi le cockpit

Le cockpit est une page web. Une page web, c'est ce qui s'affiche dans ton navigateur — le programme avec lequel tu vas sur internet.

Sauf que celle-ci ne vient pas d'internet. Elle vient de ta propre machine. Son adresse est http://127.0.0.1:8790. Voici ce que veut dire cette adresse, morceau par morceau :

• 127.0.0.1 — ça veut dire « cet ordinateur-ci ». C'est un numéro spécial que toutes les machines du monde comprennent comme « moi-même ».
• 8790 — c'est le numéro de la porte. Un ordinateur a des milliers de portes numérotées. Chaque programme qui écoute en prend une pour lui. Le cockpit a pris la porte 8790.

Donc personne d'autre sur la terre ne peut ouvrir cette page. Elle n'existe que pour toi, sur ta machine.

Ce qu'on voit à l'écran

L'écran est coupé en deux dans le sens de la hauteur.

• À gauche, la barre. C'est le sommaire. Chaque ligne est un endroit où on peut aller. La ligne où on se trouve est surlignée, avec un petit trait de couleur collé à son bord gauche.
• À droite, la grande zone. Elle montre l'endroit choisi dans la barre. Quand on clique sur une autre ligne à gauche, seule cette zone change. La page ne se recharge pas : c'est instantané.

Les lignes de la barre de gauche sont rangées en trois familles : À faire, Mes dossiers, et sous le petit titre Mes modules, tes propres pages.

À faire — les boutons

C'est le cœur du cockpit. Une chose à faire = un bouton.

Avant, quand un assistant voulait que tu fasses quelque chose, il écrivait « tape cette commande ». Il fallait la recopier sans se tromper d'une virgule. Maintenant l'assistant pose un bouton dans ton cockpit. Toi, tu regardes, et tu cliques — ou tu ne cliques pas. La clé reste dans ta poche.

Chaque bouton est une carte qui contient trois choses :

1. un titre en gras : ce que ça fait, en une ligne ;
2. un détail en petit gris : ce qui va vraiment se passer, et surtout comment on saura que ça a marché ;
3. le bouton lui-même, et à côté une petite phrase qui dit où ça en est.

Ce qui se passe quand tu cliques

1. La page prévient le cockpit : « lance celui-là ».
2. Le cockpit note tout de suite en cours, et te répond sans attendre — c'est pour ça que la page ne gèle jamais, même si le travail dure dix minutes.
3. Le travail part de son côté, en fond.
4. Quand il a fini, le cockpit regarde s'il a réussi ou raté, et l'écrit.
5. Tu rafraîchis la page (touche F5) et tu vois la nouvelle couleur.

Les quatre couleurs d'un bouton

Chaque carte a un cadre coloré. La couleur dit tout, d'un seul coup d'œil :

Le mot écrit dans le bouton change aussi : « Lancer » la première fois, « Relancer » si c'est déjà passé, « Réessayer » si ça a raté.

« Voir le journal » — comprendre un échec tout seul

Sous chaque bouton il y a un petit lien bleu : « Voir le journal ». Il ouvre un nouvel onglet qui montre tout ce que le script a écrit la dernière fois qu'il a tourné. Pas seulement la dernière ligne : tout, du début à la fin, plus les erreurs.

En haut de ce texte il y a le numéro de sortie du script. C'est le mot que tout programme dit en partant :

Les journaux sont gardés dans le dossier journaux, à côté des réglages. On garde les dix derniers passages de chaque bouton, puis les plus vieux s'effacent tout seuls. Rien ne grossit sans fin.

Mes dossiers

Cette partie montre une carte par sous-dossier d'un dossier que tu as choisi. Un clic sur une carte ouvre ce dossier sur ton bureau, dans la fenêtre habituelle où tu ranges tes fichiers.

Tu choisis quel dossier dans les réglages, avec le mot dossier_travaux. Si tu laisses ce mot vide, la partie « Mes dossiers » disparaît : ni la ligne dans la barre de gauche, ni la zone à droite.

Le cockpit ne montre que les vrais dossiers. Il met de côté les fichiers seuls (les modes d'emploi, les raccourcis) et tout ce qui commence par un point — un nom qui commence par un point veut dire « caché ».

Mes modules et la pastille

Un module, c'est une de tes autres pages. Elle a sa propre adresse et vit de son côté. Le cockpit sait l'afficher à l'intérieur de lui-même, dans un cadre. Tu ne quittes donc jamais le cockpit.

Ce cadre s'appelle une fenêtre dans la fenêtre. Le module se charge seulement la première fois que tu cliques sur sa ligne. Tant que tu n'y vas pas, il ne coûte rien : ni mémoire, ni électricité.

En haut à droite de chaque module il y a « Ouvrir en grand » : ça ouvre la page toute seule, dans un nouvel onglet, sans le cadre.

La pastille

À droite de chaque nom de module, dans la barre de gauche, il y a un petit rond. C'est la pastille. Elle répond à une seule question : cette page est-elle vivante ?

Le cockpit refait ce contrôle tout seul toutes les 30 secondes. Tu n'as rien à faire.

Quand un module est éteint : le bouton « Rallumer »

Ouvre le module. Si sa page ne répond pas, une phrase rouge s'écrit en haut, à côté de son titre. Elle dit trois choses :

Les raisons possibles, et ce qu'elles veulent dire :

À côté de la phrase rouge, un bouton vert « Rallumer » apparaît — seulement si le cockpit sait comment rallumer ce module-là. Un clic, et il lance la commande de démarrage, attend quatre secondes, puis re-teste. Il écrit ensuite « rallumé », ou bien « toujours éteint » avec la nouvelle raison.

config.json — les réglages

config.json est un fichier de texte. Le mot json est juste une façon d'écrire des réglages pour qu'un programme les lise sans se tromper : un nom, deux points, une valeur.

Tout se règle là. On ne touche jamais au code. C'est ce qui fait qu'on peut donner ce cockpit à quelqu'un d'autre : il change ce seul fichier, et le cockpit devient le sien.

Un module s'écrit comme ça :

{
  "id":  "labo",                          // son nom secret, sans espaces ni accents
  "nom": "Le labo — l'agent 3D",          // ce que TU lis dans la barre
  "url": "http://192.168.1.24:8020/"     // où la page habite
}

Le id ne s'affiche nulle part. Il sert au cockpit à s'y retrouver tout seul. Deux modules ne doivent jamais avoir le même id.

taches.json — la liste des boutons

Ce fichier contient les boutons de la partie « À faire ». Chaque bouton a quatre morceaux :

[
 {
  "id": "exemple",
  "titre": "Un exemple de bouton",
  "detail": "Montre ce que fait un bouton : ici, il affiche la date.",
  "script": "exemple.sh"
 }
]

etat.json — la mémoire

etat.json se souvient de ce qui s'est passé pour chaque bouton. C'est lui qui donne sa couleur à chaque carte.

Tu n'écris jamais dedans à la main : le cockpit s'en occupe seul, avant et après chaque travail.

Le dossier scripts — le vrai travail

Le dossier scripts contient le travail lui-même. Un fichier par bouton. Ces fichiers se terminent par .sh : c'est une suite d'ordres que la machine exécute dans l'ordre, du haut vers le bas.

Le cockpit décide qu'un travail a réussi avec une règle très simple :

• le fichier finit en disant 0 → c'est réussi, la carte devient verte ;
• il finit en disant autre chose que 0 → c'est raté, la carte devient rouge.

Ce nombre s'appelle le code de sortie. Zéro veut dire « tout va bien ». C'est la convention de toutes les machines depuis cinquante ans.

Ajouter un bouton

Un assistant — ou toi — ajoute un bouton avec un seul ordre à taper. Le voici, chaque morceau expliqué en dessous :

python3 ajouter-tache.py mon-bouton "Le titre" "Le détail" "la commande"

La preuve que ça a marché : l'écran répond

bouton ajouté : mon-bouton

Et si le bouton existait déjà, il répond déjà présent et n'efface rien. Rafraîchis la page du cockpit (touche F5) : la nouvelle carte est là, en bleu.

Les adresses que le cockpit comprend

Le cockpit ne connaît que quatre adresses. Toute autre reçoit un refus poli.

Démarrer et arrêter

Pour l'allumer, un seul ordre :

python3 cockpit.py

La preuve que ça a marché : l'écran écrit une ligne comme celle-ci

Mon cockpit sur http://127.0.0.1:8790

Tant que cette fenêtre reste ouverte, le cockpit vit. Si tu la fermes, il s'éteint, et la page ne répond plus.

Il n'a besoin de rien d'autre que Python : aucun programme à installer, aucune connexion à internet. C'est voulu — moins il dépend de choses, moins il peut tomber.

Les pièges déjà payés

Chacun de ces pièges a coûté du temps une vraie fois. Ils sont réparés, mais il faut les connaître.

Le petit dictionnaire