Évaluer les applications Java pour la modernisation

Cette page vous explique comment utiliser Google Cloud Modernization Hub dans la consoleGoogle Cloud pour évaluer les applications Java d'entreprise en vue de la conteneurisation Linux et de la modernisation vers des versions Java LTS (Long-Term Support) multiplateformes (telles que Java 17 ou Java 21) sur Google Cloud.

De nombreuses applications Java d'entreprise dépendent d'anciennes API Java EE, de configurations de serveur d'applications propriétaires (telles que WebLogic, WebSphere ou JBoss) ou de bibliothèques tierces obsolètes qui empêchent le déploiement direct sur des conteneurs Linux. Une évaluation automatisée dans Modernization Hub analyse votre code source, identifie les obstacles à la migration, évalue la compatibilité des dépendances Maven ou Gradle, et recommande des chemins de refactorisation pour Cloud Run ou Google Kubernetes Engine.

Pour exécuter des évaluations depuis votre ordinateur local ou personnaliser des sections de rapport à l'aide de la CLI codmod autonome, consultez Créer une évaluation de modernisation d'application.

Quand utiliser une évaluation d'application Java ?

Exécutez une évaluation d'application Java lorsque vous prévoyez d'effectuer l'une des opérations suivantes :

  • Changer de plate-forme pour passer à des conteneurs Linux : identifiez les dépendances spécifiques à l'environnement (telles que l'accès au système de fichiers local, les bibliothèques JNI ou les API de serveur d'applications propriétaires) avant de conteneuriser les applications pour Cloud Run ou GKE.
  • Mettre à niveau les versions de l'environnement d'exécution Java : évaluez l'effort et les écarts de compatibilité lors de la migration de Java 8 ou Java 11 vers des versions LTS Java modernes (Java 17 ou Java 21), ou lors de la transition de Java EE (javax.*) vers Jakarta EE (jakarta.*).
  • Découplage des architectures monolithiques : découvrez les composants EJB à couplage fort, les agents de messages JMS ou les déploiements WAR et EAR monolithiques qui nécessitent une refactorisation en microservices cloud natifs ou en applications Spring Boot.

Avant de commencer

Avant de lancer un job d'évaluation Java dans la console, activez les API requises, vérifiez les autorisations IAM (Identity and Access Management) de votre projet, enregistrez un bucket de paramètres d'espace de travail et importez votre archive de code source dans Cloud Storage.

Activer les API requises

Pour utiliser Modernization Hub, activez les API de service Google Cloudrequises dans votre projet :

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

Remplacez PROJECT_ID par l'ID du projet Google Cloud .

Rôles requis

