Mac distant

Comment poursuivre une tâche après une déconnexion SSH sur macOS Tahoe 26 ? Guide 2026

Le choix gagnant est tmux pour les tâches interactives après une coupure SSH, et launchd ou un agent d’intégration continue pour les tâches sans surveillance qui doivent survivre à un redémarrage. Pour poursuivre une tâche après une déconnexion SSH sur macOS Tahoe 26, il faut donc séparer la continuité du terminal, la survie du processus et le redémarrage du système.

Cet article s’adresse aux développeurs qui lancent des compilations Xcode, des tests ou des installations de dépendances via SSH, aux ingénieurs qui laissent tourner un agent, un script ou une tâche de données, ainsi qu’aux responsables d’un nœud Mac de construction devant être vérifié après une panne de connexion ou un redémarrage.

Comprendre l’interruption avant de lancer la tâche

Une déconnexion SSH ne désigne pas toujours le même événement. La fermeture du terminal client, une perte réseau, la fin de la session utilisateur et le redémarrage du Mac ont des conséquences différentes :

  • une fenêtre de terminal fermée peut interrompre un processus directement attaché à cette fenêtre ;
  • une coupure réseau peut seulement supprimer le canal SSH, alors que le processus continue ;
  • la fermeture de la session utilisateur peut affecter les processus liés à cette session ;
  • un redémarrage arrête les processus en mémoire, y compris une session tmux.

Cette distinction évite une erreur fréquente : activer une option de maintien de connexion et croire que la tâche est désormais hébergée. Un mécanisme de maintien peut améliorer la détection d’une liaison inactive, mais il ne transforme pas un processus au premier plan en service supervisé.

Pour un diagnostic fiable, l’équipe doit noter avant le lancement le type de tâche, le répertoire de travail, le chemin du journal, le nom de la session et le résultat attendu. Une compilation peut être relancée ; une migration ou une génération de fichiers peut, elle, produire des écritures concurrentes si elle est démarrée une seconde fois sans contrôle.

Attention : nohup isolé ne constitue pas une stratégie complète pour un nœud de production. Il ne fournit ni interface de rattachement comparable à tmux, ni définition claire du redémarrage, ni supervision structurée.

Première étape : établir une liaison SSH observable

macOS Tahoe 26 prend en charge l’accès SSH par la fonction Remote Login d’Apple. La configuration doit être vérifiée dans les réglages du Mac, avec une liste d’utilisateurs autorisés plutôt qu’une ouverture indistincte à tous les comptes ; la documentation Apple sur Remote Login décrit cette configuration et sa portée.

La procédure de préparation peut être consignée sous forme de contrôle :

  • [ ] Remote Login est activé sur le Mac cible ;
  • [ ] le compte d’exploitation prévu figure dans la liste autorisée ;
  • [ ] le nom d’hôte utilisé par l’équipe correspond bien au nœud attendu ;
  • [ ] l’empreinte de l’hôte a été enregistrée lors de la première connexion ;
  • [ ] le répertoire du projet et le répertoire des journaux sont connus ;
  • [ ] aucun mot de passe, jeton, certificat ou clé privée n’est copié dans un script ;
  • [ ] la commande d’entrée de la tâche peut être relancée ou arrêtée explicitement.

Les exemples ci-dessous utilisent uniquement des valeurs fictives :

ssh compte-exemple@hote-exemple
cd ~/projet-exemple
pwd
git status

Le but de pwd n’est pas de tester la performance ; il confirme que la tâche sera lancée dans le répertoire prévu. De même, l’identification de l’hôte doit être conservée dans la documentation de l’équipe, sans exposer d’adresse réelle dans un dépôt ou dans un ticket public.

La stabilité de la connexion et la persistance de la tâche doivent être testées séparément. Une session SSH qui reste ouverte ne prouve pas qu’un processus survivra à la fermeture du client ; inversement, une session interrompue ne prouve pas que le processus a disparu.

Deuxième étape : placer la tâche interactive dans tmux

tmux convient aux tâches qu’un opérateur doit pouvoir observer ou reprendre : compilation Xcode, suite de tests, installation longue de dépendances, agent piloté depuis un terminal ou génération audio et vidéo nécessitant une surveillance ponctuelle. La documentation officielle de tmux décrit le principe de séparation et de rattachement d’une session.

L’installation et la vérification doivent rester simples. Si tmux est installé avec Homebrew, la formule officielle tmux permet de contrôler le paquet disponible :

brew install tmux
tmux -V

Ensuite, une séquence minimale suffit :

tmux new -s build-exemple
mkdir -p ~/journaux/projet-exemple
./script-de-construction.sh 2>&1 | tee ~/journaux/projet-exemple/build.log

