WSL-Containereinstellungen

Sie können festlegen, wie wslc.exe Container ausführt, z. B. wie viele CPUs und wie viel Arbeitsspeicher die Containersitzung verwenden kann, mit einer YAML-Einstellungsdatei pro Benutzer unter %LOCALAPPDATA%\wslc\settings.yaml.

Öffnen Sie die Einstellungsdatei

Die Einstellungsdatei ist standardmäßig nicht vorhanden. Um sie zu erstellen und in Ihrem Standard-Editor für .yaml Dateien zu öffnen (oder Notepad, wenn kein Editor zugeordnet ist), führen Sie Folgendes aus:

wslc settings

Wenn Sie diesen Befehl zum ersten Mal ausführen, erstellt wslc die Datei, wobei jede Einstellung auskommentiert und auf default gesetzt ist. Entfernen Sie die Auskommentierung einer Zeile und ersetzen Sie default durch Ihren Wert, um eine Einstellung zu ändern. Um die Datei erneut mit den auskommentierte Standardwerten zu überschreiben, führen Sie Folgendes aus:

wslc settings reset

Hier ist ein Beispiel für eine settings.yaml-Datei angegeben:

session:
  cpuCount: 4
  memorySize: 8GB
  maxStorageSize: 500GB
  storagePath: D:\data
  defaultBindingAddress: 127.0.0.1
  hostLoopback: host.wslc.internal
  idleTimeout: 60

Verfügbare Einstellungen

Jede Einstellung akzeptiert den Wert default, wodurch der integrierte Standardwert verwendet wird. Einstellungen, die in der Datei fehlen, werden ebenfalls mit der integrierten Standardeinstellung belegt.

Setting Value Vorgabe Description
session.cpuCount Zahl Alle logischen Prozessoren Die Anzahl der virtuellen Prozessoren, die der Containersitzung zugewiesen sind. Muss größer als 0 sein.
session.memorySize size 50 % des gesamten Arbeitsspeichers unter Windows Maximale Speichermenge, die der Container-Sitzung zugewiesen ist, z. B. 8GB.
session.maxStorageSize size 1TB Maximale Größe des virtuellen Datenträgers (VHDX), der die Images und Container der Sitzung speichert, z. B 500GB. .
session.storagePath path %LOCALAPPDATA% Absolutes Basisverzeichnis für den Speicher der Standardsitzung. Der virtuelle Datenträger wird unter <storagePath>\wslc\sessions\<session>\storage.vhdx erstellt.
session.defaultBindingAddress IPv4-Adresse 127.0.0.1 Hostadresse, an die veröffentlichte Ports gebunden werden, wenn Sie wslc container run -p ohne Angabe einer Adresse verwenden. Auf 0.0.0.0 festlegen, um an alle Hostschnittstellen zu binden.
session.hostLoopback string host.wslc.internal DNS-Name, den die Container verwenden können, um den Windows-Host zu erreichen. Auf none setzen, um diesen Namen zu deaktivieren.
session.idleTimeout Zahl 30 Die Anzahl der Sekunden, die die Sitzungs-VM im Leerlauf weiterläuft, bevor sie heruntergefahren wird. Muss größer als 0 sein.
credentialStore wincred oder file wincred Wo Containerregistrierungsanmeldeinformationen von wslc login gespeichert werden. wincred verwendet Windows Anmeldeinformations-Manager. file verwendet eine DPAPI-verschlüsselte Datei unter %LOCALAPPDATA%\wslc\registry-credentials.json.

Größenwerte sind eine ganze Zahl, gefolgt von einer optionalen Einheit: B, /KBK, MMB/, G/GB, TBT/ oder P/PB (Groß-/Kleinschreibung wird nicht beachtet). Einheiten sind binär, also ist 1GB 1024 MB. Ein Wert ohne Einheit wird als Bytes interpretiert, und der Mindestwert beträgt 1 MB.

Note

Wenn session.storagePath geändert wird, nachdem bereits eine Sitzung besteht, werden vorhandene Images, Container oder Speicher nicht verschoben. Der vorherige Speicher bleibt vorhanden, und an dem neuen Speicherort wird eine neue, leere Sitzung erstellt.

Wann Änderungen wirksam werden

  • Sitzungseinstellungen (session.*) werden gelesen, wenn die Containersitzung gestartet wird. Wenn eine Sitzung bereits läuft, beenden Sie sie mit wslc system session terminate, damit der nächste wslc-Befehl eine neue Sitzung mit den von Ihnen aktualisierten Einstellungen startet. Eine Sitzung wird auch eigenständig beendet, nachdem sie session.idleTimeout Sekunden im Leerlauf war.
  • session.defaultBindingAddress und credentialStore werden jedes Mal gelesen, wenn Sie einen wslc Befehl ausführen.

Wenn die Einstellungsdatei eine unbekannte Einstellung, einen ungültigen Wert oder ungültiges YAML enthält, gibt wslc eine Warnung aus, die den Dateipfad und die Zeilennummer enthält, und verwendet die integrierte Standardeinstellung für die betroffenen Einstellungen.

Note

Diese Einstellungen gelten für die Sitzung, die von wslc.exe verwendet wird. .wslconfig Die Einstellungen gelten nicht für WSL-Container. Anwendungen, die die WSL-Container-API verwenden, konfigurieren ihre eigenen Sitzungen im Code, z. B. mit SessionSettings.

Weitere Ressourcen

  • Zuletzt aktualisiert um