Dossiers
Le volet Dossiers liste les dossiers de votre Mac partagés dans la VM de cette machine (une machine est un espace de travail, dans l'éditeur de réglages). Un dossier partagé est là où l'agent lit le code sur lequel il travaille et écrit ses modifications. Tout le reste de ce que la VM touche — son dossier personnel, son disque système — est isolé ; un dossier partagé ne l'est pas. C'est une fenêtre vivante, en lecture-écriture, sur votre Mac.
La légende du volet : « Ajoutez vos projets et dossiers personnels à monter dans cet espace de travail. Chacun garde son nom à l'intérieur, et vous pouvez en ajouter jusqu'à 8. » Sans rien de configuré, il indique Aucun dossier partagé.
Comment les dossiers sont partagés
Chaque dossier est monté à /home/ubuntu/<nom>, où <nom> est le nom du dossier lui-même : ~/Documents apparaît comme ~/Documents dans la VM, et ~/code/bromure comme /home/ubuntu/bromure. Seul le dernier composant du chemin est utilisé : deux dossiers du même nom venant d'endroits différents entreraient donc en collision — renommez-en un si vous avez besoin des deux.
Le partage est en lecture-écriture. L'agent peut créer, modifier et supprimer des fichiers dedans, et ces changements sont immédiats et permanents sur votre Mac. C'est ce qui rend la machine utile : l'agent modifie votre copie de travail sur place, et git, votre éditeur et vos autres outils voient les modifications à mesure.
Les partages sont attachés à l'amorçage de la VM. Ajouter ou retirer un dossier sur une machine en cours d'exécution demande de la redémarrer (Redémarrer « nom » pour appliquer ces changements ?). Sur une machine suspendue, enregistrer un changement de dossier demande d'abord Abandonner la VM suspendue de « nom » ? — l'état enregistré ne peut pas être repris avec un autre ensemble de partages, le démarrage suivant est donc un amorçage à froid. Les fichiers du dossier personnel de la machine et des dossiers partagés ne sont pas affectés.
Avertissement : un dossier partagé ne fait pas partie du bac à sable. Il survit à tout ce qui réinitialise la VM : supprimer une machine le laisse tranquille, et si une machine est un jour signalée comme compromise et effacée, ses dossiers partagés ne sont pas effacés et peuvent encore contenir des fichiers que l'agent a écrits. Ne partagez que ce dont l'agent a besoin, et revoyez un dossier partagé à la main après une alerte de compromission. Voir Identifiants et la frontière du fil.
Ajouter et retirer des dossiers
Cliquez Ajouter un dossier… pour ouvrir un sélecteur de dossiers ; vous pouvez sélectionner plusieurs dossiers d'un coup, et chacun devient une ligne. Le bouton est désactivé dès que la machine a huit dossiers.
Chaque ligne montre le nom du dossier et son chemin complet. Le bouton moins arrête le partage ; le dossier et son contenu sur le Mac ne sont jamais touchés.
Dans les clients iPhone, iPad et Vision Pro, Ajouter un dossier… demande plutôt le chemin (« Saisissez le chemin absolu du dossier sur le serveur ; il est monté dans la VM sous son propre nom. »), parce que le dossier vit sur le Mac qui fait tourner la machine.
Astuce : vous n'avez pas besoin de partager un dossier pour démarrer une session sur un projet. L'écran de nouvelle session peut aussi lancer un agent dans un nouveau dossier vide ou dans l'un de vos dossiers récents — voir Démarrer une session.
Fichiers de configuration importés
Si la machine a été créée par la configuration de premier lancement et que l'analyse a importé des fichiers de configuration depuis votre Mac, ils sont listés sous Fichiers de configuration importés dans le volet Identifiants, chacun comme ~/<chemin> avec un décompte de ses réglages, combien de secrets ont été laissés de côté, et quels réglages ont été désactivés. La légende explique : « Copiés tels quels dans la VM. Les secrets ont été laissés de côté — ils arrivent comme identifiants ci-dessus, si bien que la VM ne voit jamais qu'un leurre. » Le bouton moins (« Retirer ce fichier de l'espace de travail ») enlève un fichier de la machine.
Référence des réglages
| Réglage | Type | Défaut | Description |
|---|---|---|---|
| Liste de dossiers | Liste de chemins du Mac | Vide | Chaque ligne montre le nom du dossier et son chemin complet, avec un bouton moins. Monté en lecture-écriture à /home/ubuntu/<nom>. |
| Ajouter un dossier… | Sélecteur de dossiers (multi-sélection) | — | Ajoute des dossiers ; désactivé à huit. Exige un redémarrage d'une machine en cours d'exécution. |
Chapitres liés
- Concepts et architecture — la VM, ses couches, et comment les dossiers y sont partagés.
- Machines — faire tourner, suspendre et redémarrer une machine.
- Identifiants et la frontière du fil — ce qu'un effacement après compromission touche et ne touche pas.
- Référence des réglages — tous les volets d'un coup d'œil.