DocumentazioneExperience Cloud KCS

Migliorare la valutazione dell’affidabilità di Cloud Manager da C a A in AEM as a Cloud Service

Ultimo aggiornamento: 27 ottobre 2026

Questo articolo spiega perché il punteggio di affidabilità in una pipeline di AEM Cloud Manager può essere riportato come C e fornisce i passaggi per risolvere i problemi di scansione del codice e migliorare il punteggio ad A.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service con scansione della qualità del codice Cloud Manager

Sintomi

Quando si esegue una pipeline Cloud Manager, il livello di affidabilità è indicato come C. Il rapporto sulla qualità del codice identifica più risultati di “bug” OakPAL, ad esempio:

  • Utilizzo di mode="replace" in filter.xml in /content o /content/experience-fragments (FilterXmlModeAnalysis)
  • Sovrapposizione dei percorsi di installazione tra più pacchetti, inclusi i pacchetti di terze parti/fornitori (PackageOverlaps)
  • Nella definizione dell’indice Oak personalizzato manca un nodo jcr:content richiesto (DiffIndexCheck)
  • File di configurazione OSGi duplicati (DuplicateOsgiConfigurations)

Questi risultati sono contrassegnati come bug principali o secondari e influiscono direttamente sulla valutazione dell’affidabilità in Cloud Manager. L’utilizzo di mode="replace" in /content non è consentito in modo specifico dalla regola FilterXmlModeAnalysis di Cloud Manager, in quanto può eliminare e ricreare tutto il contenuto in tale percorso in ogni distribuzione.

Causa

Il livello di affidabilità di C è causato da problemi di qualità del codice rilevati dall’analisi OakPAL in Cloud Manager, principalmente dovuti all’utilizzo di mode="replace" in /content, alla sovrapposizione dei percorsi dei pacchetti, alla mancanza di nodi negli indici Oak personalizzati e alla duplicazione delle configurazioni OSGi.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina il rapporto sulla qualità del codice dall’esecuzione della pipeline Cloud Manager interessata e identifica tutti i risultati relativi a bug principali e secondari.

  2. Aggiorna il file filter.xml nei pacchetti ui.content:

    • Cambia qualsiasi radice filtro in /content o /content/experience-fragments da mode="replace" a una modalità più sicura, ad esempio merge o update_properties.
    • Se è necessario reimpostare completamente il contenuto del test, utilizza un pacchetto o uno script installato manualmente al di fuori delle distribuzioni di Cloud Manager.

  3. Risolvere i risultati di PackageOverlaps regolando le directory principali dei filtri per eliminare la sovrapposizione dei percorsi di installazione tra i pacchetti. Se necessario, coordina con i proprietari dei pacchetti del fornitore.

  4. Risolvere i risultati di DiffIndexCheck aggiungendo il nodo jcr:content mancante alle definizioni di indice Oak personalizzate identificate nel report.

  5. Risolvi i risultati di DuplicateOsgiConfigurations rinominando o rimuovendo i file di configurazione OSGi duplicati in modo che ogni configurazione venga definita una sola volta in tutti i pacchetti.

  6. Esegui nuovamente la pipeline di Cloud Manager e verifica che tutti i risultati dei bug principali e secondari siano stati risolti e che il livello di affidabilità migliori.

recommendation-more-help
experience-cloud-kcs-help-kbarticles