WSL konteyner ayarları

wslc.exe konumunda bulunan kullanıcı başına YAML ayar dosyasıyla, %LOCALAPPDATA%\wslc\settings.yaml uygulamasının kapsayıcıları nasıl çalıştırdığını (örneğin, kapsayıcı oturumunun kaç CPU ve ne kadar bellek kullanabileceğini) özelleştirebilirsiniz.

Ayarlar dosyasını aç

Ayarlar dosyası varsayılan olarak mevcut değildir. Bunu oluşturmak ve .yaml dosyaları için varsayılan düzenleyicinizde (veya ilişkili bir düzenleyici yoksa Not Defteri'nde) açmak için şunu çalıştırın:

wslc settings

Bu komutu ilk kez çalıştırdığınızda, wslc tüm ayarların yorum satırı hâline getirildiği ve default olarak ayarlandığı dosyayı oluşturur. Bir satırın yorumunu kaldırın ve bir ayarı değiştirmek için default öğesini değerinizle değiştirin. Dosyanın üzerine yeniden yorum satırı haline getirilmiş varsayılanlarla yazmak için şunu çalıştırın:

wslc settings reset

Örnek bir settings.yaml dosya aşağıda verilmişti:

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

Kullanılabilir ayarlar

Her ayar, yerleşik varsayılanı kullanan default değerini kabul eder. Dosyada eksik olan ayarlar da yerleşik varsayılan değeri kullanır.

Setting Value Default Description
session.cpuCount number Tüm mantıksal işlemciler Kapsayıcı oturumuna atanan sanal işlemci sayısı. 0'dan büyük olmalıdır.
session.memorySize size Windows'ta toplam belleğin 50%'ı Kapsayıcı oturumuna atanan en fazla bellek miktarı, örneğin 8GB.
session.maxStorageSize size 1TB Oturumun imajlarını ve kapsayıcılarını depolayan sanal diskin (VHDX) en büyük boyutu, örneğin 500GB.
session.storagePath path %LOCALAPPDATA% Varsayılan oturumun depolama alanı için mutlak temel dizin. Sanal disk <storagePath>\wslc\sessions\<session>\storage.vhdx konumunda oluşturulur.
session.defaultBindingAddress IPv4 adresi 127.0.0.1 Bir adres belirtmeden wslc container run -p kullandığınızda, yayımlanan bağlantı noktalarının bağlandığı ana bilgisayar adresi. Tüm konak arabirimlerine bağlanmak için 0.0.0.0 olarak ayarlayın.
session.hostLoopback string host.wslc.internal Kapsayıcıların Windows ana bilgisayarına ulaşmak için kullanabileceği DNS adı. Bu adı devre dışı bırakmak için none olarak ayarlayın.
session.idleTimeout number 30 Oturum VM'sinin kapatılmadan önce boşta kaldıktan sonra çalışmaya devam ettiği saniye sayısı. 0'dan büyük olmalıdır.
credentialStore wincred veya file wincred Kapsayıcı kayıt defteri kimlik bilgilerinin wslc login depolandığı yer. wincred, Windows Kimlik Bilgileri Yöneticisi'ni kullanır. file, %LOCALAPPDATA%\wslc\registry-credentials.json adresinde bulunan DPAPI ile şifrelenmiş bir dosyayı kullanır.

Boyut değerleri, ardından isteğe bağlı bir birim gelen bir tamsayıdan oluşur: B, KB/MB, K/M, GB/G, TBT/ veya P/PB (büyük/küçük harfe duyarsız). Birimler ikilidir, bu nedenle 1GB 1024 MB'tır. Birim içermeyen bir değer bayt olarak yorumlanır ve en düşük değer 1 MB'tır.

Note

session.storagePath oturum zaten mevcut olduktan sonra değiştirmek, mevcut görüntüleri, kapsayıcıları veya depolamayı taşımaz. Önceki depolama alanı yerinde bırakılır ve yeni konumda yeni, boş bir oturum oluşturulur.

Değişikliklerin ne zaman geçerli olacağı

  • Kapsayıcı oturumu başlatıldığında oturum ayarları (session.*) okunur. Bir oturum zaten çalışıyorsa, sonraki wslc system session terminate komutun güncelleştirilmiş ayarlarınızla yeni bir oturum başlatması için wslc ile durdurun. Bir oturum da session.idleTimeout saniye boyunca boşta kaldıktan sonra kendi kendine kapanır.
  • session.defaultBindingAddress ve credentialStore, her wslc komutunu çalıştırdığınızda okunur.

Ayarlar dosyası bilinmeyen bir ayar, geçersiz bir değer veya geçersiz YAML içeriyorsa, wslc dosya yolunu ve satır numarasını içeren bir uyarı yazdırır ve etkilenen ayarlar için yerleşik varsayılan değeri kullanır.

Note

Bu ayarlar, wslc.exe tarafından kullanılan oturum için geçerlidir. .wslconfig içindeki ayarlar WSL kapsayıcılarına uygulanmaz. WSL kapsayıcı API'sini kullanan uygulamalar, örneğin SessionSettings ile kodda kendi oturumlarını yapılandırır.

Ek kaynaklar

  • Son güncelleştirme: