与AEM处理配置文件集成

为了使Asset compute工作程序在AEM as a Cloud Service中生成自定义演绎版,必须通过处理用户档案在AEM中注册为Cloud Service作者服务。 受该处理配置文件约束的所有资产都将在上传或重新处理时调用工作程序,并通过资产的演绎版生成并提供自定义演绎版。

定义处理配置文件

首先,创建一个新的处理配置文件,该配置文件将使用可配置参数调用工作程序。

处理配置文件

  1. 以​AEM Administrator​的身份登录AEM as a Cloud Service创作服务。 由于这是一个教程,因此我们建议您使用开发环境或沙盒中的环境。
  2. 导航到​工具>资产>处理配置文件
  3. 点按​创建​按钮
  4. 将处理配置文件命名为WKND Asset Renditions
  5. 点按​Custom​选项卡,然后点按​Add New
  6. 定义新服务
    • 演绎版名称: Circle
      • 用于在AEM Assets中标识此演绎版的文件名演绎版
    • 扩展: png
      • 将生成的演绎版的扩展。 设置为png,因为这是工作人员Web服务支持的支持输出格式,并导致在圆切出后出现透明背景。
    • 端点: https://...adobeioruntime.net/api/v1/web/wkndAemAssetCompute-0.0.1/worker
      • 这是通过aio app get-url获取的工作器的URL。 根据AEM as a Cloud Service环境,确保URL指向正确的工作区。
      • 确保工作URL指向正确的工作区。 AEM as a Production Stage应使用Stage工作区URL, AEM as a Production应使用Production Workspace URL。
    • 服务参数
      • 点按​添加参数
        • 键: size
        • 值: 1000
      • 点按​添加参数
        • 键: contrast
        • 值: 0.25
      • 点按​添加参数
        • 键: brightness
        • 值: 0.10
      • 这些键/值对将传递到Asset compute工作器,并可通过rendition.instructions JavaScript对象使用。
    • Mime 类型
      • 包括: image/jpegimage/pngimage/gifimage/bmpimage/tiff
        • 这些MIME类型是工作程序npm模块中的唯一类型。 此列表限制自定义工作程序将处理哪些资产。
      • 不包括: Leave blank
        • 切勿使用此服务配置处理具有这些MIME类型的资产。 在这种情况下,我们只使用允许列表。
  7. 点按右上方的​Save

应用并调用处理配置文件

  1. 选择新创建的处理配置文件WKND Asset Renditions

  2. 点按顶部操作栏中的​将配置文件应用到文件夹

  3. 选择要将处理配置文件应用到的文件夹,如WKND,然后点按​应用

  4. 通过​AEM > Assets > Files​导航到处理配置文件未应用到的文件夹,然后点按WKND

  5. 在应用了处理配置文件的文件夹下的任意文件夹中,上传一些新的图像资产(sample-1.jpgsample-2.jpgsample-3.jpg),然后等待处理上传的资产。

  6. 点按资产以打开其详细信息

    • 默认演绎版在AEM中的生成和显示速度可能比自定义演绎版快。
  7. 从左侧边栏中打开​演绎版​视图

  8. 点按名为Circle.png的资产,然后查看生成的演绎版

    生成的演绎版

已完成!

恭喜! 您已完成关于如何将AEM扩展为Cloud ServiceAsset compute微服务的教程! 现在,您应该能够设置、开发、测试、调试和部署自定义Asset compute工作程序,以供AEM作为Cloud Service创作服务使用。

在Github上查看完整的项目源代码

最终Asset compute项目可在Github上获取,网址为:

Github包含是项目的最终状态,已完全填充工作程序和测试用例,但不包含任何凭据,即。.env, .config.json.aio.

疑难解答

在此页面上