L'exécution d'une évaluation nécessite des autorisations IAM distinctes pour deux identités utilisant Cloud Build et Gemini Enterprise Agent Platform :

  • Utilisateur de la console authentifié (qui lance le job et accède aux buckets) :
    • Administrateur de l'espace de stockage (roles/storage.admin)
    • Utilisateur du compte de service (roles/iam.serviceAccountUser)
    • Éditeur Cloud Build (roles/cloudbuild.builds.editor)
  • Compte de service dédié (exécutant le conteneur d'évaluation) :
    • Utilisateur Agent Platform (roles/aiplatform.user)
    • Utilisateur d'objets Storage (roles/storage.objectUser) ou Administrateur de l'espace de stockage (roles/storage.admin)

Pour obtenir les autorisations nécessaires pour lancer une évaluation et exécuter le conteneur d'analyse, demandez à votre administrateur de vous accorder les rôles IAM suivants sur votre projet :

  • Utilisateur : gérer les archives sources et les configurations de bucket : administrateur de l'espace de stockage (roles/storage.admin)
  • Utilisateur : associez le compte de service dédié au job : Utilisateur du compte de service (roles/iam.serviceAccountUser)
  • Utilisateur : envoyer des jobs d'évaluation (cloudbuild.builds.create) et afficher les journaux : Éditeur Cloud Build (roles/cloudbuild.builds.editor)
  • Compte de service : exécutez le conteneur codmod : utilisateur Agent Platform (roles/aiplatform.user)
  • Compte de service : lire les archives sources et écrire les rapports d'évaluation : Utilisateur d'objets Storage (roles/storage.objectUser) ou Administrateur de l'espace de stockage (roles/storage.admin)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ces rôles prédéfinis contiennent les autorisations requises pour lancer une évaluation et exécuter le conteneur d'analyse. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour lancer une évaluation et exécuter le conteneur d'analyse :

  • Utilisateur (Cloud Storage, Cloud Build et IAM) :
    • storage.objects.get (pour télécharger ou lire des fichiers)
    • storage.objects.list (pour lister les fichiers du bucket)
    • storage.objects.create (pour importer ou créer des fichiers)
    • storage.objects.update (pour modifier les métadonnées de fichiers existants)
    • storage.objects.delete (pour supprimer ou écraser des fichiers)
    • storage.buckets.get (Afficher les configurations au niveau du bucket)
    • cloudbuild.builds.create (pour envoyer des jobs d'évaluation)
    • iam.serviceAccounts.actAs (pour associer le compte de service au job)
  • Compte de service (Agent Platform et Cloud Storage) :
    • aiplatform.endpoints.predict (pour exécuter l'analyse de code assistée par l'IA)
    • storage.objects.get (pour lire ou télécharger des archives sources)
    • storage.objects.list (pour lister les fichiers du dossier d'entrée)
    • storage.objects.create (pour rédiger des rapports d'évaluation)
    • storage.objects.delete (pour supprimer les fichiers temporaires)

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Configurer un bucket de paramètres d'espace de travail

Enregistrez un bucket Cloud Storage désigné sur la page Modernization Hub > Paramètres (par exemple, gs://PROJECT_ID-modernization-hub) pour stocker les fichiers d'état binaire de l'espace de travail (dotnet_jobs.pb, java_jobs.pb et mainframe_jobs.pb).

Examiner les limites de taille du codebase

Pour maintenir des performances optimales, le moteur d'évaluation codmod applique les consignes de scaling et d'archivage suivantes :

  • Taille maximale de la codebase : environ six millions de lignes de code par job d'évaluation. Si votre dépôt dépasse six millions de lignes de code, divisez la codebase en modules ou services plus petits et indépendants avant de l'importer.
  • Structure d'archive propre : excluez les binaires compilés, les caches de packages et les métadonnées de contrôle des versions (comme target/, build/, bin/, node_modules/ et .git/) de votre fichier ZIP afin que seuls les fichiers sources et les configurations de compilation soient analysés.

Préparer et importer votre archive source Java

Empaquetez votre codebase Java sous forme de fichier ZIP excluant les sorties de compilation, puis importez le fichier dans un bucket Cloud Storage de votre projet.

  1. Sur votre ordinateur local, créez un fichier ZIP de votre dépôt à l'aide de l'une des méthodes suivantes :

    • Utiliser Git (recommandé) :

      git archive --format=zip -o repository.zip HEAD
      
    • À l'aide de la CLI zip :

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. Importez le fichier ZIP dans votre bucket Cloud Storage cible à l'aide de la Google Cloud CLI :

    gcloud storage cp repository.zip \
        gs://INPUT_BUCKET/codebase/repository.zip
    

    Remplacez INPUT_BUCKET par le nom de votre bucket Cloud Storage cible.

Exécuter une évaluation

Pour lancer un job d'évaluation dans Modernization Hub, procédez comme suit :

  1. Dans la console, accédez à la page Modernization Hub.

    Accéder au Modernization Hub

  2. Sur la page de destination, recherchez la fiche Charges de travail Java, puis cliquez sur Démarrer l'évaluation.

  3. Dans le champ Nom du job, saisissez un nom unique pour votre job d'évaluation.

  4. Dans le champ Emplacement du code source, sélectionnez un bucket Cloud Storage contenant votre code source sous forme de fichier ZIP.

  5. Dans le champ Emplacement du rapport, sélectionnez un bucket Cloud Storage pour enregistrer les rapports d'évaluation générés.

  6. Dans la liste Recette de modernisation, sélectionnez une recette de modernisation.

  7. Dans la liste Emplacement, sélectionnez une région pour votre job d'évaluation.

  8. Dans le champ Compte de service, sélectionnez un compte de service dédié disposant des rôles IAM requis listés dans la section Rôles requis. Cloud Build exécute le job d'évaluation sous l'identité de ce compte de service, qui nécessite les autorisations d'utilisateur Agent Platform et Cloud Storage.

  9. Cliquez sur Générer un rapport.

    La console démarre un conteneur d'évaluation en arrière-plan exécutant le moteur codmod pour analyser votre projet. L'état du job s'affiche dans le tableau Historique des évaluations.

Examiner le rapport d'évaluation

Selon la taille de votre codebase, les jobs d'évaluation se terminent généralement en quelques minutes. Le conteneur d'arrière-plan s'arrête automatiquement une fois le traitement terminé.

Pour accéder aux résultats de votre évaluation :

  1. Dans le tableau Historique des évaluations de la page Modernization Hub, recherchez votre job d'évaluation.
  2. Lorsque la colonne État passe à Terminé, cliquez sur Télécharger le rapport.
  3. Sélectionnez le format de sortie de votre choix :
    • Rapport HTML : résumé interactif qui vous permet de filtrer les API incompatibles, d'inspecter les listes de bloqueurs fichier par fichier et d'afficher des suggestions de correction.
    • Rapport Markdown : synthèse mise en forme, adaptée au partage avec les parties prenantes et les comités d'examen de l'architecture.

Examiner le rapport d'évaluation

Le rapport d'évaluation généré classe l'aptitude à la migration de votre application en plusieurs domaines clés :

  • Score de compatibilité global : pourcentage de lignes sources et de dépendances pouvant migrer vers l'environnement d'exécution Java cible sans modification.
  • Répartition des éléments bloquants : dépendances Java anciennes spécifiques ou contraintes d'environnement nécessitant une refactorisation, telles que :
    • Modifications de l'espace de noms Java EE (javax.*) vers Jakarta EE (jakarta.*).
    • API internes du JDK supprimées ou obsolètes (telles que les packages sun.misc.* ou les modules CORBA).
    • Configurations ou API de serveur d'applications propriétaires (telles que les descripteurs de déploiement WebLogic, WebSphere ou JBoss)
  • Analyse des dépendances : inventaire détaillé des dépendances Maven ou Gradle existantes, indiquant si chaque bibliothèque est compatible avec la version d'exécution Java cible ou si elle nécessite une mise à niveau.
  • Actions recommandées : transformations de code suggérées, recettes de refactorisation assistées par l'IA et chemins de migration générés par codmod pour préparer votre application à la conteneurisation sur Google Cloud.

Étapes suivantes