设置本地开发环境
Adobe Asset Compute项目无法与AEM SDK提供的本地AEM运行时集成,而是使用自己的工具链进行开发,这与基于AEM Maven项目原型的AEM应用程序所需的工具链不同。
要扩展Asset Compute微服务,必须在本地开发人员计算机上安装以下工具。
简略的设置说明
以下是节略设置说明。 有关这些开发工具的详细信息,请参阅下面各个部分。
-
安装Docker Desktop并提取所需的Docker映像:
code language-none $ docker pull openwhisk/action-nodejs-v12:latest $ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
-
从命令行安装所需的npm模块和Adobe I/O CLI插件:
code language-none $ npm i -g @adobe/aio-cli @openwhisk/wskdebug ngrok --unsafe-perm=true \ && aio plugins:install @adobe/aio-cli-plugin-asset-compute
有关简化的安装说明的更多信息,请阅读以下部分。
安装Visual Studio代码 vscode
Microsoft Visual Studio Code用于开发和调试Asset Compute工作程序。 虽然可以使用其他与JavaScript兼容的IDE来开发工作程序,但只有Visual Studio代码可以集成到debug Asset Compute工作程序。
本教程假定使用Visual Studio代码,因为它为扩展Asset Compute提供了最佳的开发人员体验。
安装Docker Desktop docker
下载并安装最新的稳定Docker Desktop,因为这是本地测试和调试Asset Compute项目所必需的。
安装Docker Desktop后,启动该程序,并从命令行安装以下Docker映像:
$ docker pull openwhisk/action-nodejs-v12:latest
$ docker pull adobeapiplatform/adobe-action-nodejs-v12:3.0.22
Windows计算机上的开发人员应确保对上述图像使用Linux容器。 Docker for Windows文档中介绍了切换到Linux容器的步骤。
安装Node.js(和npm) node-js
Asset Compute工作程序基于Node.js,因此需要Node.js 10+(和npm)才能开发和构建。
安装Adobe I/O CLI aio
安装Adobe I/O CLI,或 aio 是一个命令行(CLI) npm模块,便于使用Adobe I/O技术并与之交互,用于生成和本地开发自定义Asset Compute工作程序。
$ npm install -g @adobe/aio-cli
安装Adobe I/O CLI Asset Compute插件 aio-asset-compute
$ aio plugins:install @adobe/aio-cli-plugin-asset-compute
安装wskdebug wskdebug
下载并安装Apache OpenWhisk debug npm模块,以便于Asset Compute工作程序的本地调试。
需要Visual Studio Code 1.48.x+才能使wskdebug正常工作。
$ npm install -g @openwhisk/wskdebug
安装密钥 ngrok
下载并安装ngrok npm模块,该模块可提供对本地开发计算机的公共访问权限,以便Asset Compute工作程序的本地调试。
$ npm install -g ngrok --unsafe-perm=true