Debugowanie usługi w chmurze platformy Azure w programie Visual Studio

Program Visual Studio oferuje różne opcje debugowania usług Azure Cloud Services i maszyn wirtualnych.

Wymagania wstępne

• Konto Azure. Jeśli nie masz konta platformy Azure, aktywuj korzyści platformy Azure dla subskrybentów programu Visual Studio lub zarejestruj się w celu uzyskania bezpłatnej wersji próbnej.

Debugowanie usługi w chmurze na komputerze lokalnym

Możesz zaoszczędzić czas i pieniądze przy użyciu emulatora usługi Azure Compute w celu debugowania usługi w chmurze na komputerze lokalnym. Debugując usługę lokalnie przed jej wdrożeniem, można zwiększyć niezawodność i wydajność bez płacenia za czas obliczeniowy. Jednak niektóre błędy mogą wystąpić tylko wtedy, gdy uruchamiasz usługę w chmurze na platformie Azure. Te błędy można debugować, jeśli włączysz debugowanie zdalne podczas publikowania usługi, a następnie dołącz debuger do wystąpienia roli.

Emulator symuluje usługę Azure Compute i działa w środowisku lokalnym, aby można było przetestować i debugować usługę w chmurze przed jej wdrożeniem. Emulator obsługuje cykl życia wystąpień ról i zapewnia dostęp do symulowanych zasobów, takich jak magazyn lokalny. Podczas debugowania lub uruchamiania usługi z poziomu programu Visual Studio automatycznie uruchamia emulator jako aplikację w tle, a następnie wdraża usługę w emulatorze. Możesz użyć emulatora, aby wyświetlić usługę podczas jej uruchamiania w środowisku lokalnym. Możesz uruchomić pełną wersję lub wersję ekspresową emulatora. Zobacz Używanie emulatora Express do uruchamiania i debugowania usługi w chmurze lokalnie.

Aby debugować usługę w chmurze na komputerze lokalnym

1. Na pasku menu wybierz pozycję Debuguj>rozpocznij debugowanie, aby uruchomić projekt usługi w chmurze platformy Azure. Alternatywnie można nacisnąć klawisz F5. Zostanie wyświetlony komunikat informujący o uruchomieniu emulatora obliczeń. Po uruchomieniu emulatora ikona paska zadań systemu potwierdza to.

   

2. Wyświetl interfejs użytkownika emulatora obliczeniowego, otwierając menu skrótów dla ikony platformy Azure w obszarze powiadomień, a następnie wybierz pozycję Pokaż interfejs użytkownika emulatora obliczeniowego.

   W lewym okienku interfejsu użytkownika są wyświetlane usługi, które są obecnie wdrażane w emulatorze obliczeniowym i wystąpieniach ról, które są uruchomione dla każdej usługi. Możesz wybrać usługę lub role do wyświetlania cyklu życia, rejestrowania i informacji diagnostycznych w okienku po prawej stronie. Jeśli fokus zostanie umieszczony na górnym marginesie dołączonego okna, zostanie on rozbudowany, aby wypełnić okienko po prawej stronie.

3. Przejrzyj aplikację, wybierając polecenia w menu Debugowanie i ustawiając punkty przerwania w kodzie. Podczas przechodzenia przez aplikację w debugerze okienka są aktualizowane przy użyciu bieżącego stanu aplikacji. Po zatrzymaniu debugowania wdrożenie aplikacji zostanie usunięte. Jeśli aplikacja zawiera rolę internetową i ustawiono właściwość Akcja uruchamiania, aby uruchomić przeglądarkę internetową, program Visual Studio uruchamia aplikację internetową w przeglądarce. Jeśli zmienisz liczbę wystąpień roli w konfiguracji usługi, musisz zatrzymać usługę w chmurze, a następnie ponownie uruchomić debugowanie, aby można było debugować te nowe wystąpienia roli.

   Uwaga

   Po zatrzymaniu działania lub debugowaniu usługi lokalny emulator obliczeniowy i emulator magazynu nie są zatrzymywane. Należy je jawnie zatrzymać w obszarze powiadomień.

Debugowanie usługi w chmurze na platformie Azure

Jeśli włączysz zdalne debugowanie dla usługi w chmurze przy użyciu procedury opisanej w tej sekcji, nie będzie to miało obniżonej wydajności ani nie spowoduje naliczania dodatkowych opłat. Nie używaj zdalnego debugowania w usłudze produkcyjnej, ponieważ klienci korzystający z usługi mogą mieć negatywny wpływ.

