Linux-Anwendungen in Container umwandeln

Durch die Integration von Migrate to Containers in Cloud Code können Sie Linux-Anwendungskomponenten, die auf VMs ausgeführt werden, direkt in Ihrer IDE und unter Verwendung eines Linux-Computers modernisieren und Artefakte generieren, die in der Google Kubernetes Engine> und Cloud Run bereitgestellt werden können.

In dieser Anleitung erfahren Sie, wie Sie eine vorhandene Anwendung mit der Cloud Code-Erweiterung in Ihrer IDE auf einem Linux-Computer in einen GKE-Container umstellen.

Diese Anleitung richtet sich an Entwickler auf einem Linux-Computer, die mit VS Code vertraut sind, Google Cloudkennen und eine VM haben, auf der ihre Anwendungskomponente ausgeführt wird.

Hinweis: Für die Schritte in dieser Anleitung benötigen Sie einen Linux-Computer. Cloud Code unterstützt die Replatforming von Anwendungen in Container unter Windows oder macOS nicht.

Hinweis

Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie einfach ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Google Kubernetes Engine API, if it is not already enabled.

Roles required to enable APIs

To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

Enable the API

1. Installieren Sie die Cloud Code-Erweiterung, falls noch nicht geschehen.
2. GKE-Cluster erstellen und konfigurieren
3. Sie müssen wissen, welche Art von Migration Sie durchführen möchten. Weitere Informationen zu unterstützten Arbeitslasten finden Sie unter Kompatible Betriebssysteme, Arbeitslasten und Kubernetes-Versionen ansehen.
4. Quell- und lokale Computer für die Modernisierung vorbereiten Cloud Code unterstützt für die Modernisierung nur Linux.

Replatform-Quelle hinzufügen

In diesem Abschnitt installieren Sie die Befehlszeile des Migration Center-Discovery-Clients (mcdc) und andere Migrate to Containers-Tools auf Ihrem lokalen Computer, falls Sie dies noch nicht getan haben. Außerdem fügen Sie eine Replatform-Quelle hinzu. Gehen Sie dazu so vor:

1. Klicken Sie in der Aktivitätsleiste der IDE auf Cloud Code und maximieren Sie dann den Explorer von Replatform Apps.

2. Wenn Sie Migrate to Containers zum ersten Mal in Cloud Code verwenden, müssen Sie die mcdc-Befehlszeile und andere Migrate to Containers-Tools auf Ihrem lokalen Computer installieren. Klicken Sie dazu auf Tools installieren. Fahren Sie andernfalls mit dem nächsten Schritt fort.

3. Klicken Sie auf Quellen bearbeiten. Dadurch wird eine leere mcdc-sources.json-Datei geöffnet. Fügen Sie Ihre Quellen im folgenden Format hinzu:

   [
     {
       "title": "SOURCE_NAME",
       "host": "HOSTNAME",
       "user": "USER",
       "identityFile":"IDENTITY-FILE-PATH"
     }
   ]
   

   Hinweis :Sie können dieselben Variablen host, user und identityFile in einem SSH-Befehl verwenden.

4. Wenn Sie die Quellen im Replatform Apps-Explorer sehen möchten, halten Sie den Mauszeiger auf den Replatform Apps-Explorer und klicken Sie auf den Button cached Reload sources (Quellen neu laden), der angezeigt wird.

Optional: Eignungsbewertung generieren

Bevor Sie versuchen, Ihre Anwendung auf eine Containerplattform zu migrieren, empfehlen wir Ihnen, eine Fit Assessment (Eignungsbewertung) für Ihre Quelle zu erstellen. Sie werden dann benachrichtigt, wenn Ihre Quelle für die Migration auf eine Containerplattform geeignet ist.

Wenn Sie eine Fit-Bewertung Ihrer Quelle generieren möchten, rechtsklicken Sie auf die Quelle und wählen Sie Quelle bewerten aus. Dadurch wird das Terminal in Ihrer IDE geöffnet und die Logs der Bewertung Ihrer Quelle werden angezeigt.

