Introdução ao Agente de modernização de experiência getting-started

Saiba mais sobre as primeiras etapas para começar a usar o Agente de modernização de experiência e o Console de modernização de experiência.

NOTE
Se você estiver interessado em usar o Console de modernização da experiência, poderá solicitar acesso por meio do gerente de conta para garantir uma experiência de integração tranquila.

Preparar um repositório GitHub da Edge Delivery prepare-repo

NOTE
Está usando um projeto do AEM Sites e do Universal Editor? Siga as etapas de instalação do Introdução ao AEM Sites/Universal Editor.
  1. Selecione um repositório do Edge Delivery Services para usar com o Console de Modernização de Experiência.

  2. Verifique se o Conector de código do AEM está instalado no repositório.

    • Isso permite que o console inspecione o código.
  3. Verifique se o aplicativo GitHub da Sincronização de Código do AEM está instalado no repositório.

    • Isso permite que o Edge Delivery Services sincronize seu código.
    • Se o acordo de recompra se basear no tutorial, esta etapa já estará concluída.

Abra o Console de Modernização da experiência open-console

  1. Navegue até aemcoder.adobe.io.
  2. Faça logon com sua Adobe ID.

Modo de demonstração demo-mode

O console é iniciado no modo de demonstração quando você entra pela primeira vez. Esse modo permite explorar um site existente, onde você pode tentar migrar páginas adicionais. Um banner na parte inferior da tela indica que você está no modo de demonstração.

Modo de demonstração

Conectar seu site connect-repo

Quando estiver pronto para começar a trabalhar em seu próprio site, você pode sair do modo de demonstração ao se conectar ao seu próprio projeto.

  1. Clique em Alternar site no banner do modo de demonstração.
  2. Você será solicitado a autorizar o aplicativo Conector de código AEM usando suas credenciais do GitHub. Clique em Autorizar Conector de Código AEM.
  3. De volta ao console, especifique o URL de visualização do site. O URL de visualização pode ser obtido visualizando qualquer documento no site ou construindo-o a partir de uma ramificação, nome-do-site e organização. O sistema recuperará o projeto GitHub associado automaticamente. Como alternativa, você pode pesquisar seus projetos GitHub autorizados para encontrar um site.
    Conectando ao projeto GitHub
  4. Clique em Fazer check-out no espaço de trabalho depois que o site for verificado.
  5. Quando solicitado a Substituir espaço de trabalho existente, clique em Substituir espaço de trabalho.
    Substituir espaço de trabalho existente

O projeto e o site do GitHub agora estão conectados ao console.

Se o modo de demonstração tiver sido encerrado, mas um novo projeto não tiver sido conectado, as visitas subsequentes ao agente de Modernização de experiência forçarão um site a ser conectado primeiro.

Conexão do site

Início: Console console-home

Quando você visitar aemcoder, a Página Inicial será exibida até que uma conversa de chat seja iniciada. A página inicial permite que você comece a conversar digitando seu primeiro prompt ou selecionando um dos prompts sugeridos.

Página inicial do console

Iniciar Solicitação start-prompting

Agora que o console pode acessar o código, você está pronto para começar a solicitar.

  1. Para começar, você pode importar o conteúdo de um site:

    • “Migrar a página https://wknd-trendsetters.site.”
  2. Isso importa o conteúdo do site.

    • O console observa a separação de interesses e lida com o conteúdo e a apresentação separadamente.
    • A importação inicial do conteúdo de um site pode levar vários minutos.
    • O console fornece feedback contínuo à medida que inicia seu trabalho, incluindo uma visão geral de suas etapas planejadas.
      Importação de conteúdo
  3. Depois que o site for importado, o painel Workspace mostrará as páginas. Selecione uma página para visualizá-la no painel direito.
    Conteúdo importado

  4. Agora que você tem conteúdo, é possível solicitar a importação dos estilos da mesma origem.

    • “Importar os estilos gerais de https://wknd-trendsetters.site.”
  5. Assim como na importação de conteúdo inicial, a importação pode levar vários minutos, e o console fornece feedback enquanto processa sua solicitação e importa os estilos. Quando a tarefa for concluída, clique em Atualizar visualização no painel direito para exibir o conteúdo estilizado.
    Estilos importados