Uwaga

Podczas publikowania usługi w chmurze z poziomu programu Visual Studio można włączyć funkcję IntelliTrace dla wszystkich ról w tej usłudze przeznaczonych dla programu .NET Framework 4 lub .NET Framework 4.x. Za pomocą funkcji IntelliTrace można zbadać zdarzenia, które wystąpiły w wystąpieniu roli w przeszłości i odtworzyć kontekst od tego czasu. Zobacz Debugowanie opublikowanej usługi w chmurze za pomocą narzędzi IntelliTrace i Visual Studio oraz Używanie funkcji IntelliTrace.

Aby włączyć zdalne debugowanie dla usługi w chmurze (rozszerzona obsługa)

1. Dodaj punkt końcowy do pliku ServiceDefinition.csdef dla domyślnego portu msvsmon. W przypadku programu Visual Studio 2022 to 4026; Dla programu Visual Studio 2019 jest to wersja 4024.

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   Uwaga

   Inne wersje programu Visual Studio mają różne porty Przypisania portów zdalnego debugera.

2. Jeśli używasz platformy .NET 4.8, otwórz plik ServiceConfiguration.Cloud.cscfg i sprawdź wartość atrybutu osFamily w elememencie ServiceConfiguration podczas publikowania usług Cloud Services (rozszerzona obsługa). W przypadku projektu .NET 4.8 użyj polecenia osFamily="7".

3. Otwórz menu skrótów dla projektu platformy Azure, a następnie wybierz pozycję Publikuj.

4. Wybierz środowisko przejściowe i konfigurację debugowania.

   Jest to tylko wytyczne. Możesz zdecydować się na uruchamianie środowisk testowych w środowisku produkcyjnym. Jednak w przypadku włączenia zdalnego debugowania w środowisku produkcyjnym może mieć negatywny wpływ na użytkowników. Możesz wybrać konfigurację wydania, ale konfiguracja debugowania ułatwia debugowanie.

   

5. Wykonaj typowe kroki opisane w temacie Cloud Services (rozszerzona obsługa), ale zaznacz pole wyboru Włącz pulpit zdalny dla wszystkich ról .

   Zostanie wyświetlony monit o utworzenie nazwy użytkownika pulpitu zdalnego i hasła, które będzie potrzebne później do zalogowania się do tej maszyny wirtualnej.

6. Przejdź do następnego ekranu, przejrzyj ustawienia, a gdy wszystko będzie gotowe, kliknij pozycję Publikuj i poczekaj na zakończenie wdrożenia.

7. Zaloguj się do witryny Azure Portal i przejdź do usługi w chmurze (rozszerzona pomoc techniczna), którą chcesz debugować.

8. Wybierz pozycję Role i wystąpienia w okienku po lewej stronie, a następnie wybierz rolę, którą chcesz zdalnie debugować.

9. Kliknij Połączenie w oknie podręcznym Wystąpienie roli po prawej stronie i wybierz przycisk Połączenie, aby pobrać plik pulpitu zdalnego, który umożliwi zalogowanie się do maszyny wirtualnej. Zaloguj się przy użyciu poświadczeń utworzonych podczas włączania pulpitu zdalnego w poprzednim kroku.

   

10. Na zdalnej maszynie wirtualnej platformy Azure zainstaluj narzędzia zdalne programu Visual Studio 2022 zgodnie z opisem w temacie Debugowanie zdalne.

11. Na pulpicie na maszynie wirtualnej wykonaj polecenie D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe. Pamiętaj, aby uruchomić polecenie jako Administracja istrator.

12. Zaakceptuj monity o zezwolenie na dostęp za pośrednictwem zapory. Powinien zostać wyświetlony komunikat informujący, że msvsmon.exe zaczęła nasłuchiwać połączeń.

    

13. W witrynie Azure Portal otwórz grupę zasobów i uzyskaj publiczny adres IP dla usługi w chmurze (rozszerzona pomoc techniczna).

    

Aby dołączyć debuger do usługi w chmurze (wsparcie dodatkowe) na platformie Azure

Uwaga