Nach Abschluss der Bewertung generiert mcdc einen Bericht zur Fitnessbewertung in Ihrer IDE.

Wenn Ihre Quellen als Good Fit (Gut geeignet) eingestuft werden, können Sie Ihre Anwendung neu plattformieren.

Anwendung auf eine andere Plattform migrieren

Cloud Code erstellt für jede Replatforming-Aktion einen eigenen Arbeitsbereich und ermöglicht es Ihnen, die Aufgaben Kopieren, Analysieren und Generieren im Arbeitsbereich auszuführen, um die Replatforming-Schritte zu automatisieren. Wenn Sie die Aufgabe Generieren ausführen, ohne zuerst die Aufgaben Kopieren und Analysieren auszuführen, werden diese automatisch vor dem Generieren von Artefakten ausgeführt.

In den folgenden Abschnitten wird beschrieben, wie Sie die einzelnen Aufgaben ausführen und Ihre Anwendung mit Cloud Code in einen Container replattformieren.

Weitere Informationen zum Lebenszyklus einer Migration finden Sie unter Architektur der Migrate to Containers-Befehlszeile.

Neuen Arbeitsbereich für die Umstellung erstellen

Bevor Sie einen neuen Arbeitsbereich für die Re-Plattformierung erstellen, müssen Sie wissen, welche Migrationsparameter Sie für Ihren Migrationstyp auswählen müssen. Weitere Informationen zu den Parametern für die einzelnen Migrationstypen finden Sie unter Migrationsplan erstellen.

So erstellen Sie einen neuen Replatform-Arbeitsbereich mit Artefakten in Ihrer IDE:

1. Klicken Sie im Explorer Replatform Apps (Apps neu plattformieren) mit der rechten Maustaste auf die Quelle, die Sie neu plattformieren möchten, und klicken Sie dann auf Replatform (Neu plattformieren).

2. Wählen Sie in der Liste der Optionen, die im Menü angezeigt werden, eine Replatforming-Strategie aus.

3. Wählen Sie ein neues Arbeitsbereichsverzeichnis für die Re-Plattforming Ihrer Anwendung aus, klicken Sie auf OK und dann auf Arbeitsbereich für Re-Plattforming erstellen.

4. Wählen Sie die Migrationsparameter für Ihren Migrationstyp aus.

5. Optional: Wenn Sie den WebSphere-Migrationstyp ausgewählt haben und einen Binärscanner verwenden möchten, wählen Sie die Datei binaryAppScanner.jar aus.

   Das Generieren des Arbeitsbereichs dauert einige Sekunden. Dadurch wird das neue Arbeitsbereichsverzeichnis in einem neuen Fenster der IDE geöffnet.

Dateien von Ihrer VM in Ihren Arbeitsbereich kopieren

So kopieren Sie die Dateien von Ihrer VM in Ihren Arbeitsbereich in der IDE:

1. Optional: Die mcdc-Befehlszeile wendet Filter an, um die Größe der Kopie zu reduzieren. Sie können die filters.txt-Datei jedoch ändern, um die Größe der Kopie weiter zu reduzieren. Informationen zum Reduzieren der Größe der Kopie finden Sie unter Größe des kopierten Dateisystems reduzieren.

2. Öffnen Sie die Befehlspalette, indem Sie Strg + Umschalt + P drücken.

3. Suchen Sie nach Aufgaben: Aufgabe ausführen und wählen Sie diese Option aus. Wählen Sie dann m2c: Copy aus. Das Kopieren von Dateien kann einige Minuten dauern.

VM-Dateisystem analysieren und Migrationsplan erstellen

So analysieren Sie das VM-Dateisystem und generieren einen Migrationsplan:

1. Öffnen Sie die Befehlspalette, indem Sie Strg + Umschalt + P drücken.

