Debuggen eines Azure-Clouddiensts in Visual Studio

Visual Studio bietet verschiedene Optionen für das Debuggen von Azure Cloud Services und virtuellen Computern.

Voraussetzungen

• Ein Azure-Konto. Wenn Sie nicht über ein Azure-Konto verfügen, aktivieren Sie Ihre Azure-Nutzen für Visual Studio-Abonnenten oder registrieren Sie sich für eine kostenlose Testversion.

Debuggen des Clouddiensts auf dem lokalen Computer

Sie können Zeit und Geld sparen, wenn Sie den Azure Compute-Emulator verwenden, um Ihren Clouddienst auf einem lokalen Computer zu debuggen. Durch lokales Debuggen eines Diensts vor der Bereitstellung können Sie die Zuverlässigkeit und Leistung verbessern, ohne für die Computezeit bezahlen zu müssen. Allerdings können einige Fehler nur auftreten, wenn Sie einen Clouddienst in Azure selbst ausführen. Sie können diese Fehler debuggen, wenn Sie Remotedebuggen beim Veröffentlichen Ihres Diensts aktivieren und dann den Debugger zu einer Rolleninstanz hinzufügen.

Der Emulator simuliert den Azure-Computedienst und wird in Ihrer lokalen Umgebung ausgeführt, sodass Sie den Clouddienst vor der Bereitstellung testen und debuggen können. Der Emulator behandelt den Lebenszyklus der Rolleninstanzen und bietet Zugriff auf simulierte Ressourcen wie lokalen Speicher. Beim Debuggen oder Ausführen des Diensts in Visual Studio wird der Emulator automatisch als Hintergrundanwendung gestartet und dann der Dienst für den Emulator bereitgestellt. Mit dem Emulator können Sie Ihren Dienst anzeigen, wenn er in der lokalen Umgebung ausgeführt wird. Sie können die vollständige Version oder die Express-Version des Emulators ausführen. Weitere Informationen finden Sie unter Verwenden von Emulator Express zum lokalen Ausführen und Debuggen eines Clouddiensts.

So debuggen Sie den Clouddienst auf dem lokalen Computer

1. Wählen Sie auf der Menüleiste Debuggen>Debuggen starten aus, um das Azure-Clouddienstprojekt auszuführen. Alternativ können Sie F5 drücken. Eine Meldung wird angezeigt, dass der Serveremulator gestartet wurde. Wenn der Emulator gestartet wird, wird dies durch das Taskleistensymbol bestätigt.

   

2. Zeigen Sie die Benutzeroberfläche des Serveremulators an, indem Sie im Infobereich das Kontextmenü für das Azure-Symbol öffnen und dann auf Benutzeroberfläche des Serveremulators anzeigenklicken.

   Im linken Bereich der Benutzeroberfläche werden die Dienste angezeigt, die zurzeit im Serveremulator bereitgestellt sind, sowie die Rolleninstanzen, die in jedem Dienst ausgeführt werden. Sie können den Dienst oder die Rollen auswählen, um Lebenszyklus-, Protokollierungs- und Diagnoseinformationen im rechten Bereich anzuzeigen. Wenn Sie den Fokus in den oberen Rand eines enthaltenen Fensters setzen, wird es erweitert und füllt den rechten Bereich aus.

3. Durchlaufen Sie Ihre Anwendung schrittweise, indem Sie auf die Befehle im Menü Debuggen klicken und Breakpoints in Ihrem Code setzen. Wenn Sie die Anwendung im Debugger schrittweise durchlaufen, werden die Bereiche mit dem aktuellen Status der Anwendung aktualisiert. Wenn Sie das Debuggen beenden, wird die Anwendungsbereitstellung gelöscht. Wenn Ihre Anwendung eine Webrolle umfasst und Sie als Startaktion das Starten des Webbrowsers festgelegt haben, startet Visual Studio Ihre Webanwendung im Browser. Wenn Sie die Anzahl der Instanzen einer Rolle in der Dienstkonfiguration ändern, müssen Sie den Clouddienst beenden und dann das Debuggen neu starten, damit Sie diese neuen Instanzen der Rolle debuggen können.

   Hinweis

   Wenn Sie das Ausführen oder Debuggen des Diensts beenden, werden der lokale Serveremulator und der Speicheremulator nicht beendet. Sie müssen explizit über den Infobereich beendet werden.

Debuggen eines Clouddiensts in Azure

Wenn Sie das Remotedebuggen für einen Clouddienst mit dem Verfahren in diesem Abschnitt aktivieren, führt dies nicht zu einer Leistungsverschlechterung oder zu zusätzlichen Gebühren. Verwenden Sie das Remotedebuggen nicht für einen Produktionsdienst, da sich dies negativ auf Clients auswirken kann, die den Dienst nutzen.

