CardoLabs

Rajada › Mode d’emploi

Mode d’emploi de Rajada

Rajada lance des commandes sur plusieurs serveurs en SSH et montre la réponse de chacun. Ce mode d’emploi couvre toute l’app, de la première clé aux réglages de sécurité.

Les fonctions marquées PRO demandent Rajada Pro, un achat unique. Tout le reste est gratuit, jusqu’à 5 hôtes.

  1. Avant de commencer
  2. Ajouter vos clés SSH
  3. Ajouter et modifier des hôtes
  4. Groupes, étiquettes et filtre
  5. Lancer des commandes
  6. Extraits et variables
  7. Déploiement progressif
  8. Résultats, comparaison et historique
  9. Terminaux interactifs
  10. Envoyer et télécharger des fichiers
  11. Tunnels
  12. État des hôtes
  13. Sécurité et confidentialité
  14. Sauvegarder ou déplacer votre configuration
  15. Rajada Pro
  16. Raccourcis clavier

Avant de commencer

Ajouter vos clés SSH

  1. En bas de la barre latérale, sous Clés SSH, cliquez sur Ajouter une clé….
  2. Choisissez un fichier de clé privée, par exemple ~/.ssh/id_ed25519. Le sélecteur affiche les fichiers cachés.
  3. Ajoutez autant de clés que nécessaire. Le bouton étoile, Définir par défaut, choisit la clé utilisée par les hôtes qui n’en ont pas une à eux.

Une clé protégée par une phrase secrète la demande à sa première utilisation ; Rajada peut la mémoriser dans le Trousseau. Retirer une clé de la liste ne supprime jamais le fichier.

Ajouter et modifier des hôtes

  1. En haut de la barre latérale, tapez le nom ou l’adresse IP de l’hôte, l’utilisateur et le port (22 par défaut).
  2. Choisissez si besoin un groupe dans Ajouter à, puis appuyez sur Entrée ou cliquez sur +.

Sélectionnez un hôte pour voir ses réglages à droite : la Clé SSH qu’il utilise, son Groupe et ses commandes. Pour changer le nom d’hôte, l’utilisateur, le port ou les étiquettes, cliquez sur le crayon à côté de son nom, ou choisissez Modifier l’hôte… dans son menu contextuel (clic droit).

Hôtes de rebond

Pour atteindre un serveur à travers un bastion, remplissez le champ Hôte de rebond avec user@bastion ou user@bastion:port. Plusieurs hôtes de rebond, séparés par des virgules, sont traversés dans l’ordre (quatre au plus).

Importer un ssh config PRO

Fichier › Importer des hôtes depuis un ssh config… lit un fichier de configuration OpenSSH et liste ses hôtes ; cochez ceux à ajouter. Noms d’hôte, utilisateurs, ports et hôtes de rebond sont repris ; la clé d’un hôte est reliée si vous avez déjà ajouté ce fichier de clé dans Rajada : ajoutez donc vos clés d’abord. Si le fichier utilise Include, Rajada demande l’accès au dossier qui contient les fichiers inclus.

Groupes, étiquettes et filtre

Lancer des commandes

Chaque hôte a ses propres commandes, une par ligne, dans l’onglet Commandes. Elles s’exécutent dans le shell de connexion de l’hôte, comme tapées après la connexion. Pour les lancer :

Avec Lancer en parallèle coché (en bas de la barre latérale), tous les hôtes démarrent en même temps ; sinon l’un après l’autre. Chaque hôte a sa propre sortie et son propre résultat : une coche verte en cas de succès, une croix rouge avec le code de sortie en cas d’échec. Arrêter interrompt un lancement en cours.

Rajada après un lancement sur quatre serveurs web : trois coches vertes et une croix rouge dans la barre latérale, et la sortie de web-01.

Ne mettez jamais de mots de passe ni de secrets dans les commandes : elles sont stockées en clair. Si une commande a besoin d’un mot de passe, le serveur le demande et Rajada affiche la question.

Avant le départ

Rajada demande confirmation quand un lancement touche beaucoup d’hôtes (5 ou plus par défaut) ou contient une commande qui semble destructrice, comme rm -rf, reboot ou mkfs. Les deux se règlent dans Réglages › Sécurité. C’est un garde-fou contre les étourderies, pas une barrière de sécurité.

Quand quelque chose échoue

Relancer les échecs (ou Fichier › Relancer sur les hôtes en échec) relance le dernier travail sur les hôtes en échec, annulés ou jamais atteints, et sur eux seulement.

Extraits et variables

Un extrait est une suite de commandes enregistrée. Le menu Extraits des réglages d’un hôte enregistre les commandes affichées comme extrait, ou en insère un.

Extraits et commandes peuvent contenir des espaces réservés entre doubles accolades :

Exemple : sudo systemctl restart {{service=nginx}} demande quel service redémarrer, avec nginx déjà rempli.

Déploiement progressif PRO

Pour les changements risqués, Rajada peut essayer un hôte avant les autres. Choisissez le mode dans le menu Déploiement en bas de la barre latérale, ou dans Réglages › Lancements en lot :

La pause après le premier hôte d’un déploiement : sa sortie, et les boutons pour s’arrêter ou continuer sur les 3 autres hôtes.

Dans les mêmes réglages, S’arrêter au premier échec ne démarre plus aucun hôte dès qu’un hôte a échoué (ceux déjà en cours terminent), et Hôtes en même temps limite le nombre d’hôtes touchés à la fois par un lancement en parallèle.

Résultats, comparaison et historique

Terminaux interactifs

