介绍
FAQ
常见问题
安装部署问题
无法拉取镜像
- 集群无公网访问能力，需将 VPC 配置到 NAT 网关以确保集群节点可以访问公网）
- 访问 docker.io 受限，使用国内镜像仓库：
veaiops-registry-cn-beijing.cr.volces.com）
Helm 安装后域名无法访问
- 确认已安装 Nginx Ingress Controller
- 检查 Ingress 状态和地址，确保域名 DNS 解析指向 Ingress EIP
Terminal
> kubectl get ingress veaiops-ingress -n veaiops-system
NAME CLASS HOSTS ADDRESS PORTS AGE
veaiops-ingress nginx veaiops.example.com 10.x.x.1 80 42m
- 确认已申请合法域名如
veaiops.example.com，并正确配置 DNS 解析
私有镜像仓库认证
使用私有仓库需要配置认证信息（Secret）：
Terminal
# 创建 veaiops-system 命名空间
> kubectl create ns veaiops-system
# 创建 docker registry 认证 secret
> kubectl create secret docker-registry regcred \
--docker-server=YOUR_REGISTRY \
--docker-username=YOUR_USER \
--docker-password=YOUR_PASS \
--docker-email=YOUR_EMAIL \
-n veaiops-system
# 覆盖 values.yaml 中的全局配置
global:
imageRegistry: "<YOUR_REGISTRY>"
imagePullSecrets:
- docker-registry
security:
allowInsecureImages: true
HTTPS 证书配置
启用 HTTPS 需要配置 TLS 证书，在安装时指定证书 secret 的名称。
# 创建 TLS Secret
kubectl create secret tls veaiops-tls \
--cert=fullchain.crt \
--key=privkey.key \
-n veaiops-system
在 values.yaml 中配置：
ingress:
tlsSecretName: "veaiops-tls"
使用问题
LLM 调用失败
- API 限流：调整请求频率或升级配额
- 内容过滤：检查输入是否触发安全策略
- 认证失败：确认 API Key 配置正确
查看详细错误日志进行排查并提交至github issue中寻求帮助。