Perguntas frequentes sobre o Cloud Manager cloud-manager-faqs

Este documento fornece respostas às perguntas mais frequentes sobre o Cloud Manager para clientes do AMS.

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

Sim. Será necessário adicionar o maven-toolchains-plugin com as configurações corretas para o Java 11.

Minha build falha com um erro sobre o maven-scr-plugin após mudar do Java 8 para o Java 11. O que posso fazer? maven-src-plugin

A compilação do AEM Cloud Manager pode falhar ao tentar alternar a compilação do Java 8 para o 11. Se você encontrar o seguinte erro, será necessário remover o maven-scr-plugin e converter todas as anotações OSGi em anotações OSGi R6.

[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 obter instruções sobre como remover este plug-in, clique aqui.

Minha build falha com um erro sobre RequireJavaVersion após mudar do Java 8 para o Java 11. O que posso fazer? requirejavaversion

Para builds do Cloud Manager, o maven-enforcer-plugin pode falhar com esse 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 em relação ao código de compilação. Basta omitir requireJavaVersion nas configurações maven-enforcer-plugin.

Ocorreu uma falha na verificação de qualidade do código e nossa implantação travou. Existe uma maneira de ignorar essa verificação? deployment-stuck

Sim. Todas as falhas de qualidade de código, exceto classificações de segurança, são métricas não críticas, portanto, podem ser ignoradas como parte de um pipeline de implantação expandindo os itens na interface de resultados.

Um usuário com a função de Gerente de implantação, Gerente de projeto ou Proprietário da empresa pode neutralizar os problemas, caso o pipeline continue, ou pode aprovar os problemas, caso o pipeline seja interrompido com uma falha.

Consulte os documentos Portas de três níveis ao executar um pipeline e Configuração de pipelines de não produção 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 nas métricas críticas? debug-critical-metrics

Não há resposta única para esta questão. Mas estes são alguns pontos importantes sobre a etapa do teste de desempenho que você deve ter em mente:

  • Esta etapa é uma etapa de desempenho da Web, ou seja, o tempo de carregamento de uma página usando um navegador da Web.

  • Os URLs listados no arquivo .csv resultante são carregados em um navegador Chrome na infraestrutura do Cloud Manager durante o teste.

  • Uma métrica comum que falha é a taxa de erro.

    • Para que um URL seja aprovado, o URL principal deve ser carregado com o status 200 e em menos de 20 segundos.
    • Carregamentos de página que excedem 20 segundos são marcados como erros 504.
  • Se o site exigir autenticação do usuário, consulte o documento Entender os resultados de teste para configurar o teste para autenticar em seu site.

Consulte o documento Entender os resultados de teste para obter mais informações sobre as verificações de qualidade.

Posso usar o instantâneo para a versão do projeto Maven? snapshot

Sim. Para implantações de desenvolvedores, os arquivos pom.xml da ramificação Git devem conter -SNAPSHOT no final do valor <version>.

Isso permite que a implantação subsequente ainda seja instalada, mesmo que a versão não seja alterada. Em implantações de desenvolvedores, nenhuma versão automática é adicionada ou gerada para a compilação maven.

Você também pode definir a versão como -SNAPSHOT para compilações ou implantações de preparo ou de 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.

Mais detalhes sobre o manuseio de versão estão documentados aqui.

Como funciona o controle de versão de pacotes para implantações de preparo e produção? staging-production

Em implantações de preparo e produção, uma versão automática é gerada, conforme documentado aqui.

Para um controle de versão personalizado em implantações de preparo e produção, defina uma versão maven adequada em três partes, como 1.0.0. Aumente a versão sempre que implantar na produção.

O Cloud Manager adicionará automaticamente a versão às compilações de preparo e produção e criará uma ramificação Git. Nenhuma configuração adicional é necessária. Se você não definir uma versão maven conforme descrito anteriormente, a implantação ainda terá sucesso e uma versão será definida automaticamente.

Minha compilação maven falha para implantações do Cloud Manager, mas é criada localmente sem erros. O que há de errado? maven-build-fail

Consulte esse recurso do Git para obter mais detalhes.

Não consigo definir uma variável usando um comando aio. O que posso fazer? set-variable

Você pode receber um erro 403, como o seguinte, ao tentar listar ou definir variáveis de pipeline por meio de comandos aio.

$ aio cloudmanager:list-pipeline-variables 222

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

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

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

$ aio cloudmanager:set-environment-variables 1755 --variable TEST 1

setting variables... !

Cannot set variables: https://cloudmanager.adobe.io/api/program/111/environment/222/variables (403 Forbidden)

Nesse caso, o usuário que executa esses comandos precisa ser adicionado à função Gerente de implantação no Admin Console.

Consulte Permissões da API para obter mais detalhes.

recommendation-more-help
c6cdc82b-cee9-48e0-a6ee-48149d5e72c3