Questa pagina descrive come utilizzare Google Cloud Modernization Hub per valutare le applicazioni ASP.NET e .NET Framework per la containerizzazione e la modernizzazione di Linux in una release .NET multipiattaforma.
Molte applicazioni .NET aziendali dipendono da API specifiche di Windows, configurazioni del server IIS o librerie .NET Framework legacy che impediscono il deployment diretto nei container Linux. Una valutazione automatizzata in Modernization Hub analizza il codice sorgente per identificare i blocchi, valutare la compatibilità dei pacchetti NuGet e consigliare percorsi di refactoring per Cloud Run o Google Kubernetes Engine.
Per eseguire valutazioni dal tuo computer locale o personalizzare le sezioni dei report utilizzando l'interfaccia a riga di comando codmod autonoma, consulta Crea un'App Modernization Assessment.
Quando utilizzare una valutazione delle applicazioni .NET
Esegui una valutazione dell'applicazione .NET quando prevedi di eseguire una delle seguenti attività di modernizzazione:
- Cambio di piattaforma ai container Linux: identifica le dipendenze solo per Windows (come l'accesso al registro di Windows,
System.Drawingo le integrazioni di Active Directory) prima di containerizzare le applicazioni per Cloud Run o GKE. - Upgrade delle versioni di .NET Framework: valuta l'impegno e le lacune di compatibilità durante la migrazione da .NET Framework 4.x alle versioni .NET moderne e multipiattaforma (.NET 10 o versioni successive).
- Disaccoppiamento delle architetture monolitiche: scopri servizi WCF, servizi Windows o moduli web legacy ad alto accoppiamento che richiedono il refactoring in microservizi cloud-native.
Prima di iniziare
Prima di avviare un job di valutazione .NET, abilita le API richieste, verifica le autorizzazioni di Identity and Access Management (IAM) del progetto, registra un bucket delle impostazioni dell'area di lavoro e carica l'archivio del codice sorgente in Cloud Storage.
Abilita le API richieste
Per utilizzare Modernization Hub, abilita le API di servizio Google Cloud richieste nel tuo progetto:
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
Sostituisci PROJECT_ID con l'ID progetto Google Cloud .
Ruoli obbligatori
L'esecuzione di una valutazione richiede autorizzazioni IAM distinte per due identità che utilizzano Cloud Build e Gemini Enterprise Agent Platform:
- Utente della console autenticato (avvia il job e accede ai bucket):
- Storage Admin (
roles/storage.admin) - Service Account User (
roles/iam.serviceAccountUser) - Cloud Build Editor (
roles/cloudbuild.builds.editor)
- Storage Admin (
- Service account di servizio (che esegue il container di valutazione):
- Agent Platform User
(
roles/aiplatform.user) - Storage Object User (
roles/storage.objectUser) o Storage Admin (roles/storage.admin)
- Agent Platform User
(
Per ottenere le autorizzazioni necessarie per avviare una valutazione ed eseguire il container di analisi, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Utente: gestisce gli archivi di origine e le configurazioni dei bucket: Storage Admin (
roles/storage.admin) -
Utente: collega il account di servizio dedicato al job:
Service Account User (
roles/iam.serviceAccountUser) -
Utente: invia job di valutazione (
cloudbuild.builds.create) e visualizza i log: Cloud Build Editor (roles/cloudbuild.builds.editor) -
Service account: esegui il container
codmod: Agent Platform User (roles/aiplatform.user) -
Service account: leggi gli archivi di origine e scrivi i report di valutazione: Storage Object User (
roles/storage.objectUser) o Storage Admin (roles/storage.admin)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questi ruoli predefiniti contengono le autorizzazioni necessarie per avviare una valutazione ed eseguire il container di analisi. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per avviare una valutazione ed eseguire il container di analisi sono necessarie le seguenti autorizzazioni:
-
Utente (Cloud Storage, Cloud Build e IAM):
-
storage.objects.get(per scaricare o leggere i file) -
storage.objects.list(per elencare i file all'interno del bucket) -
storage.objects.create(per caricare o creare nuovi file) -
storage.objects.update(per modificare i metadati dei file esistenti) -
storage.objects.delete(per eliminare o sovrascrivere i file) -
storage.buckets.get(Visualizza le configurazioni a livello di bucket) -
cloudbuild.builds.create(per inviare job di valutazione) -
iam.serviceAccounts.actAs(per collegare il account di servizio al job)
-
-
Service account (Agent Platform e Cloud Storage):
-
aiplatform.endpoints.predict(per eseguire l'analisi del codice assistita dall'AI) -
storage.objects.get(per leggere o scaricare gli archivi di origine) -
storage.objects.list(per elencare i file nella cartella di input) -
storage.objects.create(per scrivere report di valutazione) -
storage.objects.delete(per eliminare i file temporanei)
-
Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Configura un bucket delle impostazioni dell'area di lavoro
Registra un bucket Cloud Storage designato nella pagina Modernization Hub > Impostazioni (ad esempio gs://PROJECT_ID-modernization-hub) per archiviare i file di stato binari dello spazio di lavoro (dotnet_jobs.pb, java_jobs.pb e mainframe_jobs.pb).
Esamina i limiti delle dimensioni del codebase
Per mantenere prestazioni e un'efficienza dei costi ottimali, il motore di valutazione codmod applica le seguenti linee guida per la scalabilità e l'archiviazione:
- Dimensioni massime del codebase: circa 6 milioni di righe di codice (LOC) per job di valutazione. Se il tuo repository supera i 6 milioni di LOC, suddividi la codebase in soluzioni o moduli più piccoli e indipendenti prima di caricarla.
- Struttura dell'archivio pulita: escludi i file binari compilati, le cache dei pacchetti e i metadati di controllo della versione (come
bin/,obj/,node_modules/,.vs/e.git/) dal file ZIP in modo che vengano analizzati solo i file di origine e le configurazioni di build.
Prepara e carica l'archivio di origine .NET
Crea un pacchetto del codebase .NET come file ZIP che esclude gli output di build e carica il file in un bucket Cloud Storage nel tuo progetto.
Sulla tua macchina locale, crea un file ZIP del tuo repository utilizzando uno dei seguenti metodi:
Utilizzo di Git (consigliato):
git archive --format=zip -o repository.zip HEAD
Utilizzo dell'interfaccia a riga di comando
zip:zip -r repository.zip . \ -x "*.git*" "*/bin/*" "*/obj/*" "*/node_modules/*" "*.vs/*"
Carica il file ZIP nel bucket Cloud Storage di destinazione utilizzando Google Cloud CLI:
gcloud storage cp repository.zip \ gs://INPUT_BUCKET/codebase/repository.zipSostituisci INPUT_BUCKET con il nome del bucket Cloud Storage di destinazione.
Esegui un test
Per eseguire un job di valutazione, segui questi passaggi:
Nella console, vai alla pagina Modernization Hub.
Nella pagina di destinazione, individua la scheda Modernizzazione .NET e fai clic su Avvia valutazione.
Nel campo Nome job, inserisci un nome univoco per il job di valutazione.
Nel campo Posizione del codice sorgente, seleziona un bucket Cloud Storage contenente il codice sorgente come file ZIP.
Nel campo Località report, seleziona un bucket Cloud Storage per salvare i report di valutazione generati.
Dall'elenco Ricetta di modernizzazione, seleziona una ricetta di modernizzazione.
Dall'elenco Località, seleziona una regione per il job di valutazione.
Nel campo Service account, seleziona un account di servizio dedicato con i ruoli IAM richiesti elencati nella sezione Ruoli richiesti. Cloud Build esegue il job di valutazione con questo account di servizio, che richiede le autorizzazioni Agent Platform User e Cloud Storage.
Fai clic su Genera report.
La console avvia un container di valutazione in background per analizzare il progetto. Lo stato del job viene visualizzato nella tabella Cronologia delle valutazioni.
Monitora lo stato dei job e visualizza i report
A seconda delle dimensioni del codebase, i job di valutazione in genere vengono completati entro pochi minuti. Il container in background termina automaticamente al termine dell'elaborazione.
Per visualizzare i risultati della valutazione, segui questi passaggi:
- Nella tabella Cronologia delle valutazioni della pagina Modernization Hub, individua il job di valutazione.
- Quando la colonna Stato cambia in Completato, fai clic su Scarica report.
- Seleziona il formato di output che preferisci:
- Report HTML: un riepilogo interattivo che consente di filtrare le API Windows incompatibili, esaminare gli elenchi di blocco file per file e visualizzare i suggerimenti per la correzione.
- Report Markdown: un riepilogo esecutivo formattato adatto alla condivisione con gli stakeholder e i comitati di revisione dell'architettura.
Esamina il report di valutazione
Il report di valutazione classifica l'idoneità alla migrazione della tua applicazione nelle seguenti aree:
- Punteggio di compatibilità complessivo: la percentuale di righe di origine e dipendenze di cui è possibile eseguire la migrazione a .NET multipiattaforma senza modifiche.
- Analisi dei fattori di blocco: dipendenze Windows specifiche che richiedono il refactoring, ad esempio:
- Implementazioni di server Windows Communication Foundation (WCF).
- Pipeline legacy ASP.NET Web Forms o ASP.NET MVC.
- Chiamate al Registro di sistema di Windows (
Microsoft.Win32).
- Analisi delle dipendenze NuGet: un inventario dettagliato dei pacchetti NuGet esistenti che indica se ogni pacchetto supporta la versione .NET di destinazione o richiede la sostituzione.
- Azioni consigliate: trasformazioni del codice e percorsi di migrazione suggeriti per preparare l'applicazione alla containerizzazione su Google Cloud.
Rifattorizza il codice .NET con Antigravity
Dopo aver generato un report di valutazione, puoi utilizzare Antigravity con skill agentiche .NET specializzate per automatizzare la conversione del codice da .NET Framework a .NET multipiattaforma.
Prima di eseguire i workflow di refactoring agentico, assicurati di soddisfare i seguenti prerequisiti:
- Ambiente Antigravity: installa
Antigravity IDE o Antigravity CLI (
agy) e configura l'autenticazione con il tuo progetto Google Cloud . - Artefatti di valutazione: scarica il report di valutazione di
codmode inseriscilo nell'area di lavoro del repository locale in modo che l'agente possa fare riferimento ai blocchi identificati e ai percorsi di upgrade delle dipendenze. - Skill di modernizzazione .NET: carica la skill di modernizzazione .NET
codmod(SKILL.md) nelle impostazioni del workspace di Antigravity. Per richiedere l'accesso in anteprima alle skill più recenti dell'agente di modernizzazione .NET, contatta modernization-hub-feedback-external@google.com.
Passaggi successivi
- Scopri come creare un App Modernization Assessment con l'interfaccia a riga di comando
codmod. - Scopri come valutare le applicazioni Java.
- Scopri come configurare Mainframe Assessment Tool (MAT).
- Esplora la trasformazione del codice assistita dall'AI utilizzando Gemini Cloud Assist.