解决AEM Cloud Manager CDN配置部署中的YAML解析错误

本文介绍如何解决在通过AEM Cloud Manager管道部署CDN配置文件时发生的YAML解析错误,即使YAML通过外部验证工具也是如此。

描述 description

环境

Adobe Experience Manager as a Cloud Service(所有版本)

问题/症状

  • 部署cdn.yaml期间Cloud Manager管道失败,出现YAML分析错误。
  • YAML文件在外部验证器中显示有效。

原因

该错误通常是由于YAML格式问题导致的,例如缩进不正确、使用制表符或尾随空格。 这些问题可能不是由通用YAML验证器检测到的,而是由Cloud Manager管道强制实施的。

解决方法 resolution

要修复YAML解析错误,请执行以下步骤:

  1. 检查缩进问题:

    — 确保所有YAML键和列表项都根据AEM Cloud Manager预期的结构正确缩进。

    — 例如, — “name”和“rules”条目必须根据YAML层次结构中各自的级别缩进。

    — 示例结构:

    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. 删除尾随空白和制表符:

    — 在可以显示空白字符的文本编辑器中打开“cdn.yaml”文件。

    — 删除任何制表符字符或尾随空格,尤其是在最后一行配置之后(例如,在“type: block”之后)。

    ​3. 使用外部工具验证YAML:

    — 使用yamllint (https://www.yamllint.com/)等工具检查常规YAML语法错误。

    — 注意:通过外部验证无法保证文件符合AEM Cloud Manager要求。

    ​4. 使用Cloud Manager管道进行验证:

    — 提交更正的“cdn.yaml”并将其推送到源代码管理存储库。

    — 运行Cloud Manager配置管道以验证错误是否已解决。

    ​5. 查看在CDN上配置通信以了解正确结构。

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