Docker ile Visual Studio geliştirme sorunlarını giderme

Uygulandığı yer: Visual Studio

Visual Studio Kapsayıcı Araçları ile çalışırken, uygulamanızı oluştururken veya hata ayıklarken sorunlarla karşılaşabilirsiniz. Bu makalede, bu sorunlara yönelik bazı yaygın sorun giderme adımları tanıtılacaktır.

Birim paylaşımı etkinleştirilmedi. Windows ayarları için Docker CE'de birim paylaşımını etkinleştirme (yalnızca Linux kapsayıcıları)

Dosya paylaşımını yalnızca Docker ile Hyper-V kullanıyorsanız yönetmeniz gerekir. WSL 2 kullanıyorsanız, bu bölümdeki adımları izlemeniz gerekmez ve dosya paylaşımı seçeneği görünmez. Bu sorunu çözmek için:

1. Bildirim alanında Windows için Docker öğesine sağ tıklayın ve ardından Settings öğesini seçin.

2. KaynaklarDosya Paylaşımı'nı seçin ve erişilmesi gereken klasörü paylaşın. Sistem sürücünüzün tamamını paylaşmak mümkündür ancak önerilmez.

   Paylaşılan sürücülerin ekran görüntüsü.

İpucu

Visual Studio Shared Drives yapılandırılmadığında sizi uyarır.

Windows kapsayıcılardaki yollarla ilgili sorunlar

Windows kapsayıcıda Linux'a özgü dosya yollarını kullandığınızda, çeşitli dosya girişi veya çıktı (G/Ç) hatalarıyla karşılaşabilirsiniz. Bu hataları görürseniz ortam değişkeninin değerini denetleyin. Değişken ayarlanırsa, Visual Studio birimleri oluşturmak için Windows dosyalarına başvurmak için Linux için Windows Alt Sistemi (WSL) yollarını kullanmayı dener. Bu yaklaşım WSL'deki Docker için gereklidir, ancak Windows'de Docker Desktop ile çalışmaz. Windows kapsayıcıları kullanıyorsanız bu ortam değişkenlerini her zaman kaldırın.

Hata ayıklama başlatılamıyor

Bu sorunun bir nedeni, kullanıcı profili klasörünüzdeki eski hata ayıklama bileşenleridir. En son hata ayıklama bileşenlerinin bir sonraki hata ayıklama oturumunda indirilmesi için bu klasörleri kaldırmak için aşağıdaki komutları çalıştırın.

• del %userprofile%\vsdbg
• del %userprofile%\onecoremsvsmon

Uygulamanızda hata ayıklarken ağa özgü sorunlar

Kapsayıcı Hosting Ağını Temizleme bölümünden indirilebilen betiği çalıştırarak, konak makinenizdeki ağ ile ilgili bileşenleri yenilemeyi deneyin.

Bağlamalar reddedildi

macOS için Docker kullanırken /usr/local/share/dotnet/sdk/NuGetFallbackFolder klasörüne başvururken bir hatayla karşılaşabilirsiniz. Klasörü Docker'daki Dosya Paylaşımı sekmesine ekleyin.

Docker kullanıcıları grubu

Kapsayıcılarla çalışırken Visual Studio aşağıdaki hatayla karşılaşabilirsiniz:

Docker Desktop'ı kullanabilmek için geçerli kullanıcının 'docker-users' grubunda olması gerekir. Kendinizi 'docker-users' grubuna ekleyin ve ardından Windows oturumunuzdan çıkış yapın.

Docker kapsayıcılarıyla çalışma izinlerine sahip olmak için 'docker-users' grubunun üyesi olmanız gerekir. Windows 10 veya sonraki sürümlerde kendinizi gruba eklemek için şu adımları izleyin:

1. Başlat menüsü Bilgisayar Yönetimi'ni açın.
2. Yerel Kullanıcılar ve Gruplar'ı genişletin ve Gruplar'ı seçin.
3. Docker-users grubunu bulun, sağ tıklayın ve Gruba ekle'yi seçin.
4. Kullanıcı hesabınızı veya hesaplarınızı ekleyin.
5. Bu değişikliklerin geçerli olması için oturumunuzu kapatıp yeniden oturum açmanız gerekmektedir.

Kullanıcıları belirli gruplara eklemek için Yönetici komut istemindeki komutu da kullanabilirsiniz.

net localgroup docker-users DOMAIN\username /add

PowerShell'de Add-LocalGroupMember işlevini kullanın.

Yetersiz disk alanı

Docker varsayılan olarak görüntüleri genellikle C:\ProgramData\Docker\ sistem sürücüsünde bulunan %ProgramData%/Docker/ klasöründe depolar. Görüntülerin sistem sürücüsünde değerli yer kaplamasını önlemek için görüntü klasörünün konumunu değiştirebilirsiniz. Konumu değiştirmek için:

1. Görev çubuğunda Docker simgesine sağ tıklayın ve Ayarlar'ı seçin.

2. Docker Engine'i seçin.

3. Düzenleme bölmesinde, Docker görüntüleri için istediğiniz konumun değerini içeren özellik ayarını ekleyin :

      "graph": "D:\\mypath\\images"
   

   Docker Dosya Paylaşımı'nın ekran görüntüsü.

4. Uygula ve Yeniden Başlat'ı seçin. Bu adımlar %ProgramData%\docker\config\daemon.json konumundaki yapılandırma dosyasını değiştirir. Önceden oluşturulmuş görüntüler taşınmaz.

Kapsayıcı türü uyuşmazlığı

Bir projeye Docker desteği eklediğinizde, bir Windows veya Linux kapsayıcısı seçersiniz. Docker Server konağı proje hedefiyle aynı kapsayıcı türünü çalıştıracak şekilde yapılandırılmamışsa şuna benzer bir hata görürsünüz:

Docker Konağı ve Proje Uyuşmazlığı'nın ekran görüntüsü.

Bu sorunu çözmek için Sistem Tepsisi'nde Windows için Docker simgesine sağ tıklayın ve Switch to Windows container... öğesini seçin. veya Linux kapsayıcılarına geçiş yapın... .

ContainerToolsPackage veya DockerComposePackage düzgün yüklenmedi

Bozuk bir Yönetilen Genişletilebilirlik Çerçevesi (MEF) önbelleği bu soruna neden olabilir. Düzeltmek için Visual Studio örneğinizin ComponentModelCache klasörünü silin.

1. Visual Studio tüm örneklerini kapatın.

2. ComponentModelCache klasörünü silmek için aşağıdaki PowerShell komutunu çalıştırın:

   Get-ChildItem -Path "$(Join-Path $Env:LOCALAPPDATA "Microsoft\VisualStudio")" -Recurse -Include "ComponentModelCache" | Remove-Folder
   

Klasörü el ile de silebilirsiniz:

1. Dosya Gezgini'nde \Microsoft\VisualStudio%localappdata% açın.
2. Visual Studio sürümünüze karşılık gelen alt klasörü açın (örneğin, 18.0_b653d53f).
3. ComponentModelCache klasörünü silin.

Diğer sorunlar

Karşılaştığınız diğer sorunlar için bkz. Microsoft/DockerTools.

Referanslar

• Kapsayıcı Araçları hata iletileri