Perguntas frequentes sobre o Cloud Manager

A seção a seguir fornece respostas para perguntas frequentes relacionadas ao Cloud Manager.

É possível usar o Java 11 com builds do Cloud Manager?

AEM build do Cloud Manager falha ao tentar alternar a build do Java 8 para o 11. O problema pode ter muitas causas e as mais comuns estão documentadas abaixo:

  • Adicione o maven-toolchains-plugin com as configurações corretas para Java 11 conforme documentado here. Por exemplo, consulte o código de projeto de amostra wknd.

  • Se encontrar o erro abaixo, é necessário remover o uso de maven-scr-plugin e converter todas as anotações OSGi em anotações OSGi R6. Para obter instruções, consulte here.

    [main] [ERROR] Failed to execute goal org.apache.felix:maven-scr-plugin:1.26.4:scr (generate-scr-scrdescriptor) on project helloworld.core: /build_root/build/testsite/src/main/java/com/adobe/HelloWorldServiceImpl.java : Unable to load compiled class: com.adobe.HelloWorldServiceImpl: com/adobe/HelloWorldServiceImpl has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0 -> [Help 1]

  • Para builds do Cloud Manager, o plug-in maven enforcer falha com erro "[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion". Esse é um problema conhecido porque o Cloud Manager usa uma versão diferente do Java para executar o comando maven versus o código de compilação. Por enquanto, omita requireJavaVersion das configurações maven-enforcer-plugin.

Nossa implantação ficou paralisada porque a verificação de qualidade do código falhou. Existe uma maneira de ignorar esta verificação?

Todas as falhas de qualidade do código exceto para Classificação de segurança são métricas não críticas, portanto, podem ser ignoradas ao expandir os itens na interface do usuário de resultados.

Um usuário com Gerenciador de implantação, Gerenciador de projeto ou Proprietário comercial pode substituir os problemas, caso o pipeline continue ou possa aceitar os problemas, caso o pipeline pare com uma falha. Consulte Portas de três níveis ao executar um pipeline para obter mais detalhes.

As implantações do Cloud Manager falham na etapa de teste de desempenho nos ambientes do Adobe Managed Services. Como depurar isso para passar as métricas críticas?

Consulte Entender os resultados de teste para entender os resultados.

Algumas observações sobre a etapa Teste de desempenho:

  • O Etapa de desempenho é uma etapa do desempenho da Web, ou seja, o tempo para carregar a página usando um navegador da Web.
  • Os URLs listados no resultado CSV são carregados em um navegador Chrome na infraestrutura do Cloud Manager durante o teste.
  • Uma métrica comum que falha é a variável taxa de erro. Para que um URL seja aprovado, o URL principal deve ser carregado com 200 e em menos de 20 segundos. Carregamentos de página que excedem 20 segundos são marcados como 504 erros.
  • Se seu site requer autenticação de usuário, consulte o documento Entender os resultados de teste para configurar o teste para autenticar em seu Site.

Podemos usar o SNAPSHOT na versão do projeto Maven? Como o controle de versão dos pacotes e arquivos jar funciona para implantações de Preparo e Produção?

Consulte os seguintes cenários para saber mais sobre o controle de versão dos pacotes e dos arquivos jar do pacote para implantações de Preparo e Produção:

  1. Para implantações de desenvolvedores, a ramificação Git pom.xml os arquivos devem conter -SNAPSHOT no final do <version> valor. Isso permite a implantação subsequente em que a versão não é alterada para ainda ser instalada. Em implantações de desenvolvedores, nenhuma versão automática é adicionada ou gerada para a build maven.

  2. Na implantação de Preparo e Produção, uma versão automática é gerada conforme documentado here.

  3. Para o controle de versão personalizado em implantações de Preparo e Produção, defina uma versão maven correta de 3 partes como 1.0.0. Aumente a versão sempre que precisar fazer outra implantação na produção.

  4. O Cloud Manager adiciona automaticamente sua versão ao Stage e às builds de produção e até cria uma ramificação Git. Nenhuma configuração especial é necessária. Se a etapa 3 acima for ignorada, a implantação ainda funcionará corretamente e uma versão será definida automaticamente.

  5. Não há problemas, se você deixar a versão com -SNAPSHOT para builds ou implantações de Preparo e Produção. O Cloud Manager define automaticamente um número de versão adequado e cria uma tag para você no Git. Essa tag pode ser consultada posteriormente, se necessário.

  6. Se quiser experimentar algum código experimental no ambiente de desenvolvimento, você pode criar uma nova ramificação Git e definir o pipeline para usar essa ramificação diferente. Isso é útil quando as implantações começam a falhar e você gostaria de testar com versões mais antigas do código para ver quando quebrou.

    O comando Git abaixo cria uma ramificação remota chamada testbranch1 contra uma confirmação preexistente específica 485548e4fbafbc83b11c3cb12b035c9d26b6532b. Essa ramificação especial pode ser usada no Cloud Manager sem afetar outras ramificações:

    git push origin 485548e4fbafbc83b11c3cb12b035c9d26b6532b:refs/heads/testbranch1

    Consulte a Documentação do Git para obter mais detalhes.

    Se desejar excluir a ramificação de teste posteriormente, use o comando delete:

    git push origin --delete testbranch1

A build do Maven falha nas implantações do Cloud Manager, mas é criada localmente sem erros. Como depurar?

Consulte Recurso Git para obter mais detalhes.

Não é possível definir uma variável por meio das variáveis de pipeline definidas do aio cloud manager. Como depurar esses problemas?

Se você estiver recebendo um 403 ao tentar listar ou definir variáveis de pipeline por comandos semelhantes aos abaixo, você precisa ser adicionado como um Gerenciador de implantação Função de produto Cloud Manager no Admin Console.
Consulte Permissões de API para obter mais detalhes.

Comandos e erros relacionados:

$ aio cloudmanager:list-pipeline-variables 222

Erro: Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

$ aio cloudmanager:set-pipeline-variables 222 --variable TEST 1

Erro: Cannot get variables: https://cloudmanager.adobe.io/api/program/111/pipeline/222/variables (403 Forbidden)

Nesta página