Das Containerisieren und Migrieren von ASP.NET-Apps zum Azure App Service

In diesem Artikel erfahren Sie, wie Sie ASP.NET Anwendungen containerisieren und mithilfe des Azure Migrate-App-Containerisierungstools zu Azure App Service migrieren. Für den Containerisierungsprozess ist kein Zugriff auf Ihre Codebasis erforderlich, und vorhandene Anwendungen können leicht containerisiert werden. Das Tool ermittelt anhand des Ausführungsstatus der Anwendungen auf einem Server die Anwendungskomponenten. Anschließend können Sie sie als Containerimage verpacken. Sie können die containerisierte Anwendung dann in Azure App Service bereitstellen.

Vom Anwendungscontainerisierungstool von Azure Migrate wird derzeit Folgendes unterstützt:

• Containerisieren von ASP.NET-Apps und Bereitstellen dieser Apps in Windows-Containern in App Service
• Das Containerisieren von ASP.NET-Apps und das Bereitstellen dieser Apps in Windows-Containern in Azure Kubernetes Service (AKS). Weitere Informationen zu diesem Containerisierungsszenario.
• Containerisieren von Java-Web-Apps unter Apache Tomcat (auf Linux-Servern) und Bereitstellen dieser Apps in Linux-Containern in AKS Weitere Informationen zu diesem Containerisierungsszenario.
• Containerisieren von Java-Web-Apps unter Apache Tomcat (auf Linux-Servern) und Bereitstellen dieser Apps in Linux-Containern in App Service. Weitere Informationen zu diesem Containerisierungsszenario.

Mit dem Anwendungscontainerisierungstool können Sie Folgendes durchführen:

• Ermitteln Ihrer Anwendungskomponenten. Das Tool stellt eine Remoteverbindung mit den Anwendungsservern her, auf denen Ihre ASP.NET-Anwendung ausgeführt wird, und ermittelt die Anwendungskomponenten. Es wird ein Dockerfile erstellt, das Sie zum Erstellen eines Containerimages für die Anwendung verwenden können.
• Erstellen des Containerimages Sie können das Dockerfile untersuchen und basierend auf Ihren Anwendungsanforderungen weiter anpassen. Anschließend können Sie es verwenden, um das Containerimage für Ihre Anwendung zu erstellen. Das Containerimage für die Anwendung wird an eine von Ihnen angegebene Azure-Containerregistrierung gepusht.
• Bereitstellen in Azure App Service. Das Tool generiert dann die Bereitstellungsdateien, die zum Bereitstellen der containerisierten Anwendung in Azure App Service erforderlich sind.

Nicht alle Anwendungen profitieren von einer direkten Umstellung auf Container ohne größere Änderungen an der Architektur. Es gibt aber einige Vorteile der Umstellung vorhandener Apps auf Container ohne Umschreibeaufwand, z. B.:

• Verbesserte Auslastung der Infrastruktur Bei Verwendung von Containern können Ressourcen von mehreren Anwendungen gemeinsam genutzt und auf derselben Infrastruktur gehostet werden. Dadurch können Sie die Infrastruktur konsolidieren und die Auslastung verbessern.
• Vereinfachte Verwaltung Indem Sie Ihre Anwendungen auf modernen verwalteten Plattformen wie AKS und App Service hosten, können Sie Ihre Verwaltungsmethoden vereinfachen. Diese Vereinfachung können Sie erreichen, indem Sie Ihre normalerweise durchgeführten Wartungs- und Verwaltungsvorgänge für Ihre eigene Infrastruktur ganz einstellen oder reduzieren.
• Anwendungsportabilität Aufgrund der zunehmenden Nutzung und Standardisierung von Containerspezifikationsformaten und -plattformen stellt die Anwendungsportabilität keine Herausforderung mehr dar.
• Moderne Verwaltung mit DevOps Die Nutzung von Containern ermöglicht Ihnen die Einführung und Standardisierung moderner Verwaltungs- und Sicherheitsverfahren sowie die Umstellung auf DevOps.

In diesem Tutorial lernen Sie Folgendes:

Voraussetzungen

Bevor Sie mit diesem Tutorial beginnen, sollten Sie zunächst:

Vorbereiten eines Azure-Benutzerkontos

Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Nachdem Ihr Abonnement eingerichtet wurde, benötigen Sie ein Azure-Benutzerkonto mit den folgenden Berechtigungen:

• Besitzerberechtigungen für das Azure-Abonnement
• Berechtigungen zum Registrieren von Microsoft Entra-Apps.

