Ordner
Der Bereich Ordner listet die Ordner auf Ihrem Mac auf, die in die VM dieses Arbeitsbereichs freigegeben werden. Ein freigegebener Ordner ist die Brücke zwischen Ihrem echten Dateisystem und der Sandbox: Hier liest der Agent den Code, an dem er arbeitet, und schreibt die Änderungen, die er vornimmt. Alles andere, was die VM berührt — ihr Home-Verzeichnis, ihre Systemplatte — ist verwerfbar und isoliert; ein freigegebener Ordner ist es nicht. Er ist ein aktives Fenster mit Lese- und Schreibzugriff auf Ihren Mac.
Die Beschriftung des Bereichs formuliert die Regel genau: Jeder Ordner wird unter seinem echten Namen in die VM eingehängt (z. B. ~/Documents → ~ubuntu/Documents). Auf 8 Ordner pro Arbeitsbereich begrenzt. Sind keine Ordner konfiguriert, steht dort Keine Ordner freigegeben.
Wie Ordner freigegeben werden
Jeder Ordner, den Sie hinzufügen, wird als virtiofs-Freigabe an die VM angehängt und unter /home/ubuntu/<basename> eingehängt, wobei <basename> der eigene Name des Ordners ist. Die Freigabe von ~/Documents lässt ihn innerhalb der VM als ~ubuntu/Documents erscheinen (das heißt /home/ubuntu/Documents); die Freigabe von ~/code/bromure erscheint als /home/ubuntu/bromure. Für den Einhängenamen wird nur die letzte Pfadkomponente verwendet, sodass zwei Ordner mit demselben Basisnamen aus unterschiedlichen Speicherorten kollidieren würden — geben Sie einem von ihnen einen eindeutigen Verzeichnisnamen, wenn Sie beide benötigen.
Die Freigabe erfolgt mit Lese- und Schreibzugriff. Der Agent innerhalb der VM kann in einem freigegebenen Ordner Dateien erstellen, ändern und löschen, genau wie es ein lokaler Prozess auf Ihrem Mac könnte, und diese Änderungen sind auf der Host-Seite sofort und dauerhaft. Genau das macht den Arbeitsbereich nützlich: Der Agent bearbeitet Ihre Arbeitskopie direkt vor Ort, und git, Ihr Editor und Ihre anderen Werkzeuge auf dem Mac sehen die Änderungen, während sie geschehen.
Da Freigaben angehängt werden, wenn die VM beim Start konfiguriert wird, wird eine Änderung an dieser Liste beim nächsten Start der VM des Arbeitsbereichs wirksam. Das Hinzufügen oder Entfernen eines Ordners bei laufender Sitzung fügt ihn nicht per Hot-Plug hinzu — sichern Sie die Änderung und starten Sie dann die Sitzung neu, um sie zu übernehmen.
Warnung: Ein freigegebener Ordner ist nicht Teil der Sandbox. Er überdauert alles, was die VM zurücksetzt. Das Löschen eines Arbeitsbereichs lässt ihn ausdrücklich unberührt — der Bestätigungsdialog lautet „Der eingehängte Host-Ordner bleibt unangetastet." — und wenn ein Arbeitsbereich jemals als kompromittiert gekennzeichnet und gelöscht wird, werden seine freigegebenen Ordner nicht gelöscht und enthalten möglicherweise noch Dateien, die der Agent geschrieben hat. Geben Sie nur die Ordner frei, die der Agent tatsächlich benötigt, und überprüfen Sie einen freigegebenen Ordner nach jedem Kompromittierungsereignis von Hand. Siehe Zugangsdaten und die Übertragungsgrenze für den Kompromittierungsablauf.
Ordner hinzufügen und entfernen
Um einen Ordner freizugeben, klicken Sie unten im Bereich auf Ordner hinzufügen…. Dies öffnet einen Verzeichnisauswähler, in dem Sie einen oder mehrere Ordner auf einmal auswählen können; jedes ausgewählte Verzeichnis wird zu einer neuen Zeile. Die Schaltfläche ist deaktiviert, sobald der Arbeitsbereich bereits acht Ordner hat — das Maximum pro Arbeitsbereich.
Jeder konfigurierte Ordner erscheint als Zeile, die den Namen des Ordners und seinen vollständigen Pfad auf Ihrem Mac zeigt. Klicken Sie auf die Minus-Schaltfläche in einer Zeile, um die Freigabe dieses Ordners zu beenden; das Entfernen einer Zeile hier löscht niemals den Ordner oder seinen Inhalt auf dem Host — es trennt ihn nur beim nächsten Start von der VM.
Die Liste der aktuell freigegebenen Ordner ist auch in der laufenden Sitzung sichtbar: Das Infofeld des Sitzungsfensters zeigt eine Liste Freigegebene Ordner, sodass Sie auf einen Blick bestätigen können, was der Agent erreichen kann. Siehe Sitzungen.
Einstellungsreferenz
| Einstellung | Typ | Standard | Beschreibung |
|---|---|---|---|
| Ordnerliste | Liste von Host-Pfaden | Leer | Jede Zeile zeigt den Ordnernamen und seinen vollständigen Host-Pfad, mit einer Minus-Schaltfläche zum Entfernen. Eingehängt mit Lese- und Schreibzugriff unter /home/ubuntu/<basename>. |
| Ordner hinzufügen… | Verzeichnisauswähler (Mehrfachauswahl) | — | Fügt einen oder mehrere Ordner hinzu. Deaktiviert, sobald acht Ordner konfiguriert sind. |
Verwandte Kapitel
- Konzepte — wie die VM, ihre verwerfbaren Schichten und virtiofs-Freigaben zusammenpassen.
- Sitzungen — das laufende Sitzungsfenster und seine Liste freigegebener Ordner.
- Zugangsdaten und die Übertragungsgrenze — was ein Kompromittierungs-Löschvorgang berührt und was nicht.
- Einstellungsreferenz — alle Bereiche auf einen Blick.