.NET-Anwendungen auf Modernisierung prüfen

Auf dieser Seite wird beschrieben, wie Sie mit dem Google Cloud Modernization Hub ASP.NET- und .NET Framework-Anwendungen für die Linux-Containerisierung und die Modernisierung auf eine plattformübergreifende .NET-Version bewerten.

Viele .NET-Anwendungen in Unternehmen hängen von Windows-spezifischen APIs, IIS-Serverkonfigurationen oder Legacy-.NET-Framework-Bibliotheken ab, die eine direkte Bereitstellung in Linux-Containern verhindern. Bei einer automatisierten Bewertung im Modernization Hub wird Ihr Quellcode analysiert, um Hindernisse zu identifizieren, die Kompatibilität von NuGet-Paketen zu bewerten und Refaktorierungspfade für Cloud Run oder die Google Kubernetes Engine zu empfehlen.

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 .NET-Anwendungsbewertung verwendet werden?

Führen Sie eine .NET-Anwendungsbewertung aus, wenn Sie eine der folgenden Modernisierungsaufgaben planen:

  • Plattformwechsel zu Linux-Containern: Identifizieren Sie Windows-spezifische Abhängigkeiten (z. B. Zugriff auf die Windows-Registry, System.Drawing oder Active Directory-Integrationen), bevor Sie Anwendungen für Cloud Run oder GKE containerisieren.
  • Upgrade von .NET Framework-Versionen: Bewerten Sie den Aufwand und die Kompatibilitätslücken bei der Migration von .NET Framework 4.x zu modernen, plattformübergreifenden .NET-Releases (.NET 10 oder höher).
  • Monolithische Architekturen entkoppeln: Entdecken Sie eng gekoppelte WCF-Dienste, Windows-Dienste oder Legacy-Webformulare, die in cloudnative Mikrodienste refaktoriert werden müssen.

Hinweis

Bevor Sie einen .NET-Bewertungsjob 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)
  • 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)

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 und Kosteneffizienz optimal bleiben, gelten für die codmod-Bewertungs-Engine die folgenden Richtlinien für Skalierung und Archivierung:

  • Maximale Größe der Codebasis: Ungefähr 6 Millionen Codezeilen (LOC) pro Bewertungsjob. Wenn Ihr Repository mehr als 6 Millionen Zeilen Code enthält, teilen Sie die Codebasis vor dem Hochladen in kleinere, unabhängige Lösungen oder Module auf.
  • Saubere Archivstruktur: Schließen Sie kompilierte Binärdateien, Paket-Caches und Metadaten zur Versionsverwaltung (z. B. bin/, obj/, node_modules/, .vs/ und .git/) aus Ihrer ZIP-Datei aus, damit nur Quelldateien und Build-Konfigurationen analysiert werden.

.NET-Quellarchiv vorbereiten und hochladen

Verpacken Sie Ihre .NET-Codebasis als ZIP-Datei, die keine Build-Ausgaben enthält, und laden Sie die Datei in einen Cloud Storage-Bucket in Ihrem Projekt hoch.

  1. 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*" "*/bin/*" "*/obj/*" "*/node_modules/*" "*.vs/*"
      
  2. 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.zip
    

    Ersetzen Sie INPUT_BUCKET durch den Namen Ihres Cloud Storage-Ziel-Buckets.

Bewertung ausführen

So führen Sie einen Bewertungsjob aus:

  1. Rufen Sie in der Console die Seite Modernization Hub auf.

    Zum Modernization Hub

  2. Suchen Sie auf der Landingpage die Karte .NET-Modernisierung und klicken Sie auf Bewertung starten.

  3. Geben Sie im Feld Jobname einen eindeutigen Namen für den Bewertungsjob ein.

  4. Wählen Sie im Feld Speicherort des Quellcodes einen Cloud Storage-Bucket aus, der Ihren Quellcode als ZIP-Datei enthält.

  5. Wählen Sie im Feld Berichtsspeicherort einen Cloud Storage-Bucket aus, um die generierten Bewertungsberichte zu speichern.

  6. Wählen Sie in der Liste Modernisierungsrezept ein Modernisierungsrezept aus.

  7. Wählen Sie in der Liste Standort eine Region für den Bewertungsjob aus.

  8. 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.

  9. Klicken Sie auf Bericht generieren.

    In der Console wird ein Hintergrundbewertungscontainer gestartet, um Ihr Projekt zu analysieren. Der Jobstatus wird in der Tabelle Bewertungsverlauf angezeigt.

Jobstatus überwachen und Berichte ansehen

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 rufen Sie die Bewertungsergebnisse auf:

  1. Suchen Sie in der Tabelle Bewertungsverlauf auf der Seite „Modernization Hub“ nach Ihrem Bewertungsjob.
  2. Wenn sich die Spalte Status in Abgeschlossen ändert, klicken Sie auf Bericht herunterladen.
  3. Wählen Sie das gewünschte Ausgabeformat aus:
    • HTML-Bericht: Eine interaktive Zusammenfassung, mit der Sie inkompatible Windows-APIs filtern, dateispezifische Blockerlisten 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 Bewertungsbericht wird die Migrationsbereitschaft Ihrer Anwendung in die folgenden Bereiche kategorisiert:

  • Gesamtkompatibilitätswert: Der Prozentsatz der Quellzeilen und Abhängigkeiten, die ohne Änderungen zu plattformübergreifendem .NET migriert werden können.
  • Aufschlüsselung der Blocker: Spezifische Windows-Abhängigkeiten, die refaktoriert werden müssen, z. B.:
    • WCF-Serverimplementierungen (Windows Communication Foundation)
    • ASP.NET Web Forms- oder ASP.NET MVC-Legacy-Pipelines.
    • Windows-Registrierungsaufrufe (Microsoft.Win32).
  • NuGet-Abhängigkeitsanalyse: Ein detailliertes Inventar vorhandener NuGet-Pakete, das angibt, ob jedes Paket die Ziel-.NET-Version unterstützt oder ersetzt werden muss.
  • Empfohlene Maßnahmen: Vorgeschlagene Codetransformationen und Migrationspfade, um Ihre Anwendung auf die Containerisierung in Google Cloudvorzubereiten.

.NET-Code mit Antigravity refaktorieren

Nachdem Sie einen Bewertungsbericht erstellt haben, können Sie Antigravity mit spezialisierten .NET-Agentic-Skills verwenden, um die Codekonvertierung von .NET Framework zu plattformübergreifendem .NET zu automatisieren.

Bevor Sie agentische Refaktorierungs-Workflows ausführen, müssen die folgenden Voraussetzungen erfüllt sein:

  • Antigravity-Umgebung: Installieren Sie die Antigravity IDE oder die Antigravity CLI (agy) und konfigurieren Sie die Authentifizierung mit Ihrem Google Cloud Projekt.
  • Bewertungsartefakte: Laden Sie Ihren codmod-Bewertungsbericht herunter und legen Sie ihn in Ihrem lokalen Repository-Arbeitsbereich ab, damit der Agent auf identifizierte Blockierungen und Upgrade-Pfade für Abhängigkeiten verweisen kann.
  • .NET-Modernisierungs-Skills: Laden Sie den .NET-Modernisierungs-Skill codmod (SKILL.md) in Ihre Antigravity-Arbeitsbereichseinstellungen. Wenn Sie Vorabzugriff auf die neuesten Agent-Skills für die .NET-Modernisierung anfordern möchten, wenden Sie sich an modernization-hub-feedback-external@google.com.

Nächste Schritte