2. Suchen Sie nach Tasks: Run Task (Aufgaben: Aufgabe ausführen) und wählen Sie die Option aus. Wählen Sie dann m2c: Analyze (m2c: Analysieren) aus.

   Wenn die Analyseaufgabe fehlschlägt, müssen Sie die Migrationsparameter über die Datei analyze-args.ini ändern. Diese Datei enthält eine Zeile pro Parameter mit der zugehörigen Dokumentation.

   Wenn die Analyse erfolgreich ist, erstellt Cloud Code ein Verzeichnis namens migration-plan, das die Ergebnisse der Analyse in Form einer config.yaml-Datei enthält. Sie können diese Datei bearbeiten, um die Art und Weise zu ändern, wie Ihre Artefakte generiert werden.

   Die Struktur Ihrer config.yaml-Datei hängt vom Migrationstyp ab. Weitere Informationen zu den unterstützten Migrationstypen finden Sie auf den folgenden Seiten:

   • Linux-VMs
   • Tomcat-Server
   • WebSphere-Arbeitslasten
   • JBoss-Server
   • Apache-Server
   • WordPress-Websites

Artefakte generieren

Um Artefakte zu generieren, müssen Sie den Task Generate in Ihrer IDE ausführen. Wenn Sie die Aufgaben Kopieren und Analysieren in den vorherigen Abschnitten noch nicht ausgeführt haben, werden sie von der Aufgabe Generieren automatisch ausgeführt, bevor Artefakte generiert werden.

So generieren Sie die Artefakte:

1. Öffnen Sie die Befehlspalette, indem Sie Strg + Umschalt + P drücken.

2. Suchen Sie nach Aufgaben: Aufgabe ausführen und wählen Sie diese aus. Wählen Sie dann m2c: Generate aus. Dadurch werden die Artefakte im Verzeichnis src generiert, das eine skaffold.yaml-Datei enthält, mit der ein Container-Image erstellt und bereitgestellt wird. Bei jedem Migrationstyp werden unterschiedliche Artefakte generiert. In der Regel werden jedoch bei allen Migrationstypen ein oder mehrere Dockerfiles und eine GKE-Bereitstellungsspezifikation erstellt, auf die skaffold.yaml verweist.

   Wenn die Artefaktgenerierung abgeschlossen ist, haben Sie die Re-Plattformierung Ihrer Anwendung abgeschlossen.

3. Optional: Wenn Sie den Migrationsplan ändern möchten, bearbeiten Sie die config.yaml-Datei und führen Sie die Aufgabe m2c: Generate noch einmal aus.

   Wenn Sie mit den Ergebnissen der Replatforming-Maßnahmen zufrieden sind, können Sie Ihre Anwendung in einem GKE-Container ausführen.

Anwendung in einem GKE-Container ausführen

In diesem Abschnitt führen Sie Ihre replattformierte Anwendung in einem GKE-Container aus, sehen sich die Logs Ihrer laufenden Anwendung an und bereinigen Ressourcen.

Wenn Sie noch keinen GKE-Cluster erstellt und konfiguriert haben, folgen Sie der Anleitung unter GKE-Cluster in Cloud Code for VS Code erstellen und konfigurieren.

Weitere Informationen zum Debuggen von GKE-Anwendungen finden Sie unter Kubernetes-Anwendungen mit Cloud Code for VS Code debuggen.

Anwendung ausführen und ansehen

Jetzt können Sie die Anwendung ausführen und live ansehen. Cloud Code überwacht Ihr Dateisystem auf Änderungen, damit Sie Ihre App in Echtzeit bearbeiten und neu ausführen können.

So führen Sie Ihre Anwendung aus:

1. Klicken Sie in der Cloud Code-Statusleiste auf den Namen des aktiven Projekts.

   

2. Wählen Sie im angezeigten Menü „Schnellauswahl“ die Option Auf Kubernetes ausführen aus.

3. Prüfen Sie, ob Sie den aktuellen Clusterkontext verwenden oder zu einem anderen Kontext wechseln möchten.

