Avaliar aplicativos Java para modernização

Nesta página, mostramos como usar o Google Cloud Modernization Hub no console doGoogle Cloud para avaliar aplicativos Java corporativos para conteinerização e modernização do Linux para versões de suporte de longo prazo (LTS) do Java multiplataforma (como Java 17 ou Java 21) no Google Cloud.

Muitos aplicativos Java empresariais dependem de APIs Java EE legadas, configurações de servidor de aplicativos proprietárias (como WebLogic, WebSphere ou JBoss) ou bibliotecas de terceiros desatualizadas que impedem a implantação direta em contêineres do Linux. Uma avaliação automatizada no Modernization Hub analisa seu código-fonte, identifica bloqueadores de migração, avalia a compatibilidade de dependências do Maven ou do Gradle e recomenda caminhos de refatoração para o Cloud Run ou o Google Kubernetes Engine.

Para executar avaliações no computador local ou personalizar seções de relatório personalizado usando a CLI codmod independente, consulte Criar uma avaliação de modernização de apps.

Quando usar uma avaliação de aplicativo Java

Execute uma avaliação de aplicativo Java quando planejar fazer o seguinte:

  • Mudar de plataforma para contêineres do Linux: identifique dependências específicas do ambiente (como acesso ao sistema de arquivos local, bibliotecas JNI ou APIs de servidor de aplicativos proprietárias) antes de conteinerizar aplicativos para o Cloud Run ou o GKE.
  • Fazer upgrade das versões do ambiente de execução do Java: avalie o esforço e as lacunas de compatibilidade ao migrar do Java 8 ou Java 11 para versões modernas do Java LTS (Java 17 ou Java 21) ou ao fazer a transição do Java EE (javax.*) para o Jakarta EE (jakarta.*).
  • Desacoplamento de arquiteturas monolíticas: descubra componentes EJB com acoplamento rígido, agentes de mensagens JMS ou implantações monolíticas de WAR e EAR que precisam de refatoração em microsserviços nativos da nuvem ou aplicativos Spring Boot.

Antes de começar

Antes de iniciar um job de avaliação do Java no console, ative as APIs necessárias, verifique as permissões do Identity and Access Management (IAM) do projeto, registre um bucket de configurações do espaço de trabalho e faça upload do arquivo de código-fonte para o Cloud Storage.

Ativar APIs obrigatórias

Para usar o Modernization Hub, ative as APIs de serviço Google Cloud necessárias no seu projeto:

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

Substitua PROJECT_ID pelo ID do projeto Google Cloud .

Funções exigidas

Para executar uma avaliação, são necessárias permissões distintas do IAM para duas identidades que usam o Cloud Build e a Gemini Enterprise Agent Platform:

  • Usuário autenticado do console (iniciando o job e acessando buckets):
    • Administrador do Storage (roles/storage.admin)
    • Usuário da conta de serviço (roles/iam.serviceAccountUser)
    • Editor do Cloud Build (roles/cloudbuild.builds.editor)
  • Conta de serviço dedicada (executando o contêiner de avaliação):
    • Usuário da Agent Platform (roles/aiplatform.user)
    • Usuário de objetos do Storage (roles/storage.objectUser) ou Administrador do Storage (roles/storage.admin)

Para receber as permissões necessárias para iniciar uma avaliação e executar o contêiner de análise, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

  • Usuário: gerenciar arquivos de origem e configurações de bucket: Administrador do Storage (roles/storage.admin)
  • Usuário: anexar a conta de serviço dedicada ao job: Usuário da conta de serviço (roles/iam.serviceAccountUser)
  • Usuário: enviar jobs de avaliação (cloudbuild.builds.create) e visualizar registros: Editor do Cloud Build (roles/cloudbuild.builds.editor)
  • Conta de serviço: execute o contêiner codmod: Usuário da Agent Platform (roles/aiplatform.user)
  • Conta de serviço: ler arquivos de origem e gravar relatórios de avaliação: Usuário de objetos do Storage (roles/storage.objectUser) ou Administrador do Storage (roles/storage.admin)

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para iniciar uma avaliação e executar o contêiner de análise. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para iniciar uma avaliação e executar o contêiner de análise:

  • Usuário (Cloud Storage, Cloud Build e IAM):
    • storage.objects.get (para baixar ou ler arquivos)
    • storage.objects.list (para listar arquivos no bucket)
    • storage.objects.create (para fazer upload ou criar arquivos)
    • storage.objects.update (para modificar metadados de arquivos atuais)
    • storage.objects.delete (para excluir ou substituir arquivos)
    • storage.buckets.get (Ver configurações no nível do bucket)
    • cloudbuild.builds.create (para enviar jobs de avaliação)
    • iam.serviceAccounts.actAs (para anexar a conta de serviço ao job)
  • Conta de serviço (Agent Platform e Cloud Storage):
    • aiplatform.endpoints.predict (para executar a análise de código assistida por IA)
    • storage.objects.get (para ler ou fazer o download de arquivos de origem)
    • storage.objects.list (para listar arquivos na pasta de entrada)
    • storage.objects.create (para escrever relatórios de avaliação)
    • storage.objects.delete (para excluir arquivos temporários)

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Configurar um bucket de configurações do espaço de trabalho

