Debugowanie usługi Azure Cloud Services (wsparcie dodatkowe) w programie Visual Studio

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

Wymagania wstępne

• Program Visual Studio (zobacz [Pliki do pobrania programu Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) z zainstalowanym pakietem roboczym Programowanie na platformie Azure oraz zainstalowanym projektem i szablonami elementów programu .NET Framework dla poszczególnych składników. Zobacz Modyfikowanie programu Visual Studio.
• 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ług Azure Cloud Services (rozszerzona pomoc techniczna). Alternatywnie można nacisnąć 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.

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 przycisk Połącz w oknie podręcznym Wystąpienie roli po prawej stronie i wybierz przycisk Połącz , 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 msvsmon.exe w folderze instalacyjnym programu Visual Studio w obszarze Common7\IDE\Remote Debugger\x64. Pamiętaj, aby uruchomić polecenie jako administrator.

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 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 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 F9), uzyskaj dostęp do publicznego adresu URL witryny i odtwórz scenariusz w celu debugowania.

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ń typ połączenia 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 Diagnostyka Azure, aby rejestrować szczegółowe informacje z kodu działającego w ramach ról na platformie Azure. Zobacz Zbieranie danych rejestrowania przy użyciu Diagnostyka Azure.

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