Usar a habilidade de migração em nuvem do AEM using-cloud-migration-skill
Essa referência aborda cada padrão de migração compatível, como fornecer descobertas de BPA e como gerenciar sessões em um grande projeto. Para obter uma introdução e instruções de configuração, consulte a visão geral.
Como uma sessão funciona workflow-overview
Cada sessão de migração segue esta sequência:
- Nomeie o padrão: especifique um padrão (por exemplo,
scheduler) - Fornecer descobertas: de um arquivo CSV BPA, CAM via MCP ou caminhos de arquivo específicos
- O agente lê as regras de transformação: a habilidade lê o módulo de práticas recomendadas relevantes antes de fazer qualquer alteração de código
- Primeiro lote de cinco: o agente transforma até cinco descobertas e relata o que ele alterou
- Revise e continue: depois de revisar cada lote, responda
continuepara prosseguir para o próximo
O agente processa um padrão e um lote por vez. Ele não continua automaticamente; cada lote requer sua confirmação.
Padrões de migração patterns
Scheduler scheduler
Segmenta classes Java usando injeção de sling.commons.scheduler ou Scheduler que são incompatíveis com o tempo de execução contêiner e sem estado do AEMaaCS.
ID do padrão BPA: scheduler
O agente converte trabalhos inseridos Scheduler em @Component implementações de Runnable usando @Designate, substituindo o registro do agendador baseado em construtor por métodos de ciclo de vida @Activate / @Deactivate.
ResourceChangeListener resource-change-listener
Direciona ResourceChangeListener ou ResourceChange implementações de ouvinte que exigem atualizações para o AEMaaCS.
ID do padrão BPA: resourceChangeListener
Replicação replication
Classes de destino que importam com.day.cq.replication.Replicator ou APIs de replicação relacionadas, que não têm suporte no AEMaaCS. O agente os substitui por equivalentes baseados em ContentDistribution e atualiza as referências de serviço OSGi correspondentes.
ID do padrão BPA: replication
Ouvinte de eventos event-listener
Direciona implementações OSGi EventListener ou EventHandler que devem ser atualizadas para a semântica de processamento de eventos do AEMaaCS.
ID do padrão BPA: eventListener
Manipulador de eventos event-handler
Segmenta serviços OSGi EventHandler síncronos que precisam ser adaptados para AEMaaCS.
ID do padrão BPA: eventHandler
API de ativos asset-api
Classes de destino que usam APIs do DAM obsoletas AssetManager, DAMEvent ou sem suporte. O agente os substitui pelos equivalentes de API compatíveis do AEM Assets.
ID do padrão BPA: assetApi
Lint HTL (data-sly-test) htl-lint
Segmenta modelos HTL em ui.apps que produzem data-sly-test: redundant constant value comparison avisos de linha. O agente descobre os modelos afetados examinando o pacote de conteúdo diretamente; esse padrão não requer uma conexão BPA CSV ou CAM.
ID do padrão BPA: htlLint
htlLint descobertas não aparecem em exportações de CSV BPA. O agente os detecta por meio da varredura direta de arquivos quando você inicia uma sessão para esse padrão.Configurações OSGi para o Cloud Manager osgi-cloud-manager
Converte configurações OSGi em ui.config para o formato .cfg.json compatível com Cloud Manager com manipulação específica de ambiente completo. Abrange duas tarefas relacionadas:
Conversão de formato de configuração
O AEMaaCS exige que as configurações OSGi sejam armazenadas como .cfg.json arquivos, com configurações específicas do ambiente em pastas de escopo de modo de execução (config.author/, config.publish/, config.dev/ e assim por diante). O agente:
- Converte as configurações OSGi existentes de
.config,.cfge formato XML para.cfg.json - Divide as configurações contendo valores específicos do autor e da publicação em arquivos de escopo de modo de execução separados
- Valida tipos de propriedade em relação à especificação de metatipo OSGi (sequências, números inteiros, booleanos, matrizes)
- Sinaliza PIDs de propriedade da Adobe para revisão manual em vez de conversão automática
Segredos e variáveis de ambiente
Move segredos de texto simples e valores específicos do ambiente para fora dos arquivos de configuração confirmados e os substitui por espaços reservados do Cloud Manager:
$[secret:NAME]: para senhas, tokens e outros valores confidenciais$[env:NAME]: para valores não confidenciais que diferem por ambiente (por exemplo, URLs de serviço)
As variáveis e segredos correspondentes são aplicados no Cloud Manager e inseridos no tempo de execução; nenhum valor é armazenado no controle do código-fonte.
Este padrão não usa BPA CSV ou CAM. Iniciar uma sessão com:
Scan my config files and create Cloud Manager environment secrets or variables.
Opções de Source do BPA bpa-source
Tratamento de erros de MCP mcp-errors
Se a conexão MCP retornar um erro (incluindo falhas de projeto não encontrado ou de autenticação), o agente será interrompido e mostrará o erro. Ele não muda automaticamente para outra origem. No estado interrompido, é possível:
- Confirme o projeto correto na lista exibida pelo agente
- Forneça um caminho CSV do BPA como alternativa
- Fornecer caminhos de arquivo Java específicos para uma migração manual
Gerenciamento de sessões em relatórios grandes large-reports
Para relatórios do BPA com muitas descobertas, a abordagem lote a lote permite validar de forma incremental:
- Revisar a diferença de cada lote
- Confirmar o lote com uma mensagem de confirmação com escopo de padrão
- Responder
continuepara iniciar o próximo lote - Repita até que o agente informe que todas as descobertas do padrão foram feitas
Um padrão por confirmação mantém o histórico do Git legível e facilita a reversão de transformações padrão individuais, se necessário.
Escopo do Workspace workspace-scope
O agente procura e edita arquivos somente nas pastas abertas da área de trabalho do IDE. Ele não examina diretórios pai, pastas irmãs ou outros locais no disco.
Se uma descoberta de BPA fizer referência a um caminho de arquivo que não existe no espaço de trabalho, o agente será interrompido e informará quais caminhos estão ausentes. Abra a pasta do projeto correta ou forneça os caminhos explicitamente para continuar.