Apache OpenWhisk部署过程中常见问题及解决方案

Apache OpenWhisk是一个开源的Serverless计算平台，允许开发者以函数即服务(FaaS)的方式运行代码。在部署过程中，开发者可能会遇到各种配置和运行问题。本文将针对部署过程中常见的错误进行分析，并提供解决方案。

调度器(Scheduler)启动失败问题

在部署过程中，调度器服务(scheduler)启动失败是最常见的问题之一。错误日志中通常会显示与ElasticSearch相关的配置异常：

Exception in thread "main" java.lang.ExceptionInInitializerError
Caused by: pureconfig.error.ConfigReaderException: Cannot convert configuration to a org.apache.openwhisk.core.database.elasticsearch.ElasticSearchActivationStoreConfig

这个问题源于系统默认配置了ElasticSearch作为激活记录存储后端，但实际环境中可能并未正确配置或不需要使用ElasticSearch。

解决方案

有两种主要解决方法：

1. 正确配置ElasticSearch参数： 在ansible的group_vars/all配置文件中添加以下ElasticSearch相关配置项：

   db_activation_backend: ElasticSearch
   elastic_cluster_name: <集群名称>
   elastic_protocol: <协议>
   elastic_index_pattern: <索引模式>
   elastic_base_volume: <存储卷目录>
   elastic_username: <用户名>
   elastic_password: <密码>
   

2. 使用NoopDurationCheckerProvider替代： 如果不需要ElasticSearch功能，可以修改common/scala/src/main/resources/reference.conf文件，将ElasticSearchDurationCheckerProvider替换为NoopDurationCheckerProvider。

控制器(Controller)健康检查失败

在部署过程中，控制器服务的健康检查可能会失败，错误信息通常为：

Status code was 404 and not [200]: HTTP Error 404: Not Found

解决方案

1. 确保CouchDB服务已正确启动并运行
2. 检查控制器与CouchDB之间的网络连接
3. 验证CouchDB中是否已创建必要的数据库(如whisk_local_subjects)

调度器连接拒绝问题

即使调度器容器已启动，仍可能出现连接被拒绝的错误：

Status code was -1 and not [200]: Request failed: <urlopen error [Errno 111] 拒绝连接>

解决方案

1. 检查调度器服务的日志，确认是否启动成功
2. 验证网络配置，确保端口映射正确
3. 检查防火墙设置，确保相关端口(如14001)未被阻止

CLI连接问题

部署完成后，使用wsk CLI时可能会遇到连接问题：

error: Unable to obtain the list of entities for namespace 'default': Get "http://localhost:3233/api/v1/namespaces/_/actions?limit=0&skip=0": dial tcp 127.0.0.1:3233: connect: connection refused

解决方案

1. 确认API端点配置正确，默认应为https://localhost
2. 使用-i参数忽略自签名证书问题：wsk list -i
3. 检查nginx服务是否正常运行，并正确代理了API请求

部署最佳实践

1. 环境准备：

   • 确保系统满足最低要求(如Ubuntu 18.04或更高版本)
   • 安装必要依赖(Docker, Ansible等)

2. 配置检查：

   • 仔细检查ansible环境变量配置
   • 确认各服务(如CouchDB, Kafka, Zookeeper)的连通性

3. 故障排查：

   • 使用docker ps -a检查容器状态
   • 查看容器日志：docker logs <容器名>
   • 逐步验证各组件功能

通过以上分析和解决方案，开发者可以更顺利地完成Apache OpenWhisk的部署工作。遇到问题时，建议按照组件隔离的原则，逐步排查和验证每个服务的状态，从而快速定位和解决问题。