L’onglet Terminal d’un hôte ouvre une session SSH en direct, pour cd, sudo, vim ou top. Cliquez sur Connecter ; la session continue pendant que vous regardez d’autres hôtes. Si la connexion tombe, Rajada se reconnecte tout seul (désactivable dans Réglages › Terminal).

Envoyer et télécharger des fichiers PRO

Tunnels PRO

Un tunnel rend disponible sur votre Mac un service que seul le serveur peut atteindre. Choisissez Tunnels… dans le menu contextuel d’un hôte, ou le bouton à flèches à côté de son nom, puis ajoutez des redirections :

Exemple : le port local 15432 vers localhost port 5432 sur un serveur de base de données permet à un client de votre Mac d’utiliser 127.0.0.1:15432. Cliquez sur Démarrer. Le tunnel reste ouvert après la fermeture de la fenêtre, jusqu’à ce que vous l’arrêtiez ou quittiez Rajada. Il n’écoute que sur 127.0.0.1 : les autres machines ne peuvent pas l’utiliser.

Fenêtre des tunnels d’un serveur de base de données, avec deux redirections actives.

État des hôtes PRO

État (⇧⌘T) affiche, pour les hôtes sélectionnés (ou tous), le système, la durée de fonctionnement, la charge, l’occupation du disque et de la mémoire et les mises à jour en attente, avec un signal quand un redémarrage est requis. Les valeurs à surveiller sont en orange. La sonde ne fait que lire des fichiers système, ne change rien et n’est pas enregistrée dans l’historique. Mises à jour et redémarrages en attente sont connus sur Debian et Ubuntu.

Sécurité et confidentialité

Clés d’hôte

À la première connexion à un serveur, Rajada affiche l’empreinte de sa clé et demande s’il faut lui faire confiance. Si un serveur présente plus tard une autre clé, la connexion est bloquée et Rajada vous prévient. Vérifiez la nouvelle empreinte sur le serveur lui-même avant d’oublier l’ancienne clé. Fichier › Clés d’hôte de confiance… (⇧⌘K) liste les clés de confiance, permet d’en retirer une et d’exporter la liste.

Mots de passe

Quand un serveur demande un mot de passe, cochez Mémoriser dans le Trousseau pour l’enregistrer dans le Trousseau de macOS ; Rajada ne le stocke nulle part ailleurs. Réglages › Mots de passe enregistrés › Tout oublier… efface tous les mots de passe et phrases secrètes enregistrés. Pendant un lancement en lot, un mot de passe tapé une fois est réutilisé pour la même question sur les autres hôtes de ce lancement.

Verrouillage de l’app

Dans Réglages › Verrouillage de l’app, Rajada peut exiger Touch ID ou le mot de passe de votre compte à l’ouverture, se verrouiller après un temps d’inactivité (15 minutes par défaut) et quand le Mac se met en veille, et redemander avant les lancements qui semblent destructeurs. Verrouillez-le à tout moment avec ⌃⌘L. Pendant le verrouillage, les sessions et lancements déjà démarrés continuent.

Historique et secrets

L’historique des lancements est chiffré sur votre Mac. Avec Masquer les mots de passe et jetons avant l’enregistrement, les mots de passe, jetons et clés qui apparaissent dans les sorties sont remplacés par des points avant d’être enregistrés.

Vos données

Tout reste sur votre Mac : pas de compte, pas de statistiques, aucun serveur de notre part. Voir la politique de confidentialité.

Sauvegarder ou déplacer votre configuration

Fichier › Exporter la configuration… enregistre vos hôtes, groupes, étiquettes, tunnels et extraits dans un fichier. Les mots de passe, les éléments du Trousseau et les clés privées n’en font pas partie. Fichier › Importer une configuration… PRO ajoute les hôtes d’un tel fichier à ceux déjà présents ; ce qui existe déjà n’est pas modifié.

Sur un nouveau Mac, ajoutez d’abord vos clés SSH, puis importez : un hôte retrouve sa clé quand le fichier de clé est au même endroit qu’avant.

Rajada Pro

La version gratuite gère jusqu’à 5 hôtes et comprend les lancements en lot, les terminaux et toutes les protections. Rajada Pro, un achat unique sans abonnement, ajoute les hôtes illimités, le déploiement progressif, les transferts de fichiers, les tunnels, l’état des hôtes, la comparaison des sorties et l’import.

Achetez-le depuis Réglages › Rajada Pro › Obtenir Pro…, ou à la première utilisation d’une fonction Pro. Sur un autre Mac avec le même compte Apple, utilisez Restaurer l’achat.

Raccourcis clavier

TouchesAction
⇧⌘IImporter des hôtes depuis un ssh config
⇧⌘UEnvoyer des fichiers à la sélection
⇧⌘JTélécharger des fichiers depuis la sélection
⇧⌘TÉtat des hôtes
⇧⌘DComparer les sorties du dernier lancement
⇧⌘RRelancer sur les hôtes en échec
⇧⌘KClés d’hôte de confiance
⌃⌘LVerrouiller Rajada
⌘+ ⌘− ⌘0Texte plus grand, plus petit, taille par défaut
⌘] ⌘[Terminal suivant, précédent dans une grille
⌥⌘ + flèchesTerminal au-dessus, en dessous, à gauche, à droite dans une grille
⇧⌘↩Agrandir le terminal actif
⇧⌘] ⇧⌘[Hôte suivant, précédent ayant un terminal ouvert
⌘1 … ⌘9Hôte ayant un terminal ouvert, numéro 1 à 8 ; ⌘9 le dernier
⇧⌘SExporter le défilement d’un terminal
⌘FRechercher dans le terminal

Il manque quelque chose, ou c’est peu clair ? Écrivez-nous.