Wenn Sie gerade erst ein kostenloses Azure-Konto erstellt haben, sind Sie der Besitzer Ihres Abonnements. Wenn Sie nicht der Besitzer des Abonnements sind, müssen Sie mit dem Besitzer zusammenarbeiten, um die Berechtigungen wie folgt zuzuweisen:

1. Suchen Sie im Azure-Portal nach "Abonnements". Wählen Sie unter "Dienste" die Option "Abonnements" aus:

   

2. Wählen Sie auf der Seite "Abonnements " das Abonnement aus, in dem Sie ein Azure Migrate-Projekt erstellen möchten.

3. Wählen Sie im Abonnement im linken Bereich access control (IAM) aus.

4. Suchen Sie auf der Registerkarte "Zugriff überprüfen " nach dem entsprechenden Benutzerkonto.

5. Wählen Sie unter "Rollenzuweisung hinzufügen" die Option "Hinzufügen" aus:

   

6. Wählen Sie auf der Seite " Rollenzuweisung hinzufügen " die Rolle " Besitzer " und dann das Konto aus (azmigrateuser in unserem Beispiel). Wählen Sie dann "Speichern" aus.

   

   Ihr Azure-Konto benötigt auch Berechtigungen zum Registrieren von Microsoft Entra-Apps.

7. Wechseln Sie im Azure-Portal zu Microsoft Entra-ID>, Benutzer> und Benutzereinstellungen.

8. Überprüfen Sie in den Benutzereinstellungen, ob Microsoft Entra-Benutzer Anwendungen registrieren können. (Diese Option ist standardmäßig auf "Ja " festgelegt.)

   

   Wichtig

   Microsoft empfiehlt, Rollen mit den geringsten Berechtigungen zu verwenden. Dies trägt zur Verbesserung der Sicherheit Ihrer Organisation bei. „Globaler Administrator“ ist eine Rolle mit umfangreichen Berechtigungen, die auf Notfallszenarios beschränkt sein sollte, in denen Sie keine vorhandene Rolle verwenden können.

9. Wenn die Option "App-Registrierungen" auf "Nein" festgelegt ist, bitten Sie den Mandanten-/globalen Administrator, die erforderliche Berechtigung zuzuweisen. Alternativ kann der Mandantenadministrator bzw. globale Administrator einem Konto die Rolle „Anwendungsentwickler“ zuweisen, um die Registrierung von Microsoft Entra-Apps zu ermöglichen. Weitere Informationen finden Sie unter Zuweisen von Rollen zu Benutzern.

Herunterladen und Installieren des Anwendungscontainerisierungstools von Azure Migrate

1. Laden Sie das Installationsprogramm für die Azure Migrate-App-Containerisierung auf einem Windows-Computer herunter.

2. Öffnen Sie PowerShell im Administratormodus, und ändern Sie das PowerShell-Verzeichnis in den Ordner, der das Installationsprogramm enthält.

3. Führen Sie das Installationsskript mit dem folgenden Befehl aus:

   .\AppContainerizationInstaller.ps1
   

Öffnen des Anwendungscontainerisierungstools

1. Öffnen Sie einen Browser auf einem beliebigen Computer, von dem aus eine Verbindung mit dem Windows-Computer hergestellt werden kann, auf dem das Anwendungscontainerisierungstool ausgeführt wird. Wechseln Sie zur Tool-URL: https:// Maschinenname oder IP-Adresse: 44369.

   Alternativ können Sie die App über Ihren Desktop öffnen, indem Sie die entsprechende Verknüpfung verwenden.

2. Wenn eine Warnung angezeigt wird, dass Ihre Verbindung nicht privat ist, wählen Sie "Erweitert" aus, und fahren Sie mit der Website fort. Diese Warnung wird angezeigt, weil für die Webschnittstelle ein selbstsigniertes TLS/SSL-Zertifikat genutzt wird.

3. Verwenden Sie auf dem Anmeldebildschirm das lokale Administratorkonto des Computers, um sich anzumelden.

4. Wählen Sie ASP.NET Web-Apps als Typ der Anwendung aus, die Sie containern möchten.

5. Wählen Sie in der Ziel-Azure-DienstlisteContainer in Azure App Service aus:

   

Ausführen der erforderlichen Vorbereitungsschritte für das Tool