La session est ensuite détachée avec le raccourci tmux prévu à cet effet, sans arrêter le programme. Une autre possibilité, depuis un shell tmux, consiste à demander le détachement par commande :

tmux detach-client

Après une coupure SSH, la reconnexion se fait ainsi :

ssh compte-exemple@hote-exemple
tmux ls
tmux attach -t build-exemple

Le nom de session doit être suffisamment explicite pour distinguer, par exemple, une construction, une suite de tests et un agent. L’objectif n’est pas de transformer cet article en manuel tmux complet : il s’agit de rendre l’état de la tâche retrouvable et d’éviter le lancement involontaire d’une seconde instance.

Les journaux doivent être écrits dans un emplacement persistant et distinct du terminal. Une commande visible à l’écran mais absente d’un fichier ne permet pas de prouver le résultat après reconnexion. Pour les flux audio ou vidéo, le même principe s’applique : l’aperçu peut être interactif, mais l’export et les messages d’erreur doivent rester consultables hors de la session graphique.

Troisième étape : reprendre selon les preuves disponibles

Après une coupure, la première action ne doit pas être de relancer la commande. Il faut d’abord établir dans quel état se trouve l’exécution :

tmux ls
pgrep -fl script-de-construction
tail -n 50 ~/journaux/projet-exemple/build.log

Ces commandes ne suffisent pas à déclarer une compilation réussie. Elles servent à classer la situation.

La session tmux existe encore

La tâche peut être en cours, terminée ou bloquée. Il faut rattacher la session, observer la sortie, puis vérifier le code de retour et les fichiers produits. Si le programme a déjà terminé, une nouvelle exécution immédiate risquerait d’écraser ou de régénérer les mêmes artefacts.

La session existe, mais le processus a quitté

Le journal doit être lu jusqu’à la dernière erreur, puis comparé au résultat attendu. Un fichier produit ne prouve pas nécessairement que toute la chaîne a réussi : une étape de signature, de test ou d’archivage peut avoir échoué après la génération d’un artefact partiel.

La session est absente

Cette absence peut correspondre à un nettoyage volontaire, à un arrêt du processus ou à un redémarrage du Mac. Les journaux système, le journal de la tâche et l’heure de modification des artefacts doivent être examinés avant toute relance. Si aucune preuve ne permet de distinguer une exécution complète d’une exécution partielle, la reprise doit commencer par une étape sûre et idempotente, pas par une construction concurrente.

La session existe, mais la sortie ne progresse plus

Il faut comparer plusieurs observations séparées dans le temps, regarder le processus associé et examiner les fichiers temporaires. Un terminal immobile n’est pas automatiquement un blocage : certaines étapes de compilation ou d’installation produisent peu de sortie. La décision d’arrêter doit donc reposer sur un signal identifiable, comme une erreur, un processus disparu ou une absence durable de modification dans le journal.

Une fiche de reprise peut demander les éléments suivants :

  • [ ] identifiant de la session tmux ;
  • [ ] identifiant ou nom du processus observé ;
  • [ ] dernière ligne significative du journal ;
  • [ ] code de sortie obtenu ;
  • [ ] date de modification de l’artefact attendu ;
  • [ ] décision documentée : rattacher, arrêter ou relancer ;
  • [ ] absence confirmée d’une seconde instance concurrente.

Quatrième étape : transférer le permanent vers launchd

tmux protège la continuité d’une session terminal ; il ne garantit pas la renaissance d’un service après un redémarrage. Pour un script planifié, un agent de construction ou un ordonnanceur qui doit revenir sans intervention, la responsabilité doit être transférée à launchd.

Apple décrit launchd comme un mécanisme de gestion des démons et services macOS dans sa documentation consacrée aux daemons et services. Le choix entre LaunchAgent et LaunchDaemon dépend notamment du contexte utilisateur, de l’accès à la session graphique et des privilèges requis :

  • un LaunchAgent est lié à un contexte utilisateur et convient mieux à une tâche qui dépend de cette session ;
  • un LaunchDaemon est destiné à un service indépendant de l’interface utilisateur, avec des exigences de privilèges et de chemins plus strictes ;
  • une tâche qui nécessite une fenêtre, un trousseau déverrouillé ou un accès graphique doit être testée dans le contexte réel, et non déduite d’un lancement SSH sans interface.

Un fichier de service doit déclarer explicitement le programme, le répertoire de travail, les variables d’environnement nécessaires, les chemins de sortie et d’erreur, ainsi que la politique de lancement. Les clés acceptées et leur comportement doivent être vérifiés dans la documentation de launchd.plist, tandis que les opérations de chargement et d’inspection doivent suivre le manuel de launchctl.

