Verba 2.0与Kubernetes部署的Weaviate集群连接问题解析

在Verba 2.0版本中，用户报告了一个与Kubernetes部署的Weaviate集群连接的问题。这个问题主要出现在使用自定义端口和主机配置的环境中。

问题背景

Verba是一个基于Weaviate构建的开源问答系统。在2.0版本发布后，部分用户发现无法连接到运行在Kubernetes集群上的Weaviate实例。这些Weaviate集群通常通过Istio Virtual Service暴露HTTP和gRPC端点，供外部访问。

错误现象

用户在尝试连接时遇到了以下错误信息：

Couldn't connect to Weaviate, check your URL/API KEY: Invalid port: '6383:443'

这表明Verba在处理自定义端口时出现了问题，特别是在Kubernetes环境中配置的非标准端口。

技术分析

这个问题源于Verba 2.0版本对Weaviate连接方式的改进。在早期版本中，Verba 1.0使用的是Weaviate客户端v3，能够较好地处理自定义端口配置。而Verba 2.0升级到了Weaviate客户端v4，在连接参数处理上有所变化。

解决方案

开发团队在Verba 2.1版本中引入了"Custom"部署选项，专门用于解决这类自定义Weaviate实例的连接问题。这个新选项允许用户：

1. 指定任意的主机地址
2. 使用非标准端口
3. 配置自定义的API密钥

对于急切需要使用此功能的用户，开发团队建议直接从源代码安装最新版本。而对于大多数用户，等待Verba 2.1的正式发布是更稳妥的选择。

最佳实践

在Kubernetes环境中部署Weaviate并连接Verba时，建议：

1. 确保网络策略允许Verba服务访问Weaviate的端口
2. 检查Istio Virtual Service的配置是否正确转发请求
3. 验证TLS证书配置（如果使用HTTPS）
4. 使用最新版本的Verba以获得最佳兼容性

总结

Verba 2.1版本解决了与自定义Weaviate实例的连接问题，特别是针对Kubernetes部署场景。这个改进使得Verba能够更灵活地适应各种Weaviate部署架构，为开发者提供了更大的配置自由度。