1. Akzeptieren Sie die Lizenzbedingungen und lesen Sie die Drittanbieterinformationen.
2. Führen Sie die folgenden Schritte in der Tool-Web-App "Voraussetzungen einrichten" aus:

   • Konnektivität. Das Tool überprüft, ob der Windows-Computer über Internetzugriff verfügt. Falls der Computer einen Proxy verwendet:

     1. Wählen Sie "Proxy einrichten" aus, um die Proxyadresse (in Form von IP-Adresse oder FQDN) und den Port anzugeben.

     2. Geben Sie die Anmeldeinformationen an, wenn der Proxy eine Authentifizierung erfordert.

     3. Wenn Sie Proxydetails hinzugefügt oder die Proxy- oder Authentifizierung deaktiviert haben, wählen Sie "Speichern " aus, um die Verbindungsüberprüfung erneut auszulösen.

     Es werden nur HTTP-Proxys unterstützt.

   • Installieren Sie die Updates. Das Tool sucht automatisch nach den neuesten Updates und installiert sie. Sie können auch die neueste Version des Tools manuell installieren.

   • Installation des Tools Microsoft Web Deploy Das Tool überprüft, ob das Microsoft-Webbereitstellungstool auf dem Windows-Computer installiert ist, auf dem das Anwendungscontainerisierungstool von Azure Migrate ausgeführt wird.

   • Aktivierung von PowerShell-Remoting. Sie erhalten im Tool eine Aufforderung, Folgendes sicherzustellen: PowerShell-Remoting ist auf den Anwendungsservern aktiviert, auf denen die ASP.NET-Anwendungen ausgeführt werden, die Sie containerisieren möchten.

Anmelden bei Azure

1. Wählen Sie "Anmelden" aus, um sich bei Ihrem Azure-Konto anzumelden.

   Für die Authentifizierung bei Azure benötigen Sie einen Gerätecode. Wenn Sie "Anmelden" auswählen, sollte ein Fenster geöffnet werden, das den Gerätecode enthält. Falls das Fenster nicht angezeigt wird, sollten Sie sich vergewissern, dass Sie den Popupblocker im Browser deaktiviert haben.

2. Wählen Sie "Code kopieren" aus, und melden Sie sich an , um den Gerätecode zu kopieren, und wechseln Sie zu einer Azure-Anmeldeaufforderung auf einer neuen Browserregisterkarte:

   

3. Fügen Sie auf dem neuen Tab den Gerätecode ein, und melden Sie sich mit den Anmeldeinformationen für Ihr Azure-Konto an. Nach der Anmeldung können Sie den Browsertab schließen und zurück zur Weboberfläche des Anwendungscontainerisierungstools wechseln.

4. Wählen Sie den Azure-Mandanten aus, den Sie verwenden möchten.

5. Geben Sie das Azure-Abonnement an, das Sie verwenden möchten.

Erkunden von ASP.NET-Anwendungen

Das Anwendungscontainerisierungstool stellt mit den angegebenen Anmeldeinformationen eine Remoteverbindung mit den Anwendungsservern her und versucht, ASP.NET-Anwendungen zu ermitteln, die auf den Anwendungsservern gehostet werden.

1. Geben Sie die Server-IP-Adresse/den FQDN und die Anmeldeinformationen des Servers an, auf dem die ASP.NET Anwendung ausgeführt wird, die für die Remoteverbindung mit dem Server für die Anwendungsermittlung verwendet werden soll.

   • Die angegebenen Anmeldeinformationen müssen für einen lokalen Administrator (Windows) auf dem Anwendungsserver angegeben werden.
   • Für Domänenkonten (der Benutzer muss ein Administrator auf dem Anwendungsserver sein), stellen Sie dem Benutzernamen den Domänennamen in diesem Format voran: <Domäne\Benutzername>.
   • Für lokale Konten (der Benutzer muss ein Administrator auf dem Anwendungsserver sein), stellen Sie dem Benutzernamen den Hostnamen in diesem Format voran: <Hostname\Benutzername>.
   • Sie können die Anwendungsermittlung für bis zu fünf Server gleichzeitig ausführen.

2. Wählen Sie "Überprüfen " aus, um zu überprüfen, ob der Anwendungsserver vom Computer aus erreichbar ist, auf dem das Tool ausgeführt wird und dass die Anmeldeinformationen gültig sind. Nach erfolgreicher Überprüfung zeigt die Spalte Status den Status als Mapped an.

   

3. Wählen Sie "Weiter" , um die Anwendungsermittlung auf den ausgewählten Anwendungsservern zu starten.

4. Wählen Sie nach Abschluss der Anwendungsermittlung die Anwendungen aus, die Sie containerisieren möchten:

   

5. Geben Sie einen Namen für den Zielcontainer jeder ausgewählten Anwendung an. Geben Sie den Containernamen als <name:tag> an, wobei tag für das Containerimage verwendet wird. Sie können beispielsweise den Zielcontainernamen als "appname:v1" angeben.

