在 OpenShift 或 OKD 上部署 AISIX OSS
AISIX OSS 无需控制面即可在 OpenShift 和 OKD 上运行。网关从声明式 resources.yaml 文件加载模型、模型服务提供方凭据、调用方 API Key 和策略,平台则通过默认的 restricted-v2 安全上下文约束(SCC)分配运行时 UID。
本流程安装一个网关副本,通过边缘 Route 暴露服务,并验证 AISIX 配置与 OpenShift 安全上下文。如果限制或缓存条目需要在副本间保持一致,请在增加副本数之前配置共享 Redis。
前提条件
- 已有 OpenShift 或 OKD 4.11 或更高版本的集群。
oc会话能够在目标项目中管理工作负载、Service、Secret 和 Route,读取 Pod 日志并运行oc exec。- 已获得应用域名和入口 CA 证书,或拥有读取集群 Ingress 配置和
openshift-config-managed中default-ingress-certConfigMap 的权限。集群管理员也可以直接提供域名和 CA,而无需授予这些权限。 - Helm 3、Docker 和 cURL。
- 上游模型服务提供方密钥和调用方 API Key。示例使用 OpenAI 和模型别名
gpt-4o-mini。
准备项目与凭据
选择现有项目;如果集群允许创建项目,也可以申请新项目:
oc project aisix-dp
# 或申请新项目。
oc new-project aisix-dp
导出示例所用凭据,然后将其存储为 Secret:
export OPENAI_API_KEY="YOUR_PROVIDER_API_KEY"
export CALLER_API_KEY="YOUR_CALLER_API_KEY"
oc -n aisix-dp create secret generic openai-credentials \
--from-literal=api-key="$OPENAI_API_KEY"
oc -n aisix-dp create secret generic aisix-caller-keys \
--from-literal=my-caller="$CALLER_API_KEY"
准备并验证 AISIX 资源
选择资源来源前,先添加 Chart 仓库:
helm repo add api7 https://charts.api7.ai
helm repo update
将以下 Chart values 保存为 values.yaml。Chart 会把内联资源文档存入 Secret,凭据仍保存在前面创建的 Secret 中:
values.yaml
replicaCount: 1
image:
repository: ghcr.io/api7/aisix
tag: dev
controlPlane:
enabled: false
standalone:
resources:
_format_version: "1"
provider_keys:
- display_name: openai-main
provider: openai
adapter: openai
api_key: ${OPENAI_API_KEY}
api_base: https://api.openai.com/v1
models:
- display_name: gpt-4o-mini
provider: openai
model_name: gpt-4o-mini
provider_key: openai-main
api_keys:
- display_name: my-caller
key_env: CALLER_API_KEY
allowed_models:
- gpt-4o-mini
extraEnvVars:
- name: OPENAI_API_KEY
valueFrom:
secretKeyRef:
name: openai-credentials
key: api-key
- name: CALLER_API_KEY
valueFrom:
secretKeyRef:
name: aisix-caller-keys
key: my-caller
如果 resources.yaml 由其他系统管理,请先准备资源文件,再选择使用现有 Secret或使用现有 ConfigMap。执行这些命令时使用 aisix-dp 项目和 oc