DocumentazioneExperience Cloud KCS

Risoluzione degli errori di analisi YAML nella distribuzione della configurazione CDN di AEM Cloud Manager

Ultimo aggiornamento: 30 ottobre 2026

Questo articolo spiega come risolvere gli errori di analisi YAML che si verificano durante la distribuzione dei file di configurazione CDN attraverso la pipeline di AEM Cloud Manager, anche quando YAML trasmette strumenti di convalida esterni.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (tutte le versioni)

Problema/Sintomi

  • La pipeline Cloud Manager non riesce durante la distribuzione di cdn.yaml con un errore di analisi YAML.
  • Il file YAML appare valido nelle convalide esterne.

Causa

L’errore è in genere causato da problemi di formattazione YAML come rientro non corretto, utilizzo di caratteri di tabulazione o spazi vuoti finali. Questi problemi potrebbero non essere rilevati da validatori YAML generici, ma vengono applicati dalla pipeline Cloud Manager.

Risoluzione resolution

Per correggere l’errore di analisi YAML, effettuare le seguenti operazioni:

  1. Verifica la presenza di problemi di rientro:

    • Assicurarsi che tutte le chiavi YAML e le voci di elenco siano correttamente rientrate in base alla struttura prevista da AEM Cloud Manager.

    • Ad esempio, le voci - “name” e “rules” devono essere rientrate in base ai rispettivi livelli nella gerarchia YAML.

    • Struttura di esempio:

    code language-none 
    trafficFilters:
    rules:
        - name: block-example
        when:
            allOf:
            - { reqProperty: tier, equals: "publish" }
            - { reqProperty: path, equals: "/content/example/path" }
            - { reqProperty: clientIp, notIn: [  "192.0.2.0/24", "198.51.100.0/24" ]  }
        action:
            type: block

  2. Rimuovi spazi vuoti finali e caratteri di tabulazione:

    • Apri il file “cdn.yaml” in un editor di testo che può visualizzare spazi vuoti.

    • Rimuovi eventuali caratteri di tabulazione o spazi vuoti finali, specialmente dopo l’ultima riga di configurazione (ad esempio, dopo “type: block”).

    ​3. Convalida YAML con strumenti esterni:

    • Utilizzare strumenti come yamllint (https://www.yamllint.com/) per verificare la presenza di errori di sintassi YAML generici.

    • Nota: il passaggio della convalida esterna non garantisce che il file soddisfi i requisiti di AEM Cloud Manager.

    ​4. Convalida con pipeline Cloud Manager:

    • Eseguire il commit e inviare il file corretto ‘cdn.yaml’ all’archivio del controllo del codice sorgente.

    • Eseguire la pipeline di configurazione di Cloud Manager per verificare che l’errore sia stato risolto.

    ​5. Rivedi Configurazione del traffico sulla rete CDN per la struttura corretta.

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