Cheshire Cat AI 的 Helm Chart 用于 Rancher / Kubernetes

本文将创建一个简单的 Helm Chart，用于在基于 Kubernetes 的 Rancher 系统上安装 Cheshire Cat AI 作为应用程序（app）。

我们首先总结 Kubernetes 系统的关键概念，然后介绍 Helm Chart，最后演示如何通过 Rancher 的网页界面在安装和更新应用时设置一些参数。

介绍：系统组件

点击名称查看各组件描述。

Chesshire Cat AI

又称为Stregatto，是一个开源的框架，便于创建和部署人工智能代理。这里的代理泛指允许构建基于 AI 的聊天机器人、RAG 系统和助手，通过插件和工具与其他应用交互。它是开源的，易于定制、扩展和集成，可在云或容器环境中部署和扩展，确保高可用性和灵活性。已有多个免费插件扩展功能，社区活跃，且即将支持MCP 协议。[1]

Docker

这是一个开源的容器化平台，允许将应用程序及其所有依赖（库、配置、运行时）打包到一个轻量且隔离的“容器”中。这样应用可以在任何环境中以相同方式运行，提高了开发、测试和生产环境间的可移植性和一致性。通常一个容器只包含一个应用或其模块。存储使用卷，配置参数使用环境变量。[2][7][8]

Kubernetes

这是一个开源的容器编排系统，自动化容器应用的部署、管理和扩展。它管理物理或虚拟机集群，分配工作负载，处理故障恢复，监控应用状态，确保即使出现故障也能正常运行。它提供了一套工具来管理拆分为微服务的复杂应用。[3][7][8] 除了管理容器、卷和环境变量，Kubernetes还引入了许多概念，包括：

Pod：Kubernetes 最小单元，包含一个或多个共享网络和存储的容器，用于组合紧密相关的容器，如一个 Web 容器和其日志容器。
Deployment：管理创建和更新相同 Pod 的实体，用于无停机升级应用，保证可扩展性和自动回滚。
Secret：存储敏感数据，如密码、TLS 证书、认证密钥，可用于环境变量、文件或 Config Map。
Config Map：管理配置文件、参数和公开环境变量，不含敏感信息，挂载为 Pod 中的文件。
Stateful Set：专为需要持久存储和启动顺序的应用（如数据库）设计的部署。
Replica Set：确保运行指定数量的 Pod 副本。
Job 和 Cronjob：一次性或定时任务，如备份、批处理。
Service：暴露 Pod 并实现负载均衡。
Ingress：管理集群外部的 HTTP/HTTPS 访问、路由和 SSL 加密。
Persistent Volume (PV)：集群中的物理存储，类型由 Storage Class 决定。
Persistent Volume Claim (PVC)：Pod 对存储的请求。
Storage Class：动态创建存储的模板，定义存储类型。
Namespace：集群组件的逻辑划分，用于按项目或应用分组 Pod、Deployment、Ingress 等。
Resource Quota：分配给每个 Namespace 的资源（CPU、内存、存储）。

Helm

它是 Kubernetes 的“包管理器”，通过预配置的“chart”简化复杂应用的安装和管理。Helm 也便于更新和发布管理。它本质上是一个模板，定义和描述所有 Kubernetes 组件（Pod、Deployment、Service、Ingress、卷等），用于安装和配置应用。一个 Helm Chart 是一个目录，包含多个 YAML 文件，每个定义系统的一个或多个组件。[4]

Rancher

它是一个网页应用，提供直观的图形界面来管理 Kubernetes 集群。Rancher 简化了集群配置、访问控制、监控和应用安装等复杂操作，使 Kubernetes 对不那么熟悉的团队也易于使用。它通过简单直观的界面替代了通常需要命令行完成的集群管理操作。Rancher 引入了“应用”概念，即包含所有 Kubernetes 组件的高级抽象对象，用于安装、配置和管理复杂应用。此外，它提供了带预配置应用的应用目录。应用通过 Helm Chart 定义，可以添加名为 questions.yaml 的文件，从网页界面定义应用参数。[5]