Exemple volontairement incomplet, avec des chemins fictifs :

<key>ProgramArguments</key>
<array>
    <string>/Users/compte-exemple/bin/tache-exemple</string>
</array>
<key>WorkingDirectory</key>
<string>/Users/compte-exemple/projet-exemple</string>
<key>StandardOutPath</key>
<string>/Users/compte-exemple/journaux/tache.out</string>
<key>StandardErrorPath</key>
<string>/Users/compte-exemple/journaux/tache.err</string>

La configuration complète doit aussi répondre à trois questions opérationnelles : quand le service démarre-t-il, que se passe-t-il après un arrêt volontaire et comment l’opérateur confirme-t-il qu’il fonctionne ? Une configuration qui redémarre sans limite un programme défectueux peut remplir les journaux ou masquer la cause initiale ; une configuration sans journal rend le diagnostic après redémarrage inutilement difficile.

Le chargement, l’inspection et l’arrêt doivent être traités comme des opérations séparées. L’équipe doit conserver le fichier source du service, vérifier le domaine utilisé et observer l’état retourné par launchctl, plutôt que recopier une ancienne commande trouvée dans un tutoriel. La configuration doit être reproductible, arrêtée proprement et réinstallable sur un nœud de remplacement.

Cinquième étape : tester la reprise avant la mise en production

Une affirmation comme « la tâche tourne en arrière-plan » ne constitue pas une réception technique. Le nœud doit être soumis à plusieurs interruptions contrôlées, chacune avec un résultat attendu différent.

Test de fermeture SSH

Lancer une tâche dans tmux, vérifier que le journal avance, détacher la session puis fermer le client SSH. Après reconnexion, contrôler l’existence de la session, le processus, la dernière ligne du journal et l’artefact. Le résultat attendu est une reprise possible sans seconde instance.

Test de changement de réseau côté client

Changer de réseau sur la machine cliente ou interrompre volontairement sa connectivité, puis se reconnecter. Ce test concerne le canal SSH ; il ne remplace pas le test de redémarrage du Mac. La preuve attendue reste la même : état de la session, progression du journal et résultat de la tâche.

Test de redémarrage contrôlé

Avant le redémarrage, noter la tâche active et son dernier point de progression. Après le retour du Mac, vérifier Remote Login, inspecter launchd, consulter les journaux et confirmer si le service permanent a repris. Une session tmux ne doit pas être présentée comme automatiquement restaurée : elle était destinée à survivre à la déconnexion du terminal, non à recréer un processus après l’arrêt du système.

Rappel d’exploitation : une tâche qui dépend d’une session graphique, d’un trousseau ou d’une autorisation interactive doit avoir un scénario de reprise distinct. Un service launchd correctement chargé ne garantit pas, à lui seul, la disponibilité de chaque ressource graphique.

Pour les opérations de construction, l’agent d’intégration continue peut compléter launchd : launchd assure le démarrage local du service, tandis que l’agent fournit généralement une file d’exécution, des statuts et une collecte de journaux. Le choix dépend du besoin de planification, du degré d’interaction et du niveau d’audit attendu.

Comparer les solutions selon l’interruption à absorber

Solution Coupure SSH Fermeture de session Redémarrage du Mac Interaction humaine Usage recommandé
Processus au premier plan Incertain Fragile Non Forte Commande courte et surveillée
nohup seul Partiel Variable Non Faible Cas ponctuel, après validation limitée
tmux Oui, si la session reste active À vérifier selon le contexte Non Oui Compilation, tests, agent interactif
LaunchAgent Oui Selon le contexte utilisateur Oui, si configuré et testé Limitée Service lié à une session
LaunchDaemon Oui Oui Oui, si configuré et testé Non Service permanent indépendant de l’interface
Agent d’intégration continue Oui, selon son service local Oui, selon sa configuration Oui, après validation Faible Construction et tests structurés

Cette comparaison ne remplace pas un essai sur le projet réel. Une compilation Xcode, une installation de dépendances, un agent d’intelligence artificielle et un export vidéo ne partagent pas nécessairement les mêmes exigences de session, de trousseau ou d’interface.

Question de décision tmux launchd Agent d’intégration continue
Un opérateur doit-il reprendre le terminal ? À privilégier Peu adapté Généralement non
La tâche doit-elle revenir après redémarrage ? Non À privilégier Oui, si le service est installé
Le journal doit-il être associé à une exécution identifiable ? À organiser À définir dans le service Généralement prévu par l’outil
La tâche nécessite-t-elle une interface graphique ? Possible, à vérifier Contexte critique à tester Dépend de l’agent et de la session
Le traitement est-il une construction automatisée ? Pour le diagnostic ponctuel Pour héberger le service À privilégier pour le cycle complet
La priorité est-elle une reprise manuelle rapide ? À privilégier Secondaire Variable

