Trabalhando com a avaliação: guia abrangente da avaliação de aplicativos com a Modernização do Aplicativo Copilot do GitHub para Java

Este guia abrangente aborda os recursos de avaliação avançada na modernização do aplicativo GitHub Copilot para ajudá-lo a maximizar o valor do processo de avaliação de modernização do aplicativo.

A avaliação do aplicativo é uma primeira etapa crítica em seu percurso de modernização. Este artigo aborda o fluxo de trabalho de avaliação completo para ajudá-lo a trabalhar efetivamente com relatórios de avaliação, configurar avaliações para diferentes cenários e gerenciar dados de avaliação em todo o processo de modernização.

Configurar antes de executar a avaliação

Antes de executar a avaliação, configure a avaliação selecionando Configurar Avaliação no painel avaliação de modernização do aplicativo GitHub Copilot.

Propriedades de configuração

Atualmente, você pode configurar as propriedades e targetcapabilityos as modepropriedades da avaliação.

Por padrão, a avaliação é executada com o AKS (Serviço de Kubernetes do Azure), o Serviço de Aplicativo do Azure e os Aplicativos de Contêiner do Azure (ACA) como destinos de serviço.

• target: o serviço de computação do Azure no qual executar os aplicativos. Escolha vários destinos se você ainda não decidiu qual deles usar. Em seguida, você pode comparar os destinos no relatório de avaliação.

  Value	Description
  azure-aks	Práticas recomendadas para implantar um aplicativo no Serviço de Kubernetes do Azure.
  azure-appservice	Práticas recomendadas para implantar um aplicativo no Serviço de Aplicativo do Azure.
  azure-container-apps	Práticas recomendadas para implantar um aplicativo nos Aplicativos de Contêiner do Azure.

• capability: a tecnologia de destino para a qual modernizar os aplicativos.

  Value	Description
  containerization	Práticas recomendadas para a conteinerização de aplicativos.
  openjdk11	Práticas recomendadas para migrar para o OpenJDK 11.
  openjdk17	Práticas recomendadas para migrar para o OpenJDK 17.
  openjdk21	Práticas recomendadas para migrar para o OpenJDK 21.

• os: o sistema operacional de destino no qual executar os aplicativos.

  Value	Description
  linux	Práticas recomendadas para migrar aplicativos para a plataforma Linux.
  windows	Práticas recomendadas para migrar aplicativos para a plataforma Windows.

• mode: o modo de análise.

  Value	Description
  issue-only	Analise o código-fonte para detectar apenas problemas.
  source-only	Analise o código-fonte para detectar problemas e tecnologias usadas.
  full	Analise o código-fonte para detectar problemas e tecnologias usadas e listar dependências.

Exemplos

Os exemplos a seguir descrevem algumas configurações:

• Exemplo um: você gostaria de migrar seus aplicativos para o AKS como contêineres linux e deseja entender quais são os problemas a serem corrigidos. Use a seguinte configuração:

  appcat:
  - target:
      - azure-aks
    os:
      - linux
    mode: issue-only
  

• Exemplo dois: você gostaria de migrar seus aplicativos para o Serviço de Aplicativo Linux e deseja entender quais são os problemas a serem corrigidos. Use a seguinte configuração:

  appcat:
  - target:
      - azure-appservice
    os:
      - linux
    mode: issue-only
  

• Exemplo três: você gostaria de modernizar seus aplicativos para o JDK21 e deseja entender quais são os problemas a serem corrigidos. Use a seguinte configuração:

  appcat:
  - capability:
      - openjdk21
    mode: issue-only
  

Depois que a ferramenta executa uma avaliação, o painel interativo é aberto automaticamente, fornecendo resultados de análise abrangentes. Depois de configurar vários destinos de serviço do Azure, você pode alternar facilmente entre eles para comparar abordagens de migração e exibir recomendações específicas do serviço.

Interpretar o relatório de avaliação

O relatório de avaliação fornece resultados de análise abrangentes para ajudá-lo a entender a preparação do aplicativo para a migração e modernização do Azure. Esta seção orienta você pela estrutura do relatório e ajuda você a interpretar as descobertas para tomar decisões de migração informadas.

Visão geral da estrutura do relatório

O relatório de avaliação consiste em várias seções principais:

