Linux-Anwendungen in Container umwandeln

Die Migrate to Containers-Integration mit Cloud Code ermöglicht es Ihnen, Linux-Anwendungskomponenten zu modernisieren, die auf virtuellen Maschinen (VMs) ausgeführt werden, und Artefakte zu generieren, die direkt in Ihrer IDE auf einer Linux-Maschine in 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, die auf einer Linux-Maschine arbeiten, VS Code kennen, mit Google Cloudvertraut sind und eine VM haben, auf der ihre Anwendungskomponente ausgeführt wird.

Hinweise

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.

   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.

   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 durchführen möchten. Weitere Informationen zu unterstützten Arbeitslasten finden Sie unter Kompatible Betriebssysteme, Arbeitslasten und Kubernetes-Versionen ansehen.
11. Quell- und lokale Computer für die Modernisierung vorbereiten. Cloud Code unterstützt nur Linux für die Modernisierung.

Replatform-Quelle hinzufügen

In diesem Abschnitt installieren Sie die Discovery-Client-Befehlszeile des Migration Centers (mcdc) und andere Migrate to Containers-Tools auf Ihrem lokalen Computer, falls Sie dies noch nicht getan haben. Außerdem 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 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"
     }
   ]
   

4. Wenn Sie die Quellen im Replatform Apps-Explorer sehen möchten, bewegen Sie den Mauszeiger auf den Replatform Apps-Explorer und klicken Sie auf die Schaltfläche Quellen neu laden (zwischengespeichert), die angezeigt wird.

Optional: Eignungsbewertung generieren

Bevor Sie versuchen, Ihre Anwendung auf einen Container zu migrieren, empfehlen wir, eine Fit Assessment Ihrer Quelle zu erstellen. Sie werden dann benachrichtigt, wenn Ihre Quelle für die Migration auf einen Container geeignet ist.

Wenn Sie eine Fit-Bewertung Ihrer 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 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 CLI.

Neuen Arbeitsbereich für die Umstellung erstellen

Bevor Sie einen neuen Arbeitsbereich für die Umstellung der Plattform 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 Apps neu plattformieren mit der rechten Maustaste auf die Quelle, die Sie neu plattformieren möchten, und klicken Sie dann auf 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 Arbeitsbereichverzeichnis aus, in das Sie Ihre Anwendung migrieren möchten, klicken Sie auf OK und dann auf Arbeitsbereich für die Migration 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 Verzeichnis Ihres neuen Arbeitsbereichs in einem neuen Fenster Ihrer IDE geöffnet.

Dateien von Ihrer VM in Ihren Arbeitsbereich kopieren

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

1. Optional: Die mcdc-Befehlszeile wendet Filter an, um die Größe der Kopie zu reduzieren. Sie können die Datei filters.txt 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 Tasks: Run Task (Aufgaben: Aufgabe ausführen) und wählen Sie diese Option aus. Wählen Sie dann m2c: Copy (m2c: Kopieren) 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 mit dem Namen 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 von Ihrem 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 Copy und Analyze in den vorherigen Abschnitten noch nicht ausgeführt haben, werden sie von der Aufgabe Generate 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, die zum Erstellen und Bereitstellen eines Container-Images verwendet wird. Für jeden Migrationstyp werden unterschiedliche Artefakte generiert. In der Regel werden jedoch für alle Migrationstypen ein oder mehrere Dockerfiles und eine GKE-Bereitstellungsspezifikation erstellt, auf die in skaffold.yaml verwiesen wird.

   Wenn die Artefakte generiert wurden, ist die Replatforming-Migration 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 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, rufen die Logs Ihrer 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 für 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 die Image-Registry 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. Um mit dieser verknüpften IP-Adresse auf Ihre Anwendung zuzugreifen, drücken Sie Ctrl und klicken Sie auf die Adresse.

Nachdem Ihre Debugging-Sitzung gestartet wurde, wird im Bereich Entwicklungssitzungen die strukturierte Logging-Ansicht angezeigt. Wenn eine Aufgabe beginnt, wird sie 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 von Ihnen 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 Clusternamen und klicken Sie dann auf open_in_new In der 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:

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 der Plattform erstellt wurden:

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