Debuggen eines Azure-Clouddienstprojekts (erweiterter Support) in Visual Studio

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 2019 ist es 4024.

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

   Hinweis

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

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

3. 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.

   

4. 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.

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

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

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

8. 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.

   

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

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

11. 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.

12. Ö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

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}:4024.

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.

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 des virtuellen Computers im Installationsordner von Visual Studio unter Common7\IDE\Remote Debugger\x64 den Befehl 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

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.

So debuggen Sie eine Microsoft Azure App Service-Instanz

1. Wählen Sie unter Debuggen An 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.

Debuggen von Azure Virtual Machines

Sie können Programme debuggen, die auf Azure Virtual Machines ausgeführt werden, indem Sie den Server-Explorer in Visual Studio verwenden. Wenn Sie das Remotedebuggen auf einem virtuellen Computer in Azure aktivieren, installiert Azure die Erweiterung für das Remotedebuggen auf dem virtuellen Computer. Sie können dann den Debugger an Prozesse auf dem virtuellen Computer anfügen und wie gewohnt debuggen.

So debuggen Sie einen virtuellen Computer in Azure

1. Erweitern Sie im Server-Explorer den Knoten "Virtuelle Computer", und wählen Sie den Knoten des virtuellen Computers aus, den Sie debuggen möchten.

2. Öffnen Sie das Kontextmenü, und klicken Sie auf Debuggen aktivieren. Wenn Sie gefragt werden, ob Sie sicher sind, dass Sie das Debuggen auf dem virtuellen Computer aktivieren möchten, klicken Sie auf Ja.

   Azure installiert die Erweiterung für das Remotedebuggen auf dem virtuellen Computer, um das Debuggen zu aktivieren.

   

   

3. Nachdem die Installation der Remotedebugerweiterung abgeschlossen ist, öffnen Sie das Kontextmenü des virtuellen Computers und klicken dann auf Debugger anfügen

   Azure ruft eine Liste der Prozesse auf dem virtuellen Computer ab und zeigt diese im Dialogfeld An den Prozess anhängen an.

   

4. Klicken Sie im Dialogfeld An den Prozess anhängen auf Auswählen, um die Ergebnisliste einzuschränken, sodass nur die Codetypen angezeigt werden, die Sie debuggen möchten. Sie können verwalteten 32- oder 64-Bit-Code und/oder systemeigenen Code debuggen.

   

5. Klicken Sie auf die Prozesse, die Sie auf dem virtuellen Computer debuggen möchten, und anschließend auf Anfügen. Beispielsweise können Sie den Prozess "w3wp.exe" auswählen, wenn Sie eine Web-App auf dem virtuellen Computer debuggen möchten. Weitere Informationen finden Sie unter Debuggen von mindestens einem Prozess in Visual Studio und im Blogbeitrag zur Azure-Rollenarchitektur.

Erstellen eines Webprojekts und eines virtuellen Computers zum Debuggen

Vor dem Veröffentlichen des Azure-Projekts finden Sie es möglicherweise nützlich, es in einer eigenständigen Umgebung zu testen, die Debug- und Testszenarien unterstützt und in der Sie Test- und Überwachungsprogramme installieren können. Eine Möglichkeit zum Ausführen solcher Tests ist das Remotedebuggen Ihrer App auf einem virtuellen Computer.

Visual Studio ASP.NET-Projekte bieten eine Option, einen praktischen virtuellen Computer zu erstellen, den Sie für App-Tests verwenden können. Der virtuelle Computer umfasst häufig genutzte Endpunkte wie z.B. PowerShell, Remotedesktop und WebDeploy.

So erstellen Sie ein Webprojekt und einen virtuellen Computer zum Debuggen

1. Erstellen Sie eine neue ASP.NET-Webanwendung in Visual Studio.

2. Wählen Sie im Dialogfeld „Neues ASP.NET-Projekt“ im Abschnitt „Azure“ im Dropdownlistenfeld Virtueller Computer aus. Lassen Sie das Kontrollkästchen Remoteressourcen erstellen aktiviert. Klicken Sie zum Fortfahren auf OK .

   Das Dialogfeld Virtuellen Computer in Azure erstellen wird angezeigt.

   

   Hinweis

   Sie werden aufgefordert, sich bei Ihrem Azure-Konto anzumelden, wenn Sie noch nicht angemeldet sind.

3. Wählen Sie die verschiedenen Einstellungen für den virtuellen Computer aus, und klicken Sie dann auf OK. Weitere Informationen finden Sie unter Virtuelle Computer .

   Der Name, den Sie als DNS-Namen eingeben, ist der Name des virtuellen Computers.

   

   Azure erstellt den virtuellen Computer und stellt anschließend die Endpunkte wie Remotedesktop und Web Deploy bereit und konfiguriert sie.

4. Nachdem der virtuelle Computer vollständig konfiguriert wurde, wählen Sie im Server-Explorer den Knoten des virtuellen Computers aus.

5. Öffnen Sie das Kontextmenü, und klicken Sie auf Debuggen aktivieren. Wenn Sie gefragt werden, ob Sie sicher sind, dass Sie das Debuggen auf dem virtuellen Computer aktivieren möchten, klicken Sie auf Ja.

   Azure installiert die Erweiterung für das Remotedebuggen auf dem virtuellen Computer, um das Debuggen zu aktivieren.

   

   

6. Veröffentlichen Sie Ihr Projekt, wie unter Gewusst wie: Bereitstellen eines Webanwendungsprojekts mit der One-Click-Veröffentlichung in Visual Studiobeschrieben. Da Sie auf dem virtuellen Computer debuggen möchten, wählen Sie auf der Seite Einstellungen des Assistenten Web veröffentlichen als Konfiguration Debuggen aus. Dadurch wird sichergestellt, dass Codesymbole beim Debuggen verfügbar sind.

   

7. Wählen Sie unter Dateiveröffentlichungsoptionen die Option Zusätzliche Dateien am Ziel entfernen aus, wenn das Projekt zu einem früheren Zeitpunkt bereits bereitgestellt wurde.

8. Nachdem das Projekt veröffentlicht wurde, klicken Sie im Kontextmenü des virtuellen Computers in Server-Explorer auf Debugger anfügen

   Azure ruft eine Liste der Prozesse auf dem virtuellen Computer ab und zeigt diese im Dialogfeld An den Prozess anhängen an.

   

9. Klicken Sie im Dialogfeld An den Prozess anhängen auf Auswählen, um die Ergebnisliste einzuschränken, sodass nur die Codetypen angezeigt werden, die Sie debuggen möchten. Sie können verwalteten 32- oder 64-Bit-Code und/oder systemeigenen Code debuggen.

   

10. Klicken Sie auf die Prozesse, die Sie auf dem virtuellen Computer debuggen möchten, und anschließend auf Anfügen. Beispielsweise können Sie den Prozess "w3wp.exe" auswählen, wenn Sie eine Web-App auf dem virtuellen Computer debuggen möchten. Weitere Informationen finden Sie unter Debugging von mindestens einem Prozess in Visual Studio .