安装指南
本指南详细介绍如何在 Kubernetes 环境下安装 Kite。
前提条件
- 拥有集群管理员权限的
kubectl - Helm v3（推荐使用 Helm 安装）
- MySQL/PostgreSQL 数据库，或本地存储用于 sqlite
安装方式
方式一：Helm Chart（推荐）
使用 Helm 可灵活配置和升级 Kite：
bash
# 添加 Kite 仓库
helm repo add kite https://zxh326.github.io/kite
# 更新仓库信息
helm repo update
# 使用默认配置安装
helm install kite kite/kite -n kite-system --create-namespace自定义安装
可通过自定义 values 文件调整安装参数：
完整配置参考 Chart Values。
使用自定义值安装：
bash
helm install kite kite/kite -n kite-system -f values.yaml方式二：YAML 清单
如需快速部署，可直接应用官方安装 YAML：
bash
kubectl apply -f https://raw.githubusercontent.com/zxh326/kite/main/deploy/install.yaml此方法将使用默认配置安装 Kite。如需高级定制，建议使用 Helm Chart。
访问 Kite
端口转发（测试环境）
测试期间可通过端口转发快速访问 Kite：
bash
kubectl port-forward -n kite-system svc/kite 8080:8080LoadBalancer 服务
如集群支持 LoadBalancer，可直接暴露 Kite 服务：
bash
kubectl patch svc kite -n kite-system -p '{"spec": {"type": "LoadBalancer"}}'获取分配的 IP：
bash
kubectl get svc kite -n kite-systemIngress（生产环境推荐）
生产环境建议通过 Ingress 控制器并启用 TLS 暴露 Kite：
WARNING
Kite 的日志和 Web 终端功能需支持 websocket。 部分 Ingress 控制器可能需额外配置以正确处理 websocket。
yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: kite
namespace: kite-system
spec:
ingressClassName: nginx
rules:
- host: kite.example.com
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: kite
port:
number: 8080
tls:
- hosts:
- kite.example.com
secretName: kite-tls在子路径下部署（basePath）
如果您希望将 Kite 部署在一个子路径下，例如 https://example.com/kite，可以使用 Helm Chart 的 basePath 值来配置。
如何设置：
- 在
values.yaml中：
yaml
basePath: "/kite"- 或使用 Helm CLI：
fish
helm install kite kite/kite -n kite-system --create-namespace --set basePath="/kite"说明：
- Ingress 配置：确保 Ingress 的
paths与子路径一致，并使用合适的pathType（例如Prefix）。示例：
yaml
ingress:
enabled: true
hosts:
- host: kite.example.com
paths:
- path: /kite
pathType: Prefix- OAuth / 重定向：如果启用了 OAuth 或其他外部重定向，请在 OAuth 提供方中将重定向 URL 更新为包含子路径，例如
https://kite.example.com/kite/oauth/callback。
验证安装
安装完成后，可访问仪表盘验证 Kite 是否部署成功。预期界面如下：
TIP
如需通过环境变量配置 Kite，请参考 环境变量。
可根据页面提示完成集群设置。
卸载 Kite
Helm 卸载
bash
helm uninstall kite -n kite-systemYAML 卸载
bash
kubectl delete -f https://raw.githubusercontent.com/zxh326/kite/main/deploy/install.yaml后续步骤
Kite 安装完成后，您可以继续：