OpenWhisk调试器使用指南
1. 项目介绍
OpenWhisk Debugger 是一个被 Apache 开源的项目,旨在帮助开发者更方便地开发和调试 OpenWhisk 的动作(actions)。它提供了一个命令行工具 wskdebug
,允许你在最喜欢的 IDE 或者调试器中实现对 OpenWhisk 动作的全功能调试,支持自动代码重载以及实时更新,特别适用于 Node.js 动作。此外,尽管对其他语言的支持有限,但仍然可以通过配置进行基本调试。
2. 项目快速启动
安装要求
确保你的环境已经安装了以下组件:
- Node.js v10+
- npm
- Docker
安装 wskdebug
在命令行运行以下命令来全局安装 wskdebug
:
npm install -g @openwhisk/wskdebug
调试 Node.js 动作
要开始调试一个 Node.js 动作,执行以下步骤:
-
使用
wskdebug
命令连接到你的 OpenWhisk 动作:wskdebug <ACTION_NAME>
-
这将打开一个新的浏览器窗口,展示调试界面。你可以设置断点,查看变量状态等。
自动代码刷新
对于Web动作,你可以利用LiveReload功能,在代码更改时自动重新加载动作。只需启用该选项:
wskdebug <ACTION_NAME> --livereload
3. 应用案例和最佳实践
示例:调试Python动作
- 首次启动
wskdebug
时,可能出现约60秒的延迟,因为它会下载 OpenWhisk 支持的包依赖。 - 在REPL(Read-Eval-Print Loop)中输入帮助命令以查看可用的调试命令。
- 使用
--reset
参数重新初始化调试器以更新依赖项。
最佳实践
- 对于复杂的动作流程,可以逐个调试序列中的每个动作,而不是尝试直接调试整个序列。
- 尝试通过设置合理的超时值(
--agent-timeout
) 来避免长时间等待异步调用的结果。 - 利用浏览器或命令行调试器的优势,如断点、单步执行和日志输出。
4. 典型生态项目
OpenWhisk Debugger 是OpenWhisk生态的一部分,与其他项目如 OpenWhisk CLI 和 OpenWhisk Controller 协同工作,共同构建云原生事件驱动计算平台。在实际开发过程中,你可能还会遇到以下相关的开源工具和库:
- OpenWhisk Invoker - 执行OpenWhisk动作的服务。
- OpenWhisk Watcher - 监控并处理OpenWhisk事件的组件。
- OpenWhisk Ansible - 用于部署OpenWhisk的Ansible剧本集合。
以上即是OpenWhisk Debugger的基本介绍,希望能助你在OpenWhisk开发中更加得心应手。