Rozwiązywanie problemów z programowaniem Visual Studio za pomocą platformy Docker

Dotyczy: Visual Studio

Podczas pracy z narzędziami Visual Studio Container Tools mogą wystąpić problemy podczas kompilowania lub debugowania aplikacji. W tym artykule przedstawiono niektóre typowe kroki rozwiązywania tych problemów.

Udostępnianie woluminów nie jest włączone. Włącz udostępnianie woluminów w ustawieniach Docker CE dla Windows (tylko kontenery Linux)

Udostępnianie plików należy zarządzać tylko wtedy, gdy używasz Hyper-V z platformą Docker. Jeśli używasz programu WSL 2, nie musisz wykonywać kroków opisanych w tej sekcji, a opcja udostępniania plików nie jest widoczna. Aby rozwiązać ten problem:

1. Kliknij prawym przyciskiem myszy Docker dla Windows w obszarze powiadomień, a następnie wybierz pozycję Settings.

2. Wybierz pozycję ZasobyUdostępnianie plików i udostępnij folder, do którego chcesz uzyskać dostęp. Udostępnianie całego dysku systemowego jest możliwe, ale nie jest zalecane.

   Zrzut ekranu przedstawiający dyski współdzielone.

Wskazówka

Visual Studio powiadamia, gdy dyski Udostępnione nie są skonfigurowane.

Problemy ze ścieżkami w kontenerach Windows

W przypadku używania ścieżek plików specyficznych dla systemu Linux w kontenerze Windows mogą wystąpić różne błędy wejścia lub wyjścia (we/wy). Jeśli zobaczysz te błędy, sprawdź wartość zmiennej środowiskowej . Jeśli zmienna jest ustawiona, Visual Studio próbuje użyć ścieżek Podsystem Windows dla systemu Linux (WSL), aby odwołać się do plików Windows do tworzenia woluminów. Takie podejście jest niezbędne w przypadku platformy Docker w programie WSL, ale nie działa z programem Docker Desktop w Windows. Zawsze odstaw tę zmienną środowiskową, jeśli używasz kontenerów Windows.

Nie można uruchomić debugowania

Jednym z powodów tego problemu są nieaktualne składniki debugowania w folderze profilu użytkownika. Uruchom następujące polecenia, aby usunąć te foldery, aby pobrać najnowsze składniki debugowania w następnej sesji debugowania.

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

Błędy specyficzne dla sieci podczas debugowania aplikacji

Spróbuj wykonać skrypt do pobrania z obszaru Oczyszczanie sieci hosta kontenera, który odświeża składniki związane z siecią na maszynie hosta.

Odmowa montowania

W przypadku korzystania z platformy Docker dla systemu macOS może wystąpić błąd podczas odwoływania się do folderu /usr/local/share/dotnet/sdk/NuGetFallbackFolder. Dodaj folder do karty Udostępnianie plików na platformie Docker.

Grupa użytkowników platformy Docker

Podczas pracy z kontenerami może wystąpić następujący błąd w Visual Studio:

Bieżący użytkownik musi należeć do grupy "użytkownicy platformy Docker", aby używać programu Docker Desktop. Dodaj siebie do grupy "użytkownicy platformy Docker", a następnie wyloguj się z Windows.

Aby móc pracować z kontenerami platformy Docker, musisz być członkiem grupy "użytkownicy platformy Docker". Aby dodać siebie do grupy w Windows 10 lub nowszym, wykonaj następujące kroki:

1. W menu Start otwórz przystawkę Zarządzanie komputerem.
2. Rozwiń pozycję Użytkownicy i grupy lokalne, a następnie wybierz opcję Grupy.
3. Znajdź grupę docker-users , kliknij prawym przyciskiem myszy i wybierz polecenie Dodaj do grupy.
4. Dodaj swoje konto użytkownika lub konta użytkowników.
5. Wyloguj się i zaloguj się ponownie, aby zmiany zaczęły obowiązywać.

Możesz również użyć polecenia w wierszu polecenia administratora, aby dodać użytkowników do określonych grup.

net localgroup docker-users DOMAIN\username /add

W programie PowerShell użyj funkcji Add-LocalGroupMember .

Mała ilość miejsca na dysku

Domyślnie platforma Docker przechowuje obrazy w folderze %ProgramData%/Docker/ , który jest zwykle na dysku systemowym C :\ProgramData\Docker\. Aby zapobiec zajmowaniu cennego miejsca na dysku systemowym, możesz zmienić lokalizację folderu obrazów. Aby zmienić lokalizację:

1. Kliknij prawym przyciskiem myszy ikonę platformy Docker na pasku zadań i wybierz pozycję Ustawienia.

2. Wybierz Docker Engine.

3. W okienku edycji dodaj ustawienie właściwości z wartością żądanej lokalizacji dla obrazów platformy Docker:

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

   Zrzut ekranu przedstawiający udostępnianie plików platformy Docker.

4. Wybierz pozycję Zastosuj i uruchom ponownie. Te kroki modyfikują plik konfiguracji w lokalizacji %ProgramData%\docker\config\daemon.json. Wcześniej utworzone obrazy nie są przenoszone.

Niezgodność typu kontenera

Po dodaniu obsługi platformy Docker do projektu należy wybrać Windows lub kontener systemu Linux. Jeśli host serwera platformy Docker nie jest skonfigurowany do uruchamiania tego samego typu kontenera co obiekt docelowy projektu, zostanie wyświetlony błąd podobny do następującego:

Zrzut ekranu przedstawiający niezgodność hosta platformy Docker i projektu.

Aby rozwiązać ten problem, kliknij prawym przyciskiem myszy ikonę Docker dla Windows w pasku zadań, a następnie wybierz pozycję Przełącz na kontenery Windows... lub Przełącz na kontenery Linux....

ContainerToolsPackage lub DockerComposePackage nie załadował się poprawnie

Uszkodzona pamięć podręczna zarządzanej struktury rozszerzalności (MEF) może spowodować ten problem. Aby rozwiązać ten problem, usuń folder ComponentModelCache dla wystąpienia Visual Studio.

1. Zamknij wszystkie wystąpienia Visual Studio.

2. Uruchom następujące polecenie programu PowerShell, aby usunąć folder ComponentModelCache :

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

Folder można również usunąć ręcznie:

1. Otwórz %localappdata%\Microsoft\VisualStudio w Eksploratorze plików.
2. Otwórz podfolder odpowiadający wersji Visual Studio (na przykład 18.0_b653d53f).
3. Usuń folder ComponentModelCache .

Inne problemy

Aby uzyskać informacje o innych napotkanych problemach, zobacz Microsoft/DockerTools.

Bibliografia

• Komunikaty o błędach narzędzi do kontenerów