Auf dieser Seite erfahren Sie, wie Sie den Google Cloud Modernization Hub in derGoogle Cloud Console verwenden, um Java-Anwendungen für Unternehmen für die Linux-Containerisierung und Modernisierung auf plattformübergreifende Java-Langzeitsupport-Releases (LTS) wie Java 17 oder Java 21 in Google Cloudzu bewerten.
Viele Java-Anwendungen für Unternehmen hängen von Legacy-Java-EE-APIs, proprietären Anwendungsserverkonfigurationen (wie WebLogic, WebSphere oder JBoss) oder veralteten Drittanbieterbibliotheken ab, die eine direkte Bereitstellung in Linux-Containern verhindern. Eine automatisierte Bewertung im Modernization Hub analysiert Ihren Quellcode, identifiziert Migrationshindernisse, bewertet die Kompatibilität von Maven- oder Gradle-Abhängigkeiten und empfiehlt Refaktorierungspfade für Cloud Run oder die Google Kubernetes Engine.
Wenn Sie Bewertungen von Ihrem lokalen Computer ausführen oder Berichtsabschnitte mit der eigenständigen codmod-Befehlszeile anpassen möchten, lesen Sie den Hilfeartikel Bewertung der Anwendungsmodernisierung erstellen.
Wann sollte eine Java-Anwendungsbewertung verwendet werden?
Führen Sie eine Java-Anwendungsbewertung durch, wenn Sie Folgendes planen:
- Plattformwechsel zu Linux-Containern: Identifizieren Sie umgebungsspezifische Abhängigkeiten (z. B. Zugriff auf das lokale Dateisystem, JNI-Bibliotheken oder proprietäre Anwendungsserver-APIs), bevor Sie Anwendungen für Cloud Run oder GKE containerisieren.
- Java-Laufzeitversionen aktualisieren: Bewerten Sie den Aufwand und die Kompatibilitätslücken bei der Migration von Java 8 oder Java 11 zu modernen Java-LTS-Releases (Java 17 oder Java 21) oder beim Übergang von Java EE (
javax.*) zu Jakarta EE (jakarta.*). - Monolithische Architekturen entkoppeln: Entdecken Sie eng gekoppelte EJB-Komponenten, JMS-Message-Broker oder monolithische WAR- und EAR-Bereitstellungen, die in cloudnative Mikrodienste oder Spring Boot-Anwendungen refaktoriert werden müssen.
Hinweis
Bevor Sie einen Java-Bewertungsjob in der Console starten, müssen Sie die erforderlichen APIs aktivieren, die IAM-Berechtigungen (Identity and Access Management) Ihres Projekts prüfen, einen Bucket für Arbeitsbereichseinstellungen registrieren und Ihr Quellcodearchiv in Cloud Storage hochladen.
Erforderliche APIs aktivieren
Wenn Sie den Modernization Hub verwenden möchten, müssen Sie die erforderlichen Google Cloud-Dienst-APIs in Ihrem Projekt aktivieren:
gcloud services enable \
aiplatform.googleapis.com \
artifactregistry.googleapis.com \
cloudbuild.googleapis.com \
cloudresourcemanager.googleapis.com \
compute.googleapis.com \
logging.googleapis.com \
storage.googleapis.com \
--project=PROJECT_ID
Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .
Erforderliche Rollen
Für die Ausführung einer Bewertung sind unterschiedliche IAM-Berechtigungen für zwei Identitäten erforderlich, die Cloud Build und die Gemini Enterprise Agent Platform verwenden:
- Authentifizierter Console-Nutzer (startet den Job und greift auf Buckets zu):
- Storage-Administrator (
roles/storage.admin) - Dienstkontonutzer (
roles/iam.serviceAccountUser) - Cloud-Build-Bearbeiter (
roles/cloudbuild.builds.editor)
- Storage-Administrator (
- Dediziertes Dienstkonto (führt den Bewertungscontainer aus):
- Agent Platform User
(
roles/aiplatform.user) - Storage Object User (
roles/storage.objectUser) oder Storage Admin (roles/storage.admin)
- Agent Platform User
(
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für Ihr Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Initiieren einer Bewertung und zum Ausführen des Analysecontainers benötigen:
-
Nutzer – Quellarchive und Bucket-Konfigurationen verwalten: Storage-Administrator (
roles/storage.admin) -
Nutzer: Dediziertes Dienstkonto an den Job anhängen: Dienstkontonutzer (
roles/iam.serviceAccountUser) -
Nutzer: Bewertungsjobs (
cloudbuild.builds.create) senden und Logs ansehen: Cloud Build-Bearbeiter (roles/cloudbuild.builds.editor) -
Dienstkonto: Führen Sie den
codmod-Container aus: Agent Platform User (roles/aiplatform.user) -
Dienstkonto – Quellarchive lesen und Bewertungsberichte schreiben: Storage-Objekt-Nutzer (
roles/storage.objectUser) oder Storage-Administrator (roles/storage.admin)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Initiieren einer Bewertung und zum Ausführen des Analysecontainers erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um eine Bewertung zu initiieren und den Analysecontainer auszuführen:
-
Nutzer (Cloud Storage, Cloud Build und IAM):
-
storage.objects.get(zum Herunterladen oder Lesen von Dateien) -
storage.objects.list(zum Auflisten von Dateien im Bucket) -
storage.objects.create(zum Hochladen oder Erstellen neuer Dateien) -
storage.objects.update(zum Ändern von Metadaten vorhandener Dateien) -
storage.objects.delete(zum Löschen oder Überschreiben von Dateien) -
storage.buckets.get(Konfigurationen auf Bucket-Ebene ansehen) -
cloudbuild.builds.create(zum Senden von Bewertungsjobs) -
iam.serviceAccounts.actAs(um das Dienstkonto an den Job anzuhängen)
-
-
Dienstkonto (Agent Platform und Cloud Storage):
-
aiplatform.endpoints.predict(zum Ausführen einer KI-gestützten Codeanalyse) -
storage.objects.get(zum Lesen oder Herunterladen von Quellarchiven) -
storage.objects.list(zum Auflisten von Dateien im Eingabeordner) -
storage.objects.create(zum Schreiben von Bewertungsberichten) -
storage.objects.delete(zum Löschen temporärer Dateien)
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Bucket für Arbeitsbereichseinstellungen konfigurieren
Registrieren Sie auf der Seite Modernization Hub > Einstellungen einen bestimmten Cloud Storage-Bucket (z. B. gs://PROJECT_ID-modernization-hub), um die Binärstatusdateien des Arbeitsbereichs (dotnet_jobs.pb, java_jobs.pb und mainframe_jobs.pb) zu speichern.
Größenbeschränkungen für Codebasis prüfen
Damit die Leistung optimal bleibt, gelten für die codmod-Bewertungs-Engine die folgenden Richtlinien für Skalierung und Archivierung:
- Maximale Größe der Codebasis: ca. 6 Millionen Codezeilen (LOC) pro Bewertungsjob. Wenn Ihr Repository mehr als sechs Millionen LOC enthält, teilen Sie die Codebasis vor dem Hochladen in kleinere, unabhängige Module oder Dienste auf.
- Saubere Archivstruktur: Schließen Sie kompilierte Binärdateien, Paket-Caches und Metadaten zur Versionsverwaltung (z. B.
target/,build/,bin/,node_modules/und.git/) aus Ihrer ZIP-Datei aus, damit nur Quelldateien und Build-Konfigurationen analysiert werden.
Java-Quellarchiv vorbereiten und hochladen
Verpacken Sie Ihre Java-Codebasis als ZIP-Datei, die keine Build-Ausgaben enthält, und laden Sie die Datei in einen Cloud Storage-Bucket in Ihrem Projekt hoch.
Erstellen Sie auf Ihrem lokalen Computer mit einer der folgenden Methoden eine ZIP-Datei Ihres Repositorys:
Mit Git (empfohlen):
git archive --format=zip -o repository.zip HEAD
Mit der
zip-Befehlszeile:zip -r repository.zip . \ -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
Laden Sie die ZIP-Datei mit der Google Cloud CLI in Ihren Cloud Storage-Ziel-Bucket hoch:
gcloud storage cp repository.zip \ gs://INPUT_BUCKET/codebase/repository.zipErsetzen Sie INPUT_BUCKET durch den Namen Ihres Cloud Storage-Ziel-Buckets.
Bewertung ausführen
So starten Sie einen Bewertungsjob im Modernization Hub:
Rufen Sie in der Console die Seite Modernization Hub auf.
Suchen Sie auf der Landingpage die Karte Java-Arbeitslasten und klicken Sie auf Bewertung starten.
Geben Sie im Feld Jobname einen eindeutigen Namen für den Bewertungsjob ein.
Wählen Sie im Feld Speicherort des Quellcodes einen Cloud Storage-Bucket aus, der Ihren Quellcode als ZIP-Datei enthält.
Wählen Sie im Feld Berichtsspeicherort einen Cloud Storage-Bucket aus, um die generierten Bewertungsberichte zu speichern.
Wählen Sie in der Liste Modernisierungsrezept ein Modernisierungsrezept aus.
Wählen Sie in der Liste Standort eine Region für den Bewertungsjob aus.
Wählen Sie im Feld Dienstkonto ein dediziertes Dienstkonto mit den erforderlichen IAM-Rollen aus, die im Abschnitt Erforderliche Rollen aufgeführt sind. Cloud Build führt den Bewertungsjob unter diesem Dienstkonto aus, für das die Berechtigungen „Agent Platform User“ und „Cloud Storage“ erforderlich sind.
Klicken Sie auf Bericht generieren.
Die Console startet einen Hintergrundbewertungscontainer, in dem die
codmod-Engine ausgeführt wird, um Ihr Projekt zu analysieren. Der Jobstatus wird in der Tabelle Bewertungsverlauf angezeigt.
Bewertungsbericht prüfen
Je nach Größe Ihrer Codebasis werden Bewertungsjobs in der Regel innerhalb weniger Minuten abgeschlossen. Der Hintergrundcontainer wird nach Abschluss der Verarbeitung automatisch beendet.
So greifen Sie auf Ihre Bewertungsergebnisse zu:
- Suchen Sie in der Tabelle Bewertungsverlauf auf der Seite „Modernization Hub“ nach Ihrem Bewertungsjob.
- Wenn sich die Spalte Status in Abgeschlossen ändert, klicken Sie auf Bericht herunterladen.
- Wählen Sie das gewünschte Ausgabeformat aus:
- HTML-Bericht: Eine interaktive Zusammenfassung, mit der Sie inkompatible APIs filtern, Blockerlisten für einzelne Dateien prüfen und Vorschläge zur Behebung ansehen können.
- Markdown-Bericht: Eine formatierte Zusammenfassung, die für die Weitergabe an Stakeholder und Architekturprüfungsgremien geeignet ist.
Bewertungsbericht prüfen
Im generierten Bewertungsbericht wird die Migrationsbereitschaft Ihrer Anwendung in mehrere Schlüsselbereiche kategorisiert:
- Gesamtkompatibilitätswert: Der Prozentsatz der Quellzeilen und Abhängigkeiten, die ohne Änderung zur Ziel-Java-Laufzeit migriert werden können.
- Blocker-Aufschlüsselung: Bestimmte Legacy-Java-Abhängigkeiten oder Umgebungseinschränkungen, die ein Refactoring erfordern, z. B.:
- Namespace-Änderungen von Java EE (
javax.*) zu Jakarta EE (jakarta.*). - Entfernte oder verworfene interne JDK-APIs (z. B.
sun.misc.*-Pakete oder CORBA-Module). - Proprietäre Anwendungsserverkonfigurationen oder APIs (z. B. WebLogic-, WebSphere- oder JBoss-Deployment-Deskriptoren).
- Namespace-Änderungen von Java EE (
- Abhängigkeitsanalyse: Ein detailliertes Inventar vorhandener Maven- oder Gradle-Abhängigkeiten, das angibt, ob jede Bibliothek die Ziel-Java-Laufzeitversion unterstützt oder ein Upgrade erfordert.
- Empfohlene Maßnahmen: Vorgeschlagene Codetransformationen, KI-gestützte Refaktorierungsrezepte und Migrationspfade, die von
codmodgeneriert werden, um Ihre Anwendung auf die Containerisierung in Google Cloudvorzubereiten.
Nächste Schritte
- App Modernization Assessment mit der
codmod-Befehlszeile erstellen - .NET-Anwendungen bewerten
- Mainframe Assessment Tool (MAT) einrichten
- KI-gestützte Codetransformation mit Gemini Cloud Assist kennenlernen