Questions fréquentes

Une commande distante continue-t-elle après une coupure SSH ?

Pas systématiquement. Une commande attachée directement au terminal peut s’arrêter lorsque la session disparaît, alors qu’un processus placé dans tmux peut rester actif. Après reconnexion, il faut vérifier la session, le processus et les journaux. La seule persistance de la connexion ne permet donc pas de conclure que le travail est intact.

Comment protéger une compilation avec tmux sur macOS Tahoe 26 ?

La compilation doit être lancée dans une session tmux nommée, avec une sortie redirigée vers un journal conservé dans un répertoire persistant. L’opérateur détache ensuite la session avant de fermer SSH. À la reconnexion, il vérifie d’abord la session et le journal, puis se rattache ou arrête la tâche selon les preuves observées.

Une session tmux se restaure-t-elle après un redémarrage ?

Non. tmux permet de détacher puis de rattacher une session tant que le système et le processus sont encore actifs. Après un redémarrage, la session en mémoire n’existe plus. La reprise automatique exige un service launchd ou un agent d’intégration continue, avec des chemins, des variables et des journaux testés.

tmux ou launchd pour un script permanent ?

tmux est le meilleur choix lorsqu’un ingénieur doit observer une tâche interactive ou intervenir manuellement. launchd convient à un script sans interaction qui doit être relancé selon des conditions définies, notamment après redémarrage. Pour une chaîne de construction avec statuts et historique, un agent d’intégration continue doit être évalué en complément.

Décider si le Mac distant doit rester permanent

Après les tests, la décision doit être liée au cycle de vie réel de la tâche :

  • si l’exécution est ponctuelle et interactive, tmux sur un Mac temporairement disponible peut suffire ;
  • si le service doit démarrer sans opérateur après un redémarrage, launchd devient une exigence ;
  • si la tâche nécessite Xcode, une session graphique, un trousseau ou des outils audio et vidéo, ces dépendances doivent être validées sur le nœud réel ;
  • si les constructions sont fréquentes, parallélisées ou soumises à une file, un agent d’intégration continue est plus approprié qu’une suite de commandes lancées manuellement ;
  • si les interruptions doivent être auditées, chaque test doit conserver son état initial, son action, ses observations et son résultat.

Une solution locale existante peut sembler plus simple, mais elle présente souvent trois limites : le Mac n’est pas disponible en permanence, ses ressources sont partagées avec le poste de travail, et un redémarrage ou une mise à jour peut interrompre le nœud sans procédure de reprise. Un serveur Linux évite certains coûts d’administration, mais il ne fournit pas l’environnement macOS nécessaire à Xcode et à plusieurs outils Apple. Une machine virtuelle ou une solution non native ajoute de son côté des incertitudes sur l’interface graphique, les autorisations et les performances réelles.

Lorsque le besoin porte sur une fenêtre de construction temporaire, un agent à tester ou un Mac qui doit rester accessible sans achat de matériel, la console Mac distante de KuzCloud peut être évaluée avec une tâche réelle, puis avec le même scénario de déconnexion et de redémarrage. Les conditions d’accès et les limites opérationnelles doivent être lues dans les informations d’aide de KuzCloud, plutôt que déduites d’un simple essai SSH.

La location n’est toutefois pas idéale pour un traitement lourd et parfaitement stable sur une longue durée si l’équipe a besoin d’un matériel physiquement dédié, d’un périphérique local particulier ou d’une maîtrise complète du cycle d’alimentation. Dans ce cas, l’achat d’un Mac peut rester plus cohérent. Pour un projet temporaire, une validation de pipeline ou un agent qui doit être accepté avant engagement durable, l’usage à la semaine ou au mois d’un Mac distant avec les droits nécessaires offre généralement un chemin de test plus réversible.

La réception finale doit tenir sur une fiche vérifiable : tâche choisie, interruption provoquée, session observée, journal conservé, artefact contrôlé, comportement après redémarrage et décision de maintien ou de retrait du nœud. C’est cette preuve, et non la simple présence d’une invite SSH, qui permet d’affirmer que la tâche peut réellement continuer sur macOS Tahoe 26.

Poursuivez vos tâches macOS avec KuzCloud

Louez un Mac distant KuzCloud pour exécuter vos projets de développement même après une interruption de votre session SSH.

Retrouvez rapidement votre environnement de travail grâce à un accès distant conçu pour les tâches longues et les connexions persistantes.