Hinweis

Wenn Sie einen Clouddienst über Visual Studio veröffentlichen, können Sie IntelliTrace für alle Rollen in diesem Dienst aktivieren, die für .NET Framework 4 oder .NET Framework 4.x ausgelegt sind. Mit IntelliTracekönnen Sie Ereignisse untersuchen, die in einer Rolleninstanz in der Vergangenheit aufgetreten sind, und den Kontext zum jeweiligen Zeitpunkt reproduzieren. Weitere Informationen finden Sie unter Debuggen eines veröffentlichten Clouddiensts mit IntelliTrace und Visual Studio und Verwenden von IntelliTrace.

So aktivieren Sie das Remotedebuggen für einen Clouddienst (erweiterter Support)

1. Fügen Sie einen Endpunkt zu ServiceDefinition.csdef für den msvsmon-Standardport hinzu. Für Visual Studio 2022 ist das 4026; für Visual Studio 2019 ist es 4024.

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

   Hinweis

   Andere Versionen von Visual Studio weisen unterschiedliche Ports auf (Remotedebugger-Portzuweisungen).

2. Wenn Sie mit .NET 4.8 arbeiten, öffnen Sie unbedingt die ServiceConfiguration.Cloud.cscfg-Datei, und überprüfen Sie den Wert des Attributs osFamily für das ServiceConfiguration-Element beim Veröffentlichen von Cloud Services (erweiterter Support). Verwenden Sie für ein .NET 4.8-Projekt osFamily="7".

3. Öffnen Sie das Kontextmenü des Azure-Projekts, und klicken Sie auf Veröffentlichen.

4. Wählen Sie die Stagingumgebung und die Debugkonfiguration aus.

   Dies ist nur eine Empfehlung. Sie können auch Testumgebungen in einer Produktionsumgebung ausführen. Es kann jedoch möglicherweise negative Auswirkungen auf die Benutzer haben, wenn Sie das Remotedebuggen für die Produktionsumgebung aktivieren. Sie können die Releasekonfiguration auswählen, aber die Debugkonfiguration vereinfacht das Debuggen.

   

5. Führen Sie die gängigen Schritte aus, die unter Cloud Services (erweiterter Support) beschrieben werden. Aktivieren Sie jedoch das Kontrollkästchen Remotedesktop für alle Rollen aktivieren.

   Sie werden aufgefordert, einen Benutzernamen und ein Kennwort für den Remotedesktopbenutzer zu erstellen, den Sie später für die Anmeldung bei diesem virtuellen Computer benötigen.

6. Wechseln Sie zum nächsten Bildschirm, überprüfen Sie Ihre Einstellungen, und klicken Sie auf Veröffentlichen. Warten Sie, bis die Bereitstellung abgeschlossen ist.

7. Melden Sie sich beim Azure-Portal an, und navigieren Sie zum Clouddienst (erweiterter Support), den Sie debuggen möchten.

8. Wählen Sie im linken Bereich Rollen und Instanzen und dann die Rolle aus, die Sie remote debuggen möchten.

9. Klicken Sie im Popup Rolleninstanz rechts auf Verbinden, und wählen Sie die Schaltfläche Verbinden aus, um eine Remotedesktopdatei herunterzuladen, mit der Sie sich beim virtuellen Computer anmelden können. Melden Sie sich mit den Anmeldeinformationen an, die Sie beim Aktivieren des Remotedesktops in einem vorherigen Schritt erstellt haben.

   

10. Installieren Sie auf dem virtuellen Remotecomputer von Azure die Visual Studio 2022-Remotetools, wie unter Remotedebugging beschrieben.

11. Führen Sie auf dem Desktop auf dem virtuellen Computer den Befehl D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe aus. Stellen Sie sicher, dass Sie ihn als Administrator ausführen.

12. Nehmen Sie Eingabeaufforderungen an, um den Zugriff über die Firewall zuzulassen. Es sollte eine Meldung angezeigt werden, die angibt, dass msvsmon.exe mit dem Lauschen auf Verbindungen begonnen hat.

    

13. Öffnen Sie im Azure-Portal die Ressourcengruppe und rufen Sie die öffentliche IP-Adresse für den Cloud-Dienst ab (erweiterte Unterstützung).

    

So fügen Sie den Debugger an einen Clouddienst (erweiterter Support) in Azure an

Hinweis

