Korzystanie z okna Kontenery
Zawartość kontenerów hostujących aplikację można wyświetlić za pomocą okna Kontenery . Jeśli używasz wiersza polecenia do uruchamiania poleceń platformy Docker w celu wyświetlania i diagnozowania tego, co dzieje się z kontenerami, to okno zapewnia wygodniejszy sposób monitorowania kontenerów bez opuszczania środowiska IDE programu Visual Studio.
Informacje o obrazach kontenerów można również wyświetlić za pomocą okna Kontenery .
Wymagania wstępne
- Docker Desktop
- Program Visual Studio 2019 w wersji 16.4 lub nowszej.
- Docker Desktop
- Visual Studio 2022 lub Visual Studio 2019 w wersji 16.4 lub nowszej.
- W węźle Docker Compose program Visual Studio 2022 w wersji 17.7 lub nowszej i platformy Docker v2, który jest instalowany z programem Docker Desktop i jest domyślnie włączony.
Wyświetlanie informacji o kontenerach
Okno Kontenery zostanie otwarte automatycznie po uruchomieniu konteneryzowanego projektu platformy .NET. Aby wyświetlić kontenery w programie Visual Studio w dowolnym momencie, użyj Ctrl+Q, aby aktywować pole wyszukiwania programu Visual Studio, a następnie wpisz Containers i wybierz pierwszy element. Możesz również otworzyć okno Kontenery z menu głównego. Użyj ścieżki menu Wyświetl>inne kontenery systemu Windows>.
Po lewej stronie zostanie wyświetlona lista kontenerów na komputerze lokalnym. Kontenery skojarzone z rozwiązaniem są wyświetlane w obszarze Kontenery rozwiązań. Po prawej stronie zostanie wyświetlone okienko z kartami Środowisko, Etykiety, Porty, Woluminy, Dzienniki i Pliki.
Napiwek
Możesz łatwo dostosować miejsce, w którym okno narzędzia Kontenery jest zadokowane w programie Visual Studio. Zobacz Dostosowywanie układów okien w programie Visual Studio. Domyślnie okno Kontenery jest zadokowane za pomocą okna Obserwowanie , gdy debuger jest uruchomiony.
Jeśli używasz narzędzi Docker Compose i Visual Studio 2022 w wersji 17.7 lub nowszej, zobaczysz drzewo węzłów dla rozwiązania i jego projektu Docker Compose z węzłem nadrzędnym dla rozwiązania i węzłów podrzędnych dla każdego projektu.
Wyświetlanie zmiennych środowiskowych
Karta Środowisko zawiera zmienne środowiskowe w kontenerze. Dla kontenera aplikacji można ustawić te zmienne na wiele sposobów, na przykład w pliku Dockerfile, w pliku env lub przy użyciu opcji -e podczas uruchamiania kontenera przy użyciu polecenia platformy Docker.
Uwaga
Wszelkie zmiany zmiennych środowiskowych nie są odzwierciedlane w czasie rzeczywistym. Ponadto zmienne środowiskowe na tej karcie są zmiennymi środowiskowymi systemu w kontenerze i nie odzwierciedlają zmiennych środowiskowych użytkownika lokalnie w aplikacji.
Wyświetlanie etykiet
Na karcie Etykiety są wyświetlane etykiety dla kontenera. Etykiety to sposób ustawiania niestandardowych metadanych na obiektach platformy Docker. Niektóre etykiety są ustawiane automatycznie przez program Visual Studio.
Wyświetlanie mapowań portów
Na karcie Porty możesz sprawdzić mapowania portów, które są obowiązujące dla kontenera.
Dobrze znane porty są połączone, więc jeśli na porcie jest dostępna zawartość, możesz kliknąć link, aby otworzyć przeglądarkę.
Wyświetlanie woluminów
Na karcie Woluminy są wyświetlane woluminy (zainstalowane węzły systemu plików) w kontenerze.
Wyświetlanie dzienników
Na karcie Dzienniki są wyświetlane wyniki docker logs polecenia . Domyślnie karta zawiera strumienie stdout i stderr w kontenerze, ale można skonfigurować dane wyjściowe. Aby uzyskać szczegółowe informacje, zobacz Rejestrowanie platformy Docker. Domyślnie karta Dzienniki przesyła strumieniowo dzienniki , ale możesz je wstrzymać, wybierając przycisk Stream na karcie . Jeśli ponownie wybierzesz usługę Stream , przesyłanie strumieniowe zostanie wznowione z miejsca, w którym zostało przerwane.
Aby wyczyścić dzienniki, użyj przycisku Wyczyść na karcie Dzienniki . Aby pobrać wszystkie dzienniki, użyj przycisku Odśwież .
Uwaga
Program Visual Studio automatycznie przekierowuje stdout i stderr do okna Dane wyjściowe po uruchomieniu bez debugowania z kontenerami systemu Windows, więc kontenery systemu Windows uruchomione z programu Visual Studio przy użyciu Ctrl+F5 nie będą wyświetlać dzienników na tej karcie; zamiast tego użyj okna Dane wyjściowe.
Jeśli używasz narzędzia Docker Compose z programem Visual Studio 2022 w wersji 17.7 lub nowszej, możesz wyświetlać dzienniki każdego kontenera oddzielnie lub przeplatać je w jeden strumień wyjściowy. W przypadku wybrania węzła nadrzędnego dla rozwiązania widoczne są przeplatane dzienniki ze wszystkich projektów redagowania. Pierwsza kolumna w każdym wierszu pokazuje kontener, który wygenerował ten wiersz danych wyjściowych. Jeśli chcesz zobaczyć tylko dzienniki dla jednego kontenera, wybierz ten konkretny węzeł projektu.
Wyświetlanie systemu plików
Na karcie Pliki można wyświetlić system plików kontenera, w tym folder aplikacji zawierający projekt.
Aby otworzyć pliki w programie Visual Studio, przejdź do pliku i kliknij go dwukrotnie lub kliknij prawym przyciskiem myszy i wybierz polecenie Otwórz. Program Visual Studio otwiera pliki w trybie tylko do odczytu.
Za pomocą karty Pliki można wyświetlać dzienniki aplikacji, takie jak dzienniki usług Internet Information Services (IIS), pliki konfiguracji i inne pliki zawartości w systemie plików kontenera.
W programie Visual Studio 2022 w wersji 17.7 lub nowszej w przypadku określania wartości docelowej dla platformy .NET 8 lub nowszej USER app plik Dockerfile może zawierać polecenie , które określa uruchamianie aplikacji z normalnymi uprawnieniami użytkownika. Karta Pliki używa również tych uprawnień, a więc może nie być w stanie wyświetlić niektórych folderów, jeśli te foldery są ustawione, aby wymagać podwyższonych uprawnień do wyświetlania.
Uruchamianie, zatrzymywanie i usuwanie kontenerów
Domyślnie w oknie Kontenery są wyświetlane wszystkie kontenery na maszynie zarządzanej przez platformę Docker. Możesz użyć przycisków paska narzędzi, aby uruchomić, zatrzymać lub usunąć (usunąć) kontener, którego nie chcesz już używać. Ta lista jest dynamicznie aktualizowana w miarę tworzenia lub usuwania kontenerów.
Aby na przykład wybrać wiele kontenerów, aby usunąć więcej niż jeden naraz, użyj kombinacji Ctrl+Kliknij. Jeśli spróbujesz uruchomić więcej niż 10 kontenerów, zostanie wyświetlony monit o potwierdzenie tego. W razie potrzeby możesz wyłączyć monit o potwierdzenie.
Otwieranie okna terminalu w uruchomionym kontenerze
Możesz otworzyć okno terminalu (wiersz polecenia lub interaktywną powłokę) w kontenerze przy użyciu przycisku Otwórz okno terminalu w oknie Kontener .
W przypadku kontenerów systemu Windows zostanie otwarty wiersz polecenia systemu Windows. W przypadku kontenerów systemu Linux zostanie otwarte okno przy użyciu powłoki Bash.
Jeśli używasz platformy .NET 8, plik Dockerfile może określić USER app polecenie, co oznacza, że aplikacja działa z normalnymi uprawnieniami użytkownika, a nie z podwyższonym poziomem uprawnień. Plik Dockerfile wygenerowany przez program Visual Studio zawiera ten element w programie Visual Studio 2022 w wersji 17.7 lub nowszej, jeśli jest przeznaczony dla platformy .NET 8 lub nowszej. Terminal zostanie otwarty jako użytkownik określony w pliku Dockerfile (domyślnie dla projektów platformy .NET 8, czyli app), lub jeśli żaden użytkownik nie zostanie określony, zostanie uruchomiony jako root użytkownik.
Zwykle okno terminalu otwiera się poza programem Visual Studio jako osobne okno. Jeśli chcesz zintegrować środowisko wiersza polecenia ze środowiskiem IDE programu Visual Studio jako okno narzędzi z możliwością dokowania, możesz zainstalować terminal Whack Whack.
Dołączanie debugera do procesu
Debuger można dołączyć do procesu uruchomionego w kontenerze przy użyciu przycisku Dołącz do procesu na pasku narzędzi okna Kontenery. Gdy używasz tego przycisku, zostanie wyświetlone okno dialogowe Dołączanie do procesu i wyświetli dostępne procesy uruchomione w kontenerze.
Możesz dołączyć do zarządzanych procesów w kontenerze. Aby wyszukać proces w innym kontenerze, użyj przycisku Znajdź i wybierz inny kontener w oknie dialogowym Wybieranie kontenera platformy Docker.
Wyświetlanie obrazów
Obrazy można również wyświetlać na komputerze lokalnym, korzystając z karty Obrazy w oknie Kontenery . Obrazy pobierane z repozytoriów zewnętrznych są grupowane razem w widoku drzewa.
W oknie znajdują się tylko karty dotyczące obrazów: Etykiety i Szczegóły. Karta Szczegóły zawiera szczegóły konfiguracji obrazu w formacie JSON.
Aby usunąć obraz, kliknij prawym przyciskiem myszy obraz w widoku drzewa i wybierz polecenie Usuń lub wybierz obraz, a następnie użyj przycisku Usuń na pasku narzędzi.
Oczyszczanie kontenerów i obrazów
Możesz łatwo usunąć kontenery i obrazy, których już nie używasz, za pomocą przycisku Przycinanie na pasku narzędzi okna Kontenery .
Zostanie wyświetlony monit o potwierdzenie, że chcesz usunąć wszystkie nieużywane kontenery.
Po wybraniu karty Obrazy przycisk Prune wyświetli pytanie, czy chcesz usunąć wszystkie zwisające obrazy. Zwisające obrazy to obrazy warstw, które nie są już skojarzone z obrazem oznakowanym. Usunięcie ich od czasu do czasu pomaga zaoszczędzić miejsce na dysku.
Opcje konfiguracji
Okna dialogowe potwierdzenia dla różnych zadań, takich jak usuwanie kontenerów i obrazów lub uruchamianie więcej niż 10 kontenerów naraz, mogą być skonfigurowane. Każdy monit można wyłączyć przy użyciu pola wyboru w oknie dialogowym. Możesz również włączyć lub wyłączyć te opcje, korzystając z ustawień w oknie Narzędzia Opcje>>narzędzia Kontenery narzędzi.> Zobacz Konfigurowanie narzędzi kontenera.