实际上，可以用 Cheshire Cat 创建一个 AI 助手，将其安装在基于 Kubernetes 的 Docker 容器中。构成该系统的所有组件配置均可通过 Helm Chart 描述，并通过 Rancher 的 网页界面 管理。

Helm Chart 说明

该Helm Chart 定义了构成系统并使应用在集群上运行的所有组件。

主要文件包括：

Chart.yaml：主文件，定义包及其元数据：版本、名称、图标、描述、关键词、维护者等。
values.yaml：包含所有组件的可配置属性，例如使用的 Docker 镜像、应用端口、卷大小、Pod 副本数等。
questions.yaml：定义在 Rancher 网页界面中显示的交互字段，用于自定义部署。
templates/deployment.yaml：用于创建管理应用 Pod 的 Deployment 资源模板。这里创建了一个名为 kk-cheshirecatai 的容器，安装镜像
ghcr.io/cheshire-cat-ai/core:latest ，挂载三个卷：static-volume、data-volume 和 plugins-volume。定义了环境变量 CCAT_API_KEY，并暴露端口 80 和 5678。
templates/service.yaml：定义服务暴露的端口（80 和 5678）及负载均衡方式（ClusterIP）。
templates/ingress.yaml：指定应用关联的 URL 为 cheshirecatai.cbc.it，并管理 HTTPS。
templates/secret.yaml：定义名为 cheshirecatai-secret 的 secret，是一个 API key，可用于让 WordPress 网站与该 Cheshire Cat AI 实例通信。
templates/_helpers.tpl：包含一些可复用函数，用于集中创建名称和标签，供其他文件调用，如 {{- define “kk-cheshirecatai.name” -}}。

如前所述，所有文件均为 YAML 格式，除最后一个外，扩展名可用 yaml 或 yml。

Rancher 的 questions.yaml 文件工作原理

定义集群组件的所有 YAML 文件都包含变量，例如：

{{ .Values.service.ports.http }}
{{ .Values.image.repository }}:{{ .Values.image.tag }}
{{ .Values.image.pullPolicy }}

该语法表示使用 values.yaml 文件中的对应值。

在 Kubernetes 上安装或更新应用时，所有变量值都会被读取并用于创建相应组件。

在 Rancher 中，可以通过其图形界面设置全部或部分参数。为此，需要在 questions.yaml 文件中指定要设置的参数，如下图所示。安装或更新时，这些值会用于生成一个新的 values 文件，该文件是原始文件与 questions.yaml 覆盖值的合并。新的 values 文件将通过 helm 命令的 –values 参数传递，其值用于创建或修改各组件（如 deployment.yaml、service.yaml、ingress.yaml 等）。

应用验证与安装

创建 Helm Chart 时很容易犯各种错误，尤其是语法和缩进错误。

可以执行以下两个命令：第一个进行简单检查，第二个生成一个文件，描述将创建或修改的所有组件，变量被替换为实际使用的值（除非在 Rancher 中直接定制）。

helm lint
helm template my-release . --debug > prova.yml

要在 Rancher 上安装应用，需将其连接到包含该 Helm Chart 的仓库（Rancher->Apps->Repositories）。

此时，应用将在 Rancher->Apps->Charts 中显示，可通过网页界面安装。

若无 Rancher，可直接在 Kubernetes 上安装/更新应用，使用以下命令：

helm install kk-cheshirecatai .  --namespace cheshire-cat --create-namespace
helm upgrade kk-cheshirecatai . --namespace cheshire-cat

但此时 questions.yaml 文件会被忽略。

来源与参考

Cheshire Cat AI，官方网站。
Docker，官方网站。
Kubernetes，官方网站。
Helm，官方网站。
Rancher，官方网站。
使用 Cheshire Cat AI 的简单 WordPress 聊天机器人，本博客。
微服务系统管理的组件与技术，本博客。
微服务：架构、组件与互操作性，本博客。
本文介绍的 Helm Chart。

*** 本文为使用 n8n 和 OpenAI 自动翻译生成。

Posted In: DevOps, 人工智能, 信息技术

Il blog di Claudio