Paramètres du conteneur WSL

Vous pouvez personnaliser la façon dont wslc.exe exécute les conteneurs, comme le nombre de processeurs et la quantité de mémoire que la session de conteneur peut utiliser, avec un fichier de paramètres YAML par utilisateur situé à l’emplacement %LOCALAPPDATA%\wslc\settings.yaml.

Ouvrir le fichier de paramètres

Le fichier de paramètres n’existe pas par défaut. Pour le créer et l’ouvrir dans votre éditeur par défaut pour les fichiers .yaml (ou Bloc-notes, si aucun éditeur n’est associé), exécutez :

wslc settings

La première fois que vous exécutez cette commande, wslc crée le fichier avec chaque paramètre commenté et défini sur default. Supprimez les marques de commentaire d’une ligne et remplacez default par votre valeur pour modifier un paramètre. Pour écraser à nouveau le fichier avec les valeurs par défaut mises en commentaire, exécutez :

wslc settings reset

Voici un exemple de fichier settings.yaml :

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

Paramètres disponibles

Chaque paramètre accepte la valeur default, qui permet d’utiliser la valeur par défaut intégrée. Les paramètres absents du fichier prennent aussi la valeur par défaut intégrée.

Setting Valeur Default Description
session.cpuCount number Tous les processeurs logiques Nombre de processeurs virtuels affectés à la session de conteneur. Doit être supérieure à 0.
session.memorySize size 50 % de la mémoire totale sur Windows Quantité maximale de mémoire affectée à la session de conteneur, par exemple 8GB.
session.maxStorageSize size 1TB Taille maximale du disque virtuel (VHDX) qui stocke les images et conteneurs de la session, par exemple 500GB.
session.storagePath chemin %LOCALAPPDATA% Répertoire de base absolu pour le stockage de la session par défaut. Le disque virtuel est créé à l’emplacement <storagePath>\wslc\sessions\<session>\storage.vhdx.
session.defaultBindingAddress Adresse IPv4 127.0.0.1 L’adresse de l’hôte à laquelle les ports publiés sont liés lorsque vous utilisez wslc container run -p sans spécifier d’adresse. Définissez la valeur sur 0.0.0.0 pour lier à toutes les interfaces hôtes.
session.hostLoopback string host.wslc.internal Nom DNS que les conteneurs peuvent utiliser pour atteindre l’hôte Windows. Définissez sur none pour désactiver ce nom.
session.idleTimeout number 30 Nombre de secondes pendant lesquelles la machine virtuelle de session reste en cours d’exécution après être devenue inactive avant son arrêt. Doit être supérieure à 0.
credentialStore wincred ou file wincred Où sont stockées les informations d’identification du registre de conteneurs de wslc login. wincred utilise le Gestionnaire d’identification Windows. file utilise un fichier chiffré DPAPI à l’adresse %LOCALAPPDATA%\wslc\registry-credentials.json.

Les valeurs de taille sont un entier suivi d’une unité facultative : B, KB//, KMBM, GB/G, TBT/, ou P/PB (sans respect de la casse). Les unités sont binaires, donc 1GB correspond à 1024 Mo. Une valeur sans unité est interprétée comme des octets, et la valeur minimale est de 1 Mo.

Note

Modifier session.storagePath après qu’une session existe déjà ne déplace pas les images, les conteneurs ou le stockage existants. Le stockage précédent est laissé en place et une nouvelle session vide est créée au nouvel emplacement.

Quand les modifications prennent effet

  • Les paramètres de session (session.*) sont lus au démarrage de la session conteneur. Si une session est déjà en cours d’exécution, arrêtez-la avec wslc system session terminate pour que la commande suivante wslc démarre une nouvelle session avec vos paramètres mis à jour. Une session s’arrête également d’elle-même après avoir été inactive pendant session.idleTimeout secondes.
  • session.defaultBindingAddress et credentialStore sont lus chaque fois que vous exécutez une wslc commande.

Si le fichier de paramètres contient un paramètre inconnu, une valeur non valide ou du YAML non valide, wslc affiche un avertissement qui inclut le chemin d’accès et le numéro de ligne du fichier, et utilise la valeur par défaut intégrée pour les paramètres affectés.

Note

Ces paramètres s’appliquent à la session que wslc.exe utilise. Les paramètres de .wslconfig ne s’appliquent pas aux conteneurs WSL. Les applications qui utilisent l’API conteneur WSL configurent leurs propres sessions dans du code, par exemple avec SessionSettings.

Ressources additionnelles

  • Dernière mise à jour :