Linux-Anwendungen in Container umwandeln

Mit der Integration von Migrate to Containers in Cloud Code können Sie Linux-Anwendungskomponenten, die auf virtuellen Maschinen (VMs) ausgeführt werden, modernisieren und Artefakte generieren, die direkt in Ihrer IDE mit einem Linux-Computer in der Google Kubernetes Engine und Cloud Run bereitgestellt werden können.

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

Dieser Leitfaden richtet sich an Entwickler auf einem Linux-Rechner, die mit VS Code vertraut sind, mit Google Cloudvertraut sind und eine VM mit ihrer Anwendungskomponente haben.

Hinweis: Sie benötigen einen Linux-Rechner, um die Schritte in dieser Anleitung auszuführen. Cloud Code unterstützt nicht die Umstellung von Anwendungen auf Container unter Windows oder macOS.

Hinweis

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Google Kubernetes Engine API.

   Enable the API

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Google Kubernetes Engine API.

   Enable the API

8. Installieren Sie die Cloud Code-Erweiterung, falls noch nicht geschehen.
9. GKE-Cluster erstellen und konfigurieren
10. Sie müssen wissen, welche Art von Migration Sie ausführen möchten. Weitere Informationen zu unterstützten Arbeitslasten finden Sie unter Kompatible Betriebssysteme, Arbeitslasten und Kubernetes-Versionen ansehen.
11. Bereiten Sie Ihre Quell- und lokalen Computer für die Modernisierung vor. Cloud Code unterstützt nur Linux für die Modernisierung.

Replatforming-Quelle hinzufügen

In diesem Abschnitt installieren Sie die Discovery-Client-Befehlszeile des Migrationscenters (mcdc) und andere Migrate to Containers-Tools auf Ihrem lokalen Computer, falls Sie dies noch nicht getan haben. Anschließend fügen Sie eine Replatforming-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 Apps umstellen.

2. Wenn Sie Migrate to Containers in Cloud Code zum ersten Mal 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. Daraufhin 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 host-, user- und identityFile-Variablen in einem SSH-Befehl verwenden.

4. Wenn die Quellen im Replatform Apps-Explorer angezeigt werden sollen, bewegen Sie den Mauszeiger auf den Replatform Apps-Explorer und klicken Sie auf die Schaltfläche Quellen neu laden, die im Cache angezeigt wird.

Optional: Eignungsbewertung generieren

Bevor Sie versuchen, Ihre Anwendung auf einen Container umzustellen, empfehlen wir Ihnen, eine Eignungsbewertung Ihrer Quelle durchzuführen. Sie werden dann benachrichtigt, ob Ihre Quelle für die Umstellung auf einen Container geeignet ist.

Wenn Sie eine Eignungsbewertung für Ihre Quelle erstellen möchten, klicken Sie mit der rechten Maustaste auf die Quelle und wählen Sie Quelle bewerten aus. Dadurch wird das Terminal in Ihrer IDE geöffnet und die Protokolle der Bewertung Ihrer Quelle werden angezeigt.

Nach Abschluss der Bewertung generiert mcdc einen Fit-Bewertungsbericht in Ihrer IDE.

Wenn Ihre Quellen als gut geeignet eingestuft wurden, können Sie Ihre Anwendung umstellen.

Plattform Ihrer Anwendung wechseln

Cloud Code erstellt für jede Plattformmigration einen eigenen Arbeitsbereich und ermöglicht es Ihnen, die Aufgaben Kopieren, Analysieren und Generieren im Arbeitsbereich auszuführen, um die Schritte zur Plattformmigration zu automatisieren. Wenn Sie die Aufgabe Generieren ausführen, ohne zuerst die Aufgaben Kopieren und Analysieren auszuführen, werden diese automatisch ausgeführt, bevor Artefakte generiert werden.

In den folgenden Abschnitten erfahren Sie, wie Sie diese Aufgaben ausführen und Ihre Anwendung mit Cloud Code auf einen Container umstellen.

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

Neuen Replatforming-Arbeitsbereich erstellen

Bevor Sie einen neuen Replatforming-Arbeitsbereich erstellen, müssen Sie wissen, welche Migrationsparameter Sie für den 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 Replatforming-Arbeitsbereich mit Artefakten in Ihrer IDE:

1. Klicken Sie im Explorer Apps umstellen mit der rechten Maustaste auf die Quelle, die Sie umstellen möchten, und dann auf Umstellen.

