DokumentationExperience Cloud KCS

Beheben von YAML-Parsing-Fehlern in der Bereitstellung der AEM Cloud Manager CDN-Konfiguration

Letzte Aktualisierung: 30. Oktober 2026

In diesem Artikel wird erläutert, wie Sie YAML-Parsing-Fehler beheben, die beim Bereitstellen von CDN-Konfigurationsdateien über die AEM Cloud Manager-Pipeline auftreten, auch wenn die YAML externe Validierungstools übergibt.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (alle Versionen)

Problem/Symptome

  • Die Cloud Manager-Pipeline schlägt während der Bereitstellung von cdn.yaml mit einem YAML-Analysefehler fehl.
  • Die YAML-Datei erscheint in externen Validatoren gültig.

Ursache

Der Fehler wird normalerweise durch Probleme mit der YAML-Formatierung verursacht, z. B. falsche Einzüge, die Verwendung von Tabulatorzeichen oder nachfolgende Leerzeichen. Diese Probleme werden möglicherweise nicht von generischen YAML-Validatoren erkannt, aber von der Cloud Manager-Pipeline erzwungen.

Lösung resolution

Um den YAML-Parsing-Fehler zu beheben, führen Sie die folgenden Schritte aus:

  1. Prüfen auf Einrückungsprobleme:

    • Stellen Sie sicher, dass alle YAML-Schlüssel und Listenelemente korrekt gemäß der von AEM Cloud Manager erwarteten Struktur eingerückt sind.

    • Beispielsweise müssen die Einträge - „name“ und „rules“ entsprechend ihren jeweiligen Ebenen in der YAML-Hierarchie eingerückt sein.

    • Beispielstruktur:

    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. Nachfolgende Leerzeichen und Tabulatorzeichen entfernen:

    • Öffnen Sie die Datei „cdn.yaml“ in einem Texteditor, der Leerzeichen anzeigen kann.

    • Entfernen Sie alle Tabulatorzeichen oder nachgestellten Leerzeichen, insbesondere nach der letzten Konfigurationszeile (z. B. nach „type: block„).

    ​3. Validieren von YAML mit externen Tools:

    • Verwenden Sie Tools wie yamllint (https://www.yamllint.com/), um nach generischen YAML-Syntaxfehlern zu suchen.

  • Hinweis: Die Übergabe der externen Validierung garantiert nicht, dass die Datei die AEM Cloud Manager-Anforderungen erfüllt.
    ​4. Validieren mit Cloud Manager Pipeline:

    • Übertragen Sie die korrigierte Datei „cdn.yaml“ in das Quellcodeverwaltungs-Repository und übertragen Sie sie.

    • Führen Sie die Cloud Manager-Konfigurations-Pipeline aus, um zu überprüfen, ob der Fehler behoben ist.

    ​5. Überprüfen Sie Konfigurieren von Traffic im CDN auf die richtige Struktur.

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