企业级Kubernetes高可用部署：Onyx生产环境完整配置指南

顾季为

780人浏览 · 2025-11-29 01:27:32

顾季为 · 2025-11-29 01:27:32 发布

企业级Kubernetes高可用部署：Onyx生产环境完整配置指南

【免费下载链接】danswer Ask Questions in natural language and get Answers backed by private sources. Connects to tools like Slack, GitHub, Confluence, etc. 项目地址: https://gitcode.com/GitHub_Trending/da/danswer

Onyx是一款支持自然语言提问并通过私有数据源提供答案的企业级工具，可与Slack、GitHub、Confluence等平台无缝集成。本指南将详细介绍如何在Kubernetes环境中实现Onyx的高可用部署，确保生产环境的稳定运行和最佳性能。

部署架构概览

Onyx在Kubernetes环境中的部署采用了多层架构设计，确保系统的高可用性和可扩展性。核心组件包括Web服务、API服务、Celery任务队列、PostgreSQL数据库、Redis缓存以及Vespa搜索引擎。这些组件通过Kubernetes的Deployment、StatefulSet等资源进行管理，并利用HorizontalPodAutoscaler实现自动扩缩容。

图1：Onyx系统监控面板展示了关键性能指标和任务状态，帮助管理员实时掌握系统运行状况

部署前准备工作

环境要求

Kubernetes集群版本1.33及以上
Helm 3.0+
Terraform 1.0+
AWS账户（如使用云服务）
至少3个节点的集群，每个节点至少4核CPU和16GB内存

基础设施准备

Onyx的部署可通过Terraform模块快速搭建AWS基础设施，包括VPC、EKS集群、RDS PostgreSQL、ElastiCache Redis和S3存储桶。主要模块如下：

vpc: 创建适合EKS的VPC及子网
eks: 部署EKS集群及必要的附加组件
postgres: 配置RDS PostgreSQL实例
redis: 部署ElastiCache Redis集群
s3: 创建用于文件存储的S3桶

快速部署步骤

1. 克隆代码仓库

git clone https://gitcode.com/GitHub_Trending/da/danswer
cd danswer

2. 使用Terraform搭建基础设施

module "onyx" {
  source = "./deployment/terraform/modules/aws/onyx"
  region = "us-west-2"
  name = "onyx-prod"
  postgres_username = "onyxadmin"
  postgres_password = "your_secure_password"
}

执行部署：

cd deployment/terraform/modules/aws
terraform init
terraform apply

3. 使用Helm部署Onyx应用

# 设置kubectl上下文
aws eks update-kubeconfig --name onyx-prod --region us-west-2

# 创建命名空间
kubectl create namespace onyx

# 部署Helm chart
helm upgrade --install onyx ./deployment/helm/charts/onyx \
  --namespace onyx \
  --set postgresql.primary.persistence.enabled=true \
  --set minio.enabled=false \
  --set serviceAccount.create=false \
  --set serviceAccount.name=onyx-s3-access

高可用配置最佳实践

1. 资源配置优化

根据Onyx官方建议，为各组件设置合理的资源限制：

# 在values.yaml中配置
api:
  resources:
    requests:
      cpu: 1000m
      memory: 2Gi
    limits:
      cpu: 2000m
      memory: 4Gi

2. 自动扩缩容配置

Onyx支持两种自动扩缩容方式：Kubernetes HPA和KEDA。推荐生产环境使用KEDA实现更精细的扩缩容策略：

# 在values.yaml中配置
autoscaling:
  engine: keda
  api:
    enabled: true
    minReplicas: 2
    maxReplicas: 10
    metrics:
      - type: Resource
        resource:
          name: cpu
          target:
            type: Utilization
            averageUtilization: 70

3. 持久化存储配置

确保关键数据持久化，特别是PostgreSQL和Vespa：

# 在values.yaml中配置
postgresql:
  primary:
    persistence:
      enabled: true
      size: 50Gi
      storageClass: gp3

vespa:
  persistence:
    enabled: true
    size: 100Gi

4. 安全设置

以非root用户运行容器，增强安全性：

# 在values.yaml中配置
api:
  securityContext:
    runAsNonRoot: true
    runAsUser: 1001

vespa:
  podSecurityContext:
    fsGroup: 1000
  securityContext:
    runAsUser: 1000
    privileged: false