Agora você tem o conteúdo e os estilos importados para o console.

TIP
Consulte o guia de prompts para obter mais ideias sobre como solicitar o agente e o que suas habilidades podem fazer.

Fazer upload de conteúdo upload-content

Para carregar seu conteúdo para a Criação de Documentos:

  1. Verifique se você está no modo de exibição de Conteúdo e clique no botão Carregar conteúdo no canto superior direito.

    • Por padrão, você está no modo de exibição Conteúdo ao entrar no console.
    • Sua exibição é indicada pelo item Seletor de exibições selecionado na área de espaço de trabalho do console.
  2. A caixa de diálogo Carregar conteúdo é aberta com a organização de destino e o repositório preenchidos previamente nas configurações do projeto.

    • Se um fstab.yaml não estiver presente no repositório conectado, você precisará inserir manualmente a Organização e o Repositório.
    • Se você usou o padrão de formatação, um fstab.yaml será fornecido.
  3. Selecione os arquivos que você deseja carregar e clique em Carregar.
    Caixa de diálogo Carregar conteúdo

  4. O console indica o processo de carregamento ao desabilitar o botão Carregar.

  5. Uma vez concluída, uma notificação será exibida na parte inferior do console.
    Exibir no AEM

Para acessar o conteúdo carregado na Criação de Documentos, clique opcionalmente em Exibir na AEM na notificação quando o carregamento for concluído ou navegue até https://da.live/#/{organization}/{repository}.

Conteúdo na criação de documentos

O conteúdo importado agora está na Criação de documentos.

TIP
Se você estiver trabalhando em um projeto do AEM Sites e do Universal Editor, o upload de conteúdo para o AEM funcionará de forma um pouco diferente. Consulte Introdução ao Experience Modernization Agent para projetos do AEM Sites/Universal Editor para obter instruções específicas de carregamento.

Alterações no código push push-code-changes

Quando estiver satisfeito com as alterações feitas no código, você poderá enviá-las para o repositório do GitHub.

  1. Alternar para o modo de exibição Alterações (ícone de ramificação no seletor de modo de exibição).
    Modo de exibição de código
  2. Na lista de arquivos alterados, se alguns arquivos forem exibidos como não rastreados, clique no botão + para prepará-los.
  3. Clique no botão Pressionar no canto superior direito.
  4. Na caixa de diálogo Enviar alterações, escolha enviar alterações para uma nova PR (padrão) ou para a ramificação atual e clique em Confirmar para enviar.
    • Na dúvida, você pode enviar para a ramificação atual para manter as coisas simples.
  5. Uma vez concluída, uma notificação será exibida na parte inferior do console.
    Exibir PR

Se quiser acessar diretamente as alterações enviadas no GitHub, clique em Exibir PR na notificação quando o envio for concluído.

Código no GitHub

Seu código agora está no GitHub.

Visualizar site preview-site

Para exibir as alterações no ambiente de visualização:

  1. Volte para Criação de documentos.

    • Ela ainda pode estar aberta em uma guia do navegador que você abriu depois de clicar em Exibir no AEM depois de carregar o conteúdo.
    • Ou navegue até https://da.live/#/{organization}/{repository}
  2. Abra uma das páginas que você carregou anteriormente no AEM.

  3. Clique no ícone de plano de papel (canto superior direito) e selecione Visualizar.
    Publicar para visualização

Parabéns! O conteúdo e os estilos migrados agora estão ativos no ambiente de visualização do AEM.

Conteúdo de visualização publicado

Se você enviou seu código para uma ramificação diferente de main, a visualização aberta da Criação de documentos não mostrará os estilos. Altere para a ramificação atualizando o URL da visualização e você poderá ver seus estilos.

Resolução de problemas troubleshooting

Incluir na lista de permissões Endereços IP allowlist-ip-addresses

Se o site estiver protegido por um firewall ou por restrições de acesso, você poderá incluir na lista de permissões os seguintes endereços IP para que os serviços de back-end possam eliminar o site:

  • 34.228.136.112
  • 54.90.51.39
  • 3.224.194.242

Recursos adicionais additional-resources

Os documentos a seguir podem ser úteis à medida que você continua explorando o agente de Modernização da experiência e seu console.

recommendation-more-help
experience-manager-cloud-service-help-main-toc