Wenn möglich, sollten Sie mit der beim Veröffentlichungsprozess ausgewählten Debugkonfiguration debuggen. Wenn Sie jedoch eine Releasekonfiguration debuggen, verwenden Sie in Visual Studio STRG+Q, um nach „Nur eigenen Code“ zu suchen, und deaktivieren Sie Nur meinen Code aktivieren unter Extras>Optionen>Debugger>Allgemein. Releasebuilds sind optimiert und gelten daher nicht als „eigener Code“.

1. Wählen Sie Debuggen>An Prozess anhängen aus (oder drücken Sie Strg+Alt+P).

2. Behalten Sie den Verbindungstyp Standard bei.

3. Geben Sie das Verbindungsziel mit Ihrer IP-Adresse und Ihrem Port ein: {ipaddress}:4026.

4. Legen Sie Anfügen an auf Automatisch fest.

5. Melden Sie sich mit denselben Anmeldeinformationen wie der Remotedesktopbenutzer an.

6. Wählen Sie Prozess für alle Benutzer anzeigen aus. Wenn Sie eine Workerrolle debuggen, fügen Sie WaWorkerHost.exe an. Wenn Sie eine Webrolle debuggen, fügen Sie den w3wp.exe-Prozess an. Für eine Web-API-Rolle sollte WaIISHost.exe verwendet werden.

7. Legen Sie Breakpoints fest (navigieren Sie zur Zeile, und drücken Sie F9), greifen Sie auf die öffentliche URL der Website zu, und reproduzieren Sie das zu debuggende Szenario.

Einschränkungen beim Remotedebuggen in Azure

Das Remotedebugging hat die folgenden Einschränkungen:

• Wenn das Remotedebuggen aktiviert ist, können Sie keinen Clouddienst veröffentlichen, in dem eine Rolle mehr als 25 Instanzen aufweist.

• Der Debugger verwendet die Ports 30400 bis 30424, 31400 bis 31424 und 32400 bis 32424. Wenn Sie versuchen, diese Ports zu verwenden, können Sie Ihren Dienst nicht veröffentlichen, und eine der folgenden Fehlermeldungen wird im Aktivitätsprotokoll für Azure angezeigt:

  • Fehler beim Überprüfen der CSCFG-Datei anhand der CSDEF-Datei. Der reservierte Portbereich 'range' für den Endpunkt Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector der Rolle 'role' überschneidet sich mit einem bereits definierten Port oder Bereich.
  • Fehler bei der Zuordnung. Wiederholen Sie den Vorgang später. Reduzieren Sie die VM-Größe oder die Anzahl der Rolleninstanzen, oder stellen Sie die VM in einer anderen Region bereit.

Debuggen von Azure App Service

Sie können Programme debuggen, die in Azure App Services ausgeführt werden, indem Sie das Dialogfeld „An Prozess anhängen“ in Visual Studio verwenden.

Hinweis

Dies ist nur für Microsoft Azure App Service ab Visual Studio 2022 (17.1) verfügbar.

So debuggen Sie eine Microsoft Azure App Service-Instanz

1. Wählen Sie unter DebuggenAn Prozess anhängen aus.

2. Ändern Sie Verbindungstyp in Microsoft Azure App Services, und wählen Sie dann Suchen... aus.

3. Wählen Sie im daraufhin geöffneten Dialogfeld den Abonnementnamen aus.

   

   Hinweis

   Sie müssen bei einem Microsoft-Konto mit Zugriff auf das Abonnement angemeldet sein, das Ihre Azure App Service-Instanz enthält.

4. Filtern Sie die Ansicht entweder nach Ressourcengruppe oder Ressourcentyp, oder suchen Sie anhand des Namens.

5. Wählen Sie als Nächstes den App Service aus, den Sie debuggen möchten, und wählen Sie dann OK aus.

   Dies ermöglicht das Remotedebugging in Ihrem App Service und zeigt eine Liste der verfügbaren Prozesse an, an die sie angefügt werden können.

   

6. Wählen Sie den Prozess aus, an den Sie anfügen möchten, und wählen Sie dann Anfügen aus, um mit dem Debuggen zu beginnen.

Zugehöriger Inhalt

• Verwenden Sie IntelliTrace, um ein Protokoll der Aufrufe und Ereignisse von einem Releaseserver zu sammeln. Weitere Informationen finden Sie unter Debuggen eines veröffentlichten Clouddiensts mit IntelliTrace und Visual Studio.

• Verwenden Sie die Azure-Diagnose , um ausführliche Informationen zu Code, der in Rollen ausgeführt wird, zu protokollieren, unabhängig davon, ob die Rollen in der Entwicklungsumgebung oder in Azure ausgeführt werden. Weitere Informationen finden Sie unter Sammeln von Protokollierungsdaten mit der Azure-Diagnose.

• Informationen zu anderen Remotedebugszenarios finden Sie unter Remotedebuggen.