• Informações do aplicativo: informações básicas sobre seu aplicativo, incluindo versão java, estruturas, ferramentas de build, estrutura de projeto e serviço de destino do Azure.
• Resumo do Problema: Visão geral dos problemas de migração categorizados pelo domínio com percentuais de criticidade.
• Análise Detalhada: o relatório de detalhes é organizado nas quatro subseções a seguir.
  • Problemas: fornece um resumo conciso de todos os problemas que exigem atenção.
  • Dependências: exibe todas as dependências empacotadas em Java encontradas no aplicativo.
  • Tecnologias: exibe todas as bibliotecas inseridas agrupadas por funcionalidade, permitindo que você exiba rapidamente as tecnologias usadas no aplicativo.
  • Insights: exibe detalhes e informações do arquivo para ajudá-lo a entender as tecnologias detectadas.

Problemas

Acesse esta parte selecionando a guia Problemas . Essa guia fornece uma lista de problemas categorizados de vários aspectos do Cloud Readiness e da Atualização java que você precisa abordar para migrar com êxito o aplicativo para o Azure. As tabelas a seguir descrevem os valores domínio e criticidade :

Domínio	Description
Preparação para a nuvem	Avalia as dependências do aplicativo para sugerir serviços do Azure e garantir a preparação nativa da nuvem.
Atualização do Java	Identifica problemas de JDK e estrutura para atualização de versão.

Severidade	Description
Obrigatório	Problemas que devem ser corrigidos para migração para o Azure.
Potencial	Problemas que podem afetar a migração e precisam de revisão.
Opcional	Problemas de baixo impacto. Corrigi-los é recomendado, mas opcional.

Para obter mais informações, você pode expandir cada problema relatado selecionando o título. Esse relatório fornece as seguintes informações:

• Uma lista de arquivos em que os incidentes ocorreram, juntamente com o número de linhas de código afetadas. Se o arquivo for um arquivo de origem Java, selecionar o número da linha de arquivo direcionará você para o relatório de origem correspondente.
• Uma descrição detalhada do problema. Essa descrição descreve o problema, fornece soluções conhecidas e faz referência à documentação de suporte sobre o problema ou a resolução.

Dependências

Acesse essa parte selecionando a guia Dependências . Essa guia exibe todas as dependências empacotadas em Java encontradas no aplicativo.

Tecnologias

Acesse esta parte selecionando a guia Tecnologias . Essa guia lista as ocorrências de tecnologias, agrupadas por função, no aplicativo analisado. Este relatório é uma visão geral das tecnologias encontradas no aplicativo e foi projetado para ajudá-lo a entender rapidamente a finalidade de cada aplicativo.

Insights

Acesse esta parte selecionando a guia Insights . Exibe detalhes e informações do arquivo para ajudá-lo a entender as tecnologias detectadas.

Executar relatório de avaliação

O gerenciamento efetivo de relatórios permite a colaboração, mantém o histórico de avaliação e se integra aos fluxos de trabalho existentes.

Importar relatório de avaliação

Além de executar a avaliação diretamente na modernização do aplicativo GitHub Copilot, você também pode importar relatórios de avaliação. Os relatórios podem vir dos resultados da CLI do AppCAT , como report.json, um relatório exportado de modernização do aplicativo GitHub Copilot ou um arquivo de contexto de aplicativo do Dr. Migrate.

Para importar um relatório de avaliação para a modernização do aplicativo GitHub Copilot, selecione Importar na seção de avaliação ou pressione Ctrl+Shift+P e procure o relatório de avaliação de importação.

Relatório de avaliação de exportação

No painel de avaliação, você pode exibir os problemas detectados pelo AppCAT e escolher a solução de migração para determinar a decisão. Você pode exportar o relatório e compartilhá-lo com outras pessoas. Nesse caso, outras pessoas não precisam executar a avaliação sozinhas e podem importar o relatório e exibir diretamente a avaliação e a decisão de migração.

Para exportar um relatório de avaliação da modernização do aplicativo GitHub Copilot, clique com o botão direito do mouse no Relatório de Avaliação e selecione Exportar na seção de avaliação ou pressione Ctrl+Shift+P e pesquise o relatório de avaliação de exportação.

Excluir relatório de avaliação

Se você não quiser mais o relatório, poderá optar por excluí-lo.

Para remover um relatório de avaliação, clique com o botão direito do mouse no Relatório de Avaliação e selecione Excluir.

Próxima etapa

Início Rápido: criar e aplicar suas próprias tarefas