Jeśli to możliwe, należy debugować przy użyciu konfiguracji debugowania wybranej w procesie publikowania, ale jeśli debugujesz konfigurację wydania, w programie Visual Studio użyj klawiszy Ctrl+Q, aby wyszukać frazę "Just My Code" i usunąć zaznaczenie pola wyboru Włącz tylko mój kod w obszarze Narzędzia>Opcje>Ogólne debugera.> Kompilacje wydania są zoptymalizowane i w związku z tym nie są traktowane jako "Mój kod".

1. Wybierz pozycję Debuguj>dołączanie do procesu (lub naciśnij klawisze Ctrl+Alt+P).

2. Zachowaj typ połączenia na wartość Domyślna.

3. Wprowadź element docelowy połączenia przy użyciu adresu IP i portu: {ipaddress}:4026.

4. Ustaw opcję Dołącz do na wartość Automatyczna.

5. Zaloguj się przy użyciu tych samych poświadczeń co użytkownik pulpitu zdalnego.

6. Wybierz pozycję Pokaż proces dla wszystkich użytkowników. Jeśli debugujesz rolę procesu roboczego, dołącz ją do WaWorkerHost.exe. Jeśli debugujesz rolę internetową, dołącz ją do procesu w3wp.exe; w przypadku roli internetowego interfejsu API WaIISHost.exe.

7. Ustaw punkty przerwania (przejdź do wiersza i naciśnij klawisz F9), uzyskaj dostęp do publicznego adresu URL witryny i odtwórz scenariusz w celu debugowania.

Ograniczenia debugowania zdalnego na platformie Azure

Debugowanie zdalne ma następujące ograniczenia:

• Po włączeniu zdalnego debugowania nie można opublikować usługi w chmurze, w której każda rola ma więcej niż 25 wystąpień.

• Debuger używa portów od 30400 do 30424, od 31400 do 31424 i 32400 do 32424. Jeśli spróbujesz użyć dowolnego z tych portów, nie będzie można opublikować usługi, a jeden z następujących komunikatów o błędach pojawi się w dzienniku aktywności platformy Azure:

  • Błąd podczas sprawdzania poprawności pliku cscfg względem pliku csdef. Zakres zarezerwowanych portów "zakres" dla punktu końcowego Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector roli "rola" pokrywa się z już zdefiniowanym portem lub zakresem.
  • Alokacja nie powiodła się. Spróbuj ponownie później, spróbuj zmniejszyć rozmiar maszyny wirtualnej lub liczbę wystąpień roli lub spróbować wdrożyć je w innym regionie.

Debugowanie usługi aplikacja systemu Azure

Programy uruchamiane w usłudze aplikacja systemu Azure można debugować przy użyciu okna dialogowego Dołączanie do procesu w programie Visual Studio.

Uwaga

Jest to dostępne tylko dla usługi aplikacja systemu Azure, począwszy od programu Visual Studio 2022 17.1.

Aby debugować usługę aplikacja systemu Azure systemu Windows

1. W obszarze Debugowanie wybierz pozycję Dołącz do procesu.

2. Zmień typPołączenie na Microsoft aplikacja systemu Azure Services, a następnie wybierz pozycję Find...

3. W wyświetlonym oknie dialogowym wybierz nazwę subskrypcji.

   

   Uwaga

   Musisz zalogować się do konta Microsoft z dostępem do subskrypcji zawierającej usługę aplikacja systemu Azure.

4. Filtruj widok według grupy zasobów lub typu zasobu albo wyszukaj według nazwy.

5. Następnie wybierz usługę App Service, którą chcesz debugować, a następnie wybierz przycisk OK.

   Umożliwia to zdalne debugowanie w usłudze App Service i przedstawia listę dostępnych procesów do dołączenia.

   

6. Wybierz proces, do którego chcesz dołączyć, a następnie wybierz pozycję Dołącz , aby rozpocząć debugowanie.

Powiązana zawartość

• Użyj funkcji IntelliTrace , aby zebrać dziennik wywołań i zdarzeń z serwera wydania. Zobacz Debugowanie opublikowanej usługi w chmurze przy użyciu technologii IntelliTrace i Visual Studio.

• Użyj Diagnostyka Azure, aby rejestrować szczegółowe informacje z kodu działającego w ramach ról, niezależnie od tego, czy role są uruchomione w środowisku deweloperów, czy na platformie Azure. Zobacz Zbieranie danych rejestrowania przy użyciu Diagnostyka Azure.

• Aby zapoznać się z innymi scenariuszami zdalnego debugowania, zobacz Debugowanie zdalne.