OME项目在Kubernetes集群中的安装指南

项目概述

OME是一个基于Kubernetes的模型服务框架，支持多种部署模式，为AI模型推理服务提供灵活高效的运行环境。本文将详细介绍如何在Kubernetes集群中安装和配置OME项目。

前置准备

在开始安装OME之前，需要确保您的Kubernetes集群满足以下要求：

1. Kubernetes版本：至少需要1.27.1或更高版本
2. kubectl工具：已配置并能与集群通信
3. 部署模式选择：
   • RawDeployment模式：支持基于自定义指标的扩展（需要KEDA和Prometheus）
   • Serverless模式：需要Knative Serving和Istio
   • MultiNodeRayVLLM模式：需要Ray集群支持

依赖组件安装

1. Istio安装（Serverless模式必需）

版本要求：至少1.19版本

安装完成后，需要创建IngressClass资源：

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  name: istio
spec:
  controller: istio.io/ingress-controller

注意：如果使用云服务商托管的Kubernetes，可以考虑使用其提供的托管Istio服务。

2. Cert Manager安装

版本要求：至少1.9.0版本

Cert Manager用于生产级安装中的webhook证书管理。对于测试环境，也可以使用自签名证书。

3. Knative Serving安装（Serverless模式必需）

安装时需要注意：

• 如需使用PodSpec字段（如nodeSelector、affinity等），需要开启相应的功能标志
• 如果使用私有镜像仓库，需要配置Knative跳过镜像摘要解析：

kubectl -n knative-serving edit configmap config-deployment

添加以下内容到data部分：

data:
  registriesSkippingTagResolving: ko.local, dev.local, ghcr.io

4. KEDA安装（RawDeployment模式必需）

推荐使用Helm进行安装，用于支持基于自定义指标的自动扩展。

5. Prometheus安装（RawDeployment模式必需）

安装步骤：

1. 添加Helm仓库并更新
2. 安装kube-prometheus-stack

OME项目安装

获取项目代码

项目代码需要放置在GOPATH的特定目录下：

mkdir -p ${GOPATH}/src/github.com/sgl-project
cd ${GOPATH}/src/github.com/sgl-project
git clone <项目仓库地址>
cd ome

安装最新开发版本

执行以下命令安装OME：

make install

控制器将运行在ome命名空间中。

卸载OME

如需卸载，执行以下命令：

make uninstall

部署模式说明

1. RawDeployment模式：

   • 优点：支持挂载多个卷，突破Knative限制
   • 限制：不支持缩容到零和从零扩展

2. Serverless模式：

   • 优点：基于请求量的自动扩展，支持缩容到零和从零扩展
   • 特性：支持版本管理和基于版本的灰度发布

3. MultiNodeRayVLLM模式：

   • 特点：支持多节点Ray集群和VLLM模型服务
   • 限制：不支持自动扩展和灰度部署

常见问题处理

1. 版本兼容性问题：确保各组件版本符合最低要求
2. 私有镜像仓库配置：正确配置Knative以跳过镜像摘要解析
3. 功能标志启用：如需使用高级PodSpec功能，确保开启相应功能标志

通过以上步骤，您可以在Kubernetes集群中成功安装和配置OME项目，根据实际需求选择合适的部署模式运行AI模型推理服务。