Domande frequenti su Cloud Manager

Questo documento fornisce le risposte alle domande più frequenti su Cloud Manager dei clienti AMS.

È possibile utilizzare Java 11 con le build di Cloud Manager?

Sì. È necessario aggiungere il maven-toolchains-plugin con le impostazioni corrette per Java 11.

• Questo processo è documentato qui.
• Ad esempio, consulta il codice del progetto di esempio WKND.

Dopo il passaggio da Java 8 a Java 11, la build restituisce un errore relativo al maver-scr-plugin. Cosa posso fare?

La build di AEM Cloud Manager potrebbe non riuscire durante il tentativo di passaggio da Java 8 a 11. Se si verifica il seguente errore, è necessario rimuovere il maven-scr-plugin e convertire tutte le annotazioni OSGi in annotazioni 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]

Per istruzioni su come rimuovere questo plug-in, consulta qui.

Dopo il passaggio da Java 8 a Java 11, la build restituisce un errore RequireJavaVersion. Cosa si può fare?

Per le build di Cloud Manager, il maven-enforcer-plugin potrebbe restituire questo errore

[main] [WARNING] Rule 1: org.apache.maven.plugins.enforcer.RequireJavaVersion

Si tratta di un problema noto a causa del quale Cloud Manager utilizza una versione di Java diversa per eseguire il comando maven anziché compilare il codice. È sufficiente omettere requireJavaVersion dalle configurazioni maven-enforcer-plugin.

Il controllo di qualità del codice non è riuscito e la distribuzione è bloccata. C’è un modo per aggirare questo controllo?

Sì. Tutti gli errori di qualità del codice, ad eccezione delle valutazioni di sicurezza, non sono metriche critiche e possono quindi essere ignorati come parte di una pipeline di implementazione espandendo gli elementi nell’interfaccia utente dei risultati.

Un utente con il ruolo di Responsabile della distribuzione, Project Manager o Proprietario business può ignorare i problemi nel qual caso la pipeline procede, oppure può accettare i problemi, nel qual caso la pipeline si arresta con un errore.

Consulta i documenti Gate a tre livelli durante l’esecuzione di una pipeline e Configurazione di pipeline non di produzione per ulteriori dettagli.

Le distribuzioni di Cloud Manager non superano il test delle prestazioni negli ambienti di Adobe Managed Services. Come si esegue il debug per passare le metriche critiche?

La risposta a questa domanda non è univoca. Ma questi sono alcuni punti importanti sul test delle prestazioni che devi tenere presente:

• Questo passaggio rappresenta un passaggio delle prestazioni web, ovvero il tempo necessario per caricare la pagina utilizzando un browser web.
• Gli URL elencati nel file .csv risultante durante il test vengono caricati in un browser Chrome nell’infrastruttura di Cloud Manager.
• Una metrica comune che non riesce è il tasso di errore.
  • Affinché un URL possa passare, l’URL principale deve essere caricato con uno stato pari a 200 e in meno di 20 secondi.
  • Il caricamento delle pagine superiori a 20 secondi sono contrassegnati come errori 504.
• Se il sito richiede l’autenticazione dell’utente, consulta il documento Comprendere i risultati del test per configurare il test per l’autenticazione sul sito.

Consulta il documento Comprendere i risultati dei test per ulteriori informazioni sui controlli di qualità.

Si può utilizzare SNAPSHOT per la versione del progetto Maven?

Sì. Per le distribuzioni nell’ambiente di sviluppo, i file pom.xml del ramo Git devono contenere -SNAPSHOT dopo il valore <version>.

Ciò consente di installare la distribuzione successiva anche se la versione non è stata modificata. Per le distribuzioni nell’ambiente di sviluppo, non viene aggiunta né generata una versione automatica della build Maven.

È possibile impostare la versione su -SNAPSHOT per le build o le implementazioni negli ambienti di staging e produzione. Cloud Manager imposta automaticamente un numero di versione corretto e crea un tag in Git per l’utente. Se necessario, puoi fare riferimento a questo tag in un secondo momento.

Ulteriori dettagli sulla gestione delle versioni sono documentati qui.

Come funziona il controllo delle versioni di pacchetti e bundle per le distribuzioni di staging e produzione?

Nelle distribuzioni di staging e produzione, viene generata una versione automatica come documentato qui.

Per il controllo delle versioni personalizzate nelle distribuzioni di staging e produzione, imposta una versione maven corretta in tre parti come 1.0.0. Aumenta il numero della versione per ogni esecuzione della distribuzione nell’ambiente di produzione.

Cloud Manager aggiunge automaticamente la versione alle build di staging e produzione e crea un ramo Git. Non è richiesta alcuna configurazione speciale. Se non imposti una versione Maven come descritto in precedenza, la distribuzione verrà comunque eseguita correttamente e verrà impostata automaticamente una versione.

L’esecuzione della build Maven non riesce per le distribuzioni di Cloud Manager, ma a livello locale non genera errori. Qual è il problema?

Consulta questa risorsa Git per ulteriori dettagli.

Impossibile impostare una variabile utilizzando un comando aio. Cosa si può fare?

Quando si tenta di elencare o impostare le variabili della pipeline tramite comandi aio, è possibile che venga visualizzato un errore 403 come il seguente.

$ 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)

In questo caso, l’utente che esegue questi comandi deve essere aggiunto al ruolo Responsabile della distribuzione in Admin Console.

Per ulteriori dettagli, consulta Autorizzazioni API.