4. Wenn Sie dazu aufgefordert werden, wählen Sie eine Image-Registry aus, in die die Images übertragen werden sollen. Wenn Sie eine neue Bildregistrierung mit gcr.io/PROJECT_ID erstellen, muss sich die Bildregistrierung im selben Projekt wie Ihr Cluster befinden.

   Ein Ausgabefenster wird angezeigt, in dem Sie den Fortschritt Ihrer ausgeführten Anwendung verfolgen können. Außerdem wird in der Terminalausgabe ein Livestream der Logs der ausgeführten Pods angezeigt.

5. Sobald Ihre Anwendung in Kubernetes ausgeführt wird, wird im Ausgabefenster eine IP-Adresse angezeigt. Wenn Sie über diese verknüpfte IP-Adresse auf Ihre Anwendung zugreifen möchten, drücken Sie Ctrl und klicken Sie auf die Adresse.

Nachdem Ihre Debugging-Sitzung gestartet wurde, wird im Bereich Entwicklungssitzungen die strukturierte Protokollansicht angezeigt. Wenn eine Aufgabe beginnt, wird sie mit einem sich drehenden Halbkreis progress_activity angezeigt.

Wenn eine Aufgabe erfolgreich ausgeführt wird, wird neben dem Schritt ein Häkchen check_circle angezeigt.

Wenn Sie Details zu einem Schritt aufrufen möchten, klicken Sie im Bereich Entwicklungssitzung auf den Schritt. Im Bereich „Ausgabe“ wird der Schritt in der Protokollausgabe angezeigt.

Bereinigen

Nachdem Sie die Anwendung beendet haben, werden alle Kubernetes-Ressourcen, die während des Laufs bereitgestellt wurden, automatisch gelöscht.

Damit Ihrem Konto keine Gebühren für andere in dieser Kurzanleitung verwendete Ressourcen in Rechnung gestellt werden, sollten Sie das Projekt oder den erstellten Cluster löschen, wenn Sie das Projekt wiederverwenden möchten.

So löschen Sie den Cluster:

1. Klicken Sie auf  Cloud Code und maximieren Sie dann den Kubernetes Explorer.
2. Bewegen Sie den Mauszeiger auf den Namen des Clusters und klicken Sie dann auf open_in_new In Google Cloud Konsole öffnen.
3. Klicken Sie auf Löschen und dann noch einmal auf Löschen.

So löschen Sie Ihr Projekt und die zugehörigen Ressourcen, einschließlich der Cluster:

Achtung: Das Löschen von Projekten hat folgende Auswirkungen:

• Alle Inhalte des Projekts werden gelöscht. Wenn Sie für die Aufgaben in diesem Dokument ein bereits bestehendes Projekt verwendet haben und dieses löschen, werden auch alle anderen im Rahmen des Projekts erstellten Daten gelöscht.
• Benutzerdefinierte Projekt-IDs gehen verloren. Beim Erstellen dieses Projekts haben Sie möglicherweise eine benutzerdefinierte Projekt-ID erstellt, die Sie weiterhin verwenden möchten. Damit die URLs, die die Projekt-ID nutzen, zum Beispiel eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, anstatt das gesamte Projekt.

Wenn Sie mehrere Architekturen, Anleitungen und Kurzanleitungen durcharbeiten möchten, können Sie die Überschreitung von Projektkontingenten verhindern, indem Sie Projekte wiederverwenden.

1. Wechseln Sie in der Google Cloud -Console zur Seite Ressourcen verwalten.

   Zur Seite „Ressourcen verwalten“

2. Wählen Sie in der Projektliste das Projekt aus, das Sie löschen möchten, und klicken Sie dann auf Löschen.
3. Geben Sie im Dialogfeld die Projekt-ID ein und klicken Sie auf Shut down (Beenden), um das Projekt zu löschen.

So löschen Sie alle lokalen Dateien, die während der Umstellung der Plattform erstellt wurden:

1. Öffnen Sie die Befehlspalette (Strg + Umschalt + P).
2. Suchen Sie nach Aufgaben: Aufgabe ausführen und wählen Sie diese Option aus. Wählen Sie dann m2c: Cleanup aus.