Registre um bucket designado do Cloud Storage na página Modernization Hub > Configurações (por exemplo, gs://PROJECT_ID-modernization-hub) para armazenar os arquivos de estado binário do espaço de trabalho (dotnet_jobs.pb, java_jobs.pb e mainframe_jobs.pb).

Analisar os limites de tamanho da base de código

Para manter o desempenho ideal, o mecanismo de avaliação do codmod aplica as seguintes diretrizes de escalonamento e arquivamento:

  • Tamanho máximo da base de código: aproximadamente seis milhões de linhas de código (LOC) por job de avaliação. Se o repositório exceder seis milhões de LOC, divida a base de código em módulos ou serviços menores e independentes antes de fazer o upload.
  • Estrutura de arquivo limpa: exclua binários compilados, caches de pacotes e metadados de controle de versões (como target/, build/, bin/, node_modules/ e .git/) do arquivo ZIP para que apenas os arquivos de origem e as configurações do build sejam analisados.

Preparar e fazer upload do arquivo de origem Java

Empacote sua base de código Java como um arquivo ZIP que exclui as saídas de build e faça upload do arquivo para um bucket do Cloud Storage no seu projeto.

  1. Na máquina local, crie um arquivo ZIP do repositório usando um dos seguintes métodos:

    • Usando o Git (recomendado):

      git archive --format=zip -o repository.zip HEAD
      
    • Como usar a CLI zip:

      zip -r repository.zip . \
          -x "*.git*" "*/target/*" "*/build/*" "*/bin/*" "*/node_modules/*"
      
  2. Faça upload do arquivo ZIP para o bucket de destino do Cloud Storage usando a Google Cloud CLI:

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

    Substitua INPUT_BUCKET pelo nome do bucket do Cloud Storage de destino.

Fazer uma avaliação

Para iniciar um job de avaliação no Modernization Hub, siga estas etapas:

  1. No console, acesse a página Modernization Hub.

    Acessar o Modernization Hub

  2. Na página de destino, localize o card Cargas de trabalho Java e clique em Iniciar avaliação.

  3. No campo Nome do job, insira um nome exclusivo para o job de avaliação.

  4. No campo Local do código-fonte, selecione um bucket do Cloud Storage que contenha o código-fonte como um arquivo ZIP.

  5. No campo Local do relatório, selecione um bucket do Cloud Storage para salvar os relatórios de avaliação gerados.

  6. Na lista Receita de modernização, selecione uma receita de modernização.

  7. Na lista Local, selecione uma região para o job de avaliação.

  8. No campo Conta de serviço, selecione uma conta de serviço dedicada com os papéis do IAM necessários listados na seção Papéis necessários. O Cloud Build executa o job de avaliação nessa conta de serviço, que requer permissões de usuário da Agent Platform e do Cloud Storage.

  9. Clique em Gerar relatório.

    O console inicia um contêiner de avaliação em segundo plano executando o mecanismo codmod para analisar seu projeto. O status do job aparece na tabela Histórico de avaliação.

Analisar o relatório de avaliação

Dependendo do tamanho da base de código, os jobs de avaliação geralmente são concluídos em alguns minutos. O contêiner em segundo plano é encerrado automaticamente após o processamento.

Para acessar os resultados da avaliação:

  1. Na tabela Histórico de avaliação na página do Modernization Hub, localize seu job de avaliação.
  2. Quando a coluna Status mudar para Concluído, clique em Fazer o download do relatório.
  3. Selecione o formato de saída de sua preferência:
    • Relatório HTML: um resumo interativo que permite filtrar APIs incompatíveis, inspecionar listas de bloqueadores arquivo por arquivo e ver sugestões de correção.
    • Relatório de markdown: um resumo executivo formatado adequado para compartilhar com as partes interessadas e os conselhos de revisão de arquitetura.

Analisar o relatório de avaliação

O relatório de avaliação gerado categoriza a prontidão para migração do aplicativo em várias áreas principais:

  • Pontuação geral de compatibilidade: a porcentagem de linhas de origem e dependências que podem migrar para o ambiente de execução do Java de destino sem modificações.
  • Detalhamento dos bloqueadores: dependências legadas específicas do Java ou restrições de ambiente que exigem refatoração, como:
    • Mudanças de namespace do Java EE (javax.*) para o Jakarta EE (jakarta.*).
    • APIs internas do JDK removidas ou descontinuadas (como pacotes sun.misc.* ou módulos CORBA).
    • Configurações ou APIs de servidor de aplicativos proprietárias (como descritores de implantação do WebLogic, WebSphere ou JBoss).
  • Análise de dependência: um inventário detalhado das dependências atuais do Maven ou do Gradle que indica se cada biblioteca é compatível com a versão de ambiente de execução do Java de destino ou se requer um upgrade.
  • Ações recomendadas: transformações de código sugeridas, receitas de refatoração assistidas por IA e caminhos de migração gerados pelo codmod para preparar seu aplicativo para conteinerização no Google Cloud.

A seguir