Rozwiązywanie problemów z programem Visual Studio przy użyciu 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 kilka typowych kroków rozwiązywania problemów.

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

Udostępnianie plików musi być zarządzane tylko wtedy, gdy używasz funkcji Hyper-V z platformą Docker. Jeśli używasz protokołu WSL 2, poniższe kroki nie są konieczne, a opcja udostępniania plików nie będzie widoczna. Aby rozwiązać ten problem:

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

  2. Wybierz pozycjęUdostępnianie plików zasobów> i udostępnij folder, do który ma być uzyskiwany dostęp. Udostępnianie całego dysku systemowego jest możliwe, ale nie jest zalecane.

    Zrzut ekranu przedstawiający udostępnione dyski.

Porada

Program Visual Studio wyświetla monit, gdy dyski udostępnione nie są skonfigurowane.

Nie można rozpocząć debugowania

Jednym z powodów tego problemu może być posiadanie nieaktualnych składników debugowania w folderze profilu użytkownika. Wykonaj następujące polecenia, aby usunąć te foldery, aby najnowsze składniki debugowania były pobierane podczas 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 usługi Cleanup Container Host Networking, co spowoduje odświeżenie składników związanych z siecią na komputerze hosta.

Odmowa instalacji

W przypadku korzystania z platformy Docker dla systemu macOS może wystąpić błąd odwołujący 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 programie Visual Studio:

Bieżący użytkownik musi znajdować się w grupie "docker-users", aby korzystać z programu Docker Desktop. Dodaj siebie do grupy "docker-users", a następnie wyloguj się z systemu Windows.

Aby mieć uprawnienia do pracy z kontenerami platformy Docker, musisz być członkiem grupy "docker-users". Aby dodać siebie do grupy w Windows 10 lub nowszym, wykonaj następujące kroki:

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

Możesz również użyć polecenia w wierszu net localgroup 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 zazwyczaj znajduje się na dysku systemowym C:\ProgramData\Docker\. Aby zapobiec zajmowaniu przez obrazy cennego miejsca na dysku systemowym, możesz zmienić lokalizację folderu obrazów. W tym celu:

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

  2. Wybierz pozycję Aparat platformy Docker.

  3. W okienku edycji dodaj graph 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 & uruchom ponownie. Te kroki modyfikują plik konfiguracji pod adresem %ProgramData%\docker\config\daemon.json. Wcześniej utworzone obrazy nie są przenoszone.

Niezgodność typu kontenera

Podczas dodawania obsługi platformy Docker do projektu należy wybrać kontener z systemem Windows lub 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 for Windows na pasku systemowym i wybierz pozycję Przełącz do kontenerów systemu Windows... lub Przełącz się do kontenerów systemu Linux....

Inne problemy

Aby uzyskać informacje o innych napotkanych problemach, zobacz Microsoft /DockerTools issues (Problemy z narzędziem Microsoft/DockerTools ).

Informacje