解決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