Parametrisieren von Anwendungskonfigurationen

Durch das Parametrisieren der Konfiguration steht diese zur Bereitstellungszeit als Parameter zur Verfügung. Dank der Parametrisierung können Sie eine Einstellung bei der Anwendungsbereitstellung konfigurieren, anstatt diese in einem bestimmten Wert im Containerimage hartzucodieren. Diese Option ist beispielsweise für Parameter wie Datenbank-Verbindungszeichenfolgen nützlich.

1. Wählen Sie App-Konfigurationen aus, um erkannte Konfigurationen zu überprüfen.

2. Wählen Sie die Parameter, die Sie parametrisieren möchten, und dann die Option Übernehmen aus:

   

Externalisieren von Dateisystemabhängigkeiten

Sie können weitere Ordner hinzufügen, die von der Anwendung verwendet werden. Geben Sie an, ob diese Teil des Containerimages sein oder per Azure-Dateifreigabe in persistenten Speicher ausgelagert werden sollen. Die Verwendung von externem persistentem Speicher ist für zustandsbehaftete Anwendungen ideal, die den Zustand außerhalb des Containers speichern oder statische Inhalte im Dateisystem gespeichert haben.

1. Wählen Sie " Bearbeiten" unter "Anwendungsordner " aus, um die erkannten Anwendungsordner zu überprüfen. Diese Ordner wurden als obligatorische Artefakte identifiziert, die von der Anwendung benötigt werden. Sie werden in das Containerimage kopiert.

2. Wählen Sie "Ordner hinzufügen" aus, und geben Sie die Ordnerpfade an, die Sie hinzufügen möchten.

3. Trennen Sie die Werte durch Kommas, falls Sie für ein Volume mehrere Ordner angeben möchten.

4. Wählen Sie Azure File Share als Speicheroption, wenn Sie möchten, dass die Ordner außerhalb des Containers auf persistentem Speicher gespeichert werden.

5. Wählen Sie "Speichern" aus, nachdem Sie die Anwendungsordner überprüft haben:

   

6. Wählen Sie "Weiter" aus, um mit der Buildphase des Containerimages fortzufahren.

Erstellen des Containerimage

1. Wählen Sie in der Dropdownliste eine Azure-Containerregistrierung aus, die zum Erstellen und Speichern der Containerimages für die Apps verwendet wird. Sie können eine vorhandene Azure-Containerregistrierung verwenden oder eine neue erstellen, indem Sie " Neue Registrierung erstellen" auswählen:

   

   Hinweis

   Es werden nur Azure-Containerregistrierungen angezeigt, für die das Administratorbenutzerkonto aktiviert ist. Das Administratorbenutzerkonto ist derzeit für die Bereitstellung eines Images aus einer Azure-Containerregistrierung für Azure App Service erforderlich. Weitere Informationen finden Sie unter Authentifizieren mit einer Azure-Containerregistrierung.

2. Die Dockerfiles, die für die Erstellung der Containerimages für die einzelnen ausgewählten Anwendungen benötigt werden, werden zu Beginn des Buildschritts generiert. Wählen Sie "Überprüfen" aus, um die Dockerfile-Datei zu überprüfen. Im Überprüfungsschritt können Sie auch alle erforderlichen Anpassungen am Dockerfile vornehmen und die Änderungen speichern, bevor Sie den Buildprozess starten.

3. Wählen Sie die Anwendungen aus, für die Sie Bilder erstellen möchten, und wählen Sie dann "Erstellen" aus. Wenn Sie Build auswählen, wird der Containerimagebuild für jede Anwendung gestartet. Das Tool überwacht den Buildstatus und ermöglicht Ihnen die Ausführung des nächsten Schritts, nachdem der Buildvorgang abgeschlossen ist.

4. Sie können den Fortschritt des Builds überwachen, indem Sie unter der Statusspalte " In Bearbeitung erstellen" auswählen. Der Link wird einige Minuten nach dem Auslösen des Buildprozesses aktiv.

5. Nachdem der Build abgeschlossen ist, wählen Sie "Weiter " aus, um Bereitstellungseinstellungen anzugeben:

   

Das Bereitstellen der containerisierten App in Azure App Service

Nachdem das Containerimage erstellt wurde, besteht der nächste Schritt darin, die Anwendung als Container in Azure App Service bereitzustellen.

1. Wählen Sie den Azure App Service-Plan aus, der von der Anwendung verwendet werden soll.

   Wenn Sie keinen App Service-Plan haben oder einen neuen App Service-Plan erstellen möchten, können Sie einen erstellen, indem Sie "Neuen App Service-Plan erstellen" auswählen.