2. Wählen Sie im Menü eine Migration aus.

3. Wählen Sie ein neues Arbeitsbereichsverzeichnis aus, in dem Sie Ihre Anwendung neu bereitstellen möchten, klicken Sie auf OK und dann auf Replatforming-Arbeitsbereich erstellen.

4. Wählen Sie die Migrationsparameter für den 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.

   Die Generierung des Arbeitsbereichs dauert einige Sekunden. Dadurch wird das neue Arbeitsbereichsverzeichnis in einem neuen Fenster Ihrer IDE geöffnet.

Dateien von Ihrer VM in Ihren Arbeitsbereich kopieren

So kopieren Sie die Dateien aus 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 Verringern der Größe der Kopie finden Sie unter Größe des kopierten Dateisystems reduzieren.

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

3. Suchen Sie nach Tasks: Run Task (Aufgaben: Aufgabe ausführen) und wählen Sie dann m2c: Copy (m2c: Kopieren) aus. Das Kopieren von Dateien kann einige Minuten dauern.

VM-Dateisystem analysieren und Migrationsplan generieren

Führen Sie die folgenden Schritte aus, um das VM-Dateisystem zu analysieren und einen Migrationsplan zu generieren:

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

2. Suchen Sie nach Tasks: Run Task (Aufgaben: Aufgabe ausführen) und 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 zugehöriger Dokumentation zum Parameter.

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

   Die Struktur der 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 in Ihrer IDE die Aufgabe Generate (Generieren) 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 + Umschalttaste + P drücken.

2. Suchen Sie nach Tasks: Run Task (Aufgaben: Aufgabe ausführen) und wählen Sie dann m2c: Generate (m2c: Generieren) aus. Dadurch werden die Artefakte im Verzeichnis src generiert. Dieses enthält eine skaffold.yaml-Datei, die zum Erstellen und Bereitstellen eines Container-Images verwendet wird. Für jeden Migrationstyp werden unterschiedliche Artefakte generiert. Bei allen Migrationstypen werden jedoch in der Regel ein oder mehrere Dockerfiles und eine GKE-Bereitstellungsspezifikation erstellt, auf die skaffold.yaml verweist.

   Sobald die Erstellung der Artefakte abgeschlossen ist, ist die Umstellung Ihrer Anwendung abgeschlossen.

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

   Wenn Sie mit den Ergebnissen der Plattformmigration 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 neu bereitgestellte Anwendung in einem GKE-Container aus, rufen die Protokolle der laufenden Anwendung auf 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 beobachtet Ihr Dateisystem auf Änderungen, sodass Sie Ihre Anwendung in Echtzeit bearbeiten und noch einmal 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 mit gcr.io/PROJECT_ID eine neue Image-Registry erstellen, muss sich diese 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 sehen Sie in der Terminalausgabe einen Livestream der Logs der ausgeführten Pods.

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

Nach dem Start der Debugging-Sitzung wird im Bereich Entwicklungssitzungen die strukturierte Logging-Ansicht angezeigt. Wenn eine Aufgabe beginnt, wird die Aufgabe mit einem rotierenden Halbkreis progress_activity angezeigt.

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

Klicken Sie auf den Schritt im Bereich Entwicklungssitzung, um die Details eines Schritts anzuzeigen. Im Ausgabebereich wird der Schritt in der Logging-Ausgabe angezeigt.

Bereinigen

Nachdem Sie Ihre Anwendung beendet haben, werden alle während der Ausführung bereitgestellten Kubernetes-Ressourcen automatisch gelöscht.

Damit Ihr Konto nicht für andere in dieser Kurzanleitung verwendete Ressourcen belastet wird, müssen Sie das Projekt oder den Cluster, den Sie erstellt haben, 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 Clusternamen und klicken Sie dann auf open_in_new (In Google Cloud Console ö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, z. B. eine appspot.com-URL, erhalten bleiben, sollten Sie ausgewählte Ressourcen innerhalb des Projekts löschen, statt 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. In the Google Cloud console, go to the Manage resources page.

   Go to Manage resources

2. In the project list, select the project that you want to delete, and then click Delete.
3. In the dialog, type the project ID, and then click Shut down to delete the project.

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

1. Öffnen Sie die Befehlspalette (Strg + Umschalttaste + P).
2. Suchen Sie nach Tasks: Run Task (Aufgaben: Aufgabe ausführen) und wählen Sie dann m2c: Cleanup (m2c: Bereinigung) aus.