2. Wählen Sie "Weiter" aus, nachdem Sie den App Service-Plan ausgewählt haben.

3. Geben Sie den Geheimnisspeicher an, der für die Anwendung verwendet werden soll, falls Sie Anwendungskonfigurationen parametrisiert haben. Sie können Azure Key Vault oder die App Service-Anwendungseinstellungen auswählen, um Ihre Anwendungsgeheimnisse zu verwalten. Weitere Informationen finden Sie unter Konfigurieren von Verbindungszeichenfolgen.

   • Wenn Sie app Service-Anwendungseinstellungen zum Verwalten Ihrer geheimen Schlüssel ausgewählt haben, wählen Sie "Weiter" aus.
   • Wenn Sie einen Azure Key Vault verwenden möchten, um Ihre Anwendungsschlüssel zu verwalten, geben Sie den Schlüsseltresor an, den Sie verwenden möchten.
     • Wenn Sie keinen Azure Key Vault haben oder einen neuen Schlüsseltresor erstellen möchten, können Sie einen erstellen, indem Sie "Neuen Azure Key Vault erstellen" auswählen.
     • Das Tool weist automatisch die erforderlichen Berechtigungen für die Verwaltung von Geheimnissen über den Schlüsseltresor zu.

4. Falls Sie weitere Ordner hinzugefügt und die Option „Azure-Dateifreigabe“ für persistenten Speicher ausgewählt haben, müssen Sie die entsprechende Azure-Dateifreigabe für die Verwendung durch das Anwendungscontainerisierungstool während der Bereitstellung angeben. Das Tool kopiert die Anwendungsordner, die Sie für Azure Files konfiguriert haben, an den neuen Speicherort und bindet sie während der Bereitstellung in den Anwendungscontainer ein. 

   Wenn Sie nicht über eine Azure-Dateifreigabe verfügen oder eine neue Azure-Dateifreigabe erstellen möchten, können Sie eine erstellen, indem Sie "Neues Speicherkonto erstellen" und "Dateifreigabe" auswählen.

5. Nun müssen Sie die Bereitstellungskonfiguration für die Anwendung angeben. Wählen Sie "Konfigurieren" aus, um die Bereitstellung für die Anwendung anzupassen. Im Konfigurationsschritt können Sie die folgenden Anpassungen vornehmen:

   • Name: Geben Sie einen eindeutigen App-Namen für die Anwendung an. Dieser Name wird verwendet, um die Anwendungs-URL zu generieren. Darüber hinaus wird er als Präfix für andere Ressourcen verwendet, die im Rahmen der Bereitstellung erstellt werden.
   • Anwendungskonfiguration Geben Sie für alle parametrisierten Anwendungskonfigurationen die Werte an, die für die aktuelle Bereitstellung verwendet werden sollen.
   • Speicherkonfiguration Sehen Sie sich die Informationen zu den Anwendungsordnern an, die für die persistente Speicherung konfiguriert wurden.

   

6. Nachdem Sie die Bereitstellungskonfiguration für die Anwendung gespeichert haben, generiert das Tool die Kubernetes-Bereitstellungsdatei mit dem YAML-Code für die Anwendung.

   • Wählen Sie "Überprüfen" aus, um die Bereitstellungskonfiguration für die Anwendungen zu überprüfen.

   • Wählen Sie die Anwendungen aus, die Sie bereitstellen möchten.

   • Wählen Sie "Bereitstellen" aus, um die Bereitstellung für die ausgewählten Anwendungen zu starten.

     

   • Nachdem die Anwendung bereitgestellt wurde, können Sie die Spalte " Bereitstellungsstatus " auswählen, um die Ressourcen nachzuverfolgen, die für die Anwendung bereitgestellt wurden.

Behandeln von Problemen

Wenn Sie Probleme mit dem Anwendungscontainerisierungstool behandeln müssen, können Sie sich die Protokolldateien auf dem Windows-Computer ansehen, auf dem das Tool ausgeführt wird. Protokolldateien für das Tool befinden sich unter "C:\ProgramData\Microsoft Azure Migrate App Containerization\Logs".

Nächste Schritte

• Containerisierung von ASP.NET-Web-Apps und deren Bereitstellung auf Windows-Containern in AKS
• Containerisieren von Java-Web-Apps auf Apache Tomcat (auf Linux-Servern) und Bereitstellen auf Linux-Containern auf AKS
• Containerisieren von Java-Web-Apps auf Apache Tomcat (auf Linux-Servern) und Bereitstellen auf Linux-Containern auf App Service