文档

本节内容从仓库 docs/ 目录中的 Markdown 文件生成，确保网站与源文档保持同步。

推荐阅读路径

Adoption Signals.zh Adoption Signals 本文定义 kruntimes 公开发布后应跟踪的 adoption signals。目标是判断项目价值是否容易理解，目标用户是否愿意用真实 workload 试用，以及非 maintainer 是否能独立 … Comparison.zh 对比指南本文说明 kruntimes 与 Kubernetes 周边执行系统的关系。目标是帮助用户选择合适工具，而不是把 kruntimes 定位成所有系统的通用替代品。 kruntimes 是早期阶段的 … Demos.zh 端到端 Demo 这些 demo 假设你可以访问一个 Kubernetes 集群。这个集群可以是本地 kind 或 minikube 集群，也可以是共享开发集群。集群要求和 Helm 安装细节见快速开始和安装。从已发布的 Helm … When to Use.zh 什么时候使用 kruntimes kruntimes 是 Kubernetes 上的 warm execution substrate。它适合平台团队在保留 Kubernetes 作为持久控制面的同时，获得低延迟、高吞吐的执行能力。它不是 … API 参考 kruntimes 暴露 Kubernetes CRDs 和本地 Runtime Server gRPC API。 Kubernetes APIs 当前所有 CRDs 都是 apiVersion: … FAQ kruntimes 是 Kubernetes scheduler 的替代品吗？不是。Kubernetes 仍然负责调度 Runtime Pods。kruntimes 负责在这些预热的 Runtime Pods 内部调度单个 Runs。 … kruntimes PRD 背景: 基于Kubernetes的Serverless平台的挑战在 Kubernetes 上构建 Serverless 平台是一个具有挑战性的任务，主要原因是 Kubernetes 的调度和资源管理机制并不完全适合 Serverless … 安全、授权与威胁模型 kruntimes 使用 Kubernetes namespaces 和 RBAC 作为当前的行政管理边界。内置 Bash 和 Python runtimes 在共享 Runtime Pods 内执行受信任的代码；它们不是用于互不信任的租户 … 安装 kruntimes 使用 Helm 安装。当前模型是 cluster-wide platform installation 加上 namespace-local Runtime definitions。要求支持 CRD 的 … 测试指南 本指南列出测试套件以及何时运行它们。单元测试 make test 覆盖集成测试和 E2E 测试之外的 Go 包。同时运行生成、格式化、vet 和 protobuf 生成先行检查。集成测试 make test-integration 使 … 发布流程 kruntimes 使用带有前导 v 的 SemVer tags，例如 v0.1.0。项目目前是 v0.x experimental。CRDs 是 v1alpha1，因此次版本号发布可能仍包含 breaking API 或行为变更。发布说 … 故障排查 本指南涵盖常见故障及应首先运行的命令。 Run 一直处于 Pending 状态检查 Run： kubectl get run <name> -o yaml 常见原因：没有匹配 spec.runtime 的 Runtime， … 架构 kruntimes 将 Kubernetes 层面的容量管理与请求层面的 Run 分配分离。组件组件职责 Run CRD 单次执行的持久记录：runtime、输入、分配、阶段、重试策略、时间戳、输出和 artifact 引用。 … 兼容性矩阵 kruntimes 目前是一个 v0.x 实验性项目，使用 v1alpha1 API。此矩阵记录了经过刻意测试或用于发布产物的版本。超出这些范围的可能也能工作，但不属于当前公开的兼容性声明。策略兼容性声明通过正常的 PR 更新。在 … 开发指南 本指南涵盖面向贡献者的本地开发。环境要求 go.mod 中指定的 Go 版本 Docker 或兼容的容器工具 Helm 3 kubectl kind Python 3.12+ 和 uv（用于 Python Runtime 开发）锁定的工 … 开源准备计划 本文档记录 kruntimes 在公开仓库前需要完成的改进项。目标不是在首次公开前完成所有生产级能力，而是确保项目具备清晰的法律边界、可信的基本质量、可复现的发布流程，以及与当前实现一致的功能和安全声明。 Release … 快速开始 本指南演示如何在已有 Kubernetes 集群上安装发布版 kruntimes，并执行一个 Bash Run。前置条件支持 CRD 的 Kubernetes 集群 kubectl Helm 3 kruntimes 运行在 … 目标用户验证 Playbook 目标用户验证 Playbook 这个 playbook 将开源准备计划中公开后的验证事项变成可重复执行的流程。它本身不是验证证据。只有真实用户完成活动并记录证据后，才能把 readiness 事项标为完成。目标用这个流程回答三个问 … 配置本页总结最常见的配置面。 Helm Values platform chart 配置： scheduler 和 controller replicas， image repositories、tags 和 pull policy， … 社区与项目治理 本页面汇总了定义人员参与方式、获取帮助和报告问题的项目文档。许可证 kruntimes 基于 Apache License 2.0 发布。详见 LICENSE 。品牌资产方形图标： docs/icon.png ，用于网站 … 使用指南 本指南覆盖 Runtime 和 Run 对象的常见用户流程。创建 Runtime Runtime 定义一组预热的 Runtime Pods。 apiVersion: kruntimes.io/v1alpha1 kind: Runtime … 项目概览 kruntimes 是一个 Kubernetes-native execution engine，用于在预热的 Runtime Pod 池上运行 serverless functions、CI pipelines、包含 AI … 项目状态与路线图 kruntimes 作为 v0.x experimental 项目活跃开发中。API 是 v1alpha1，可能在稳定发布之前发生变更。当前状态已完成的基础功能包括： Run 和 Runtime CRDs。预热 Runtime … 性能基准测试 kruntimes 包含一个可选的 benchmark harness，用于在真实 Kubernetes 集群上测量调度延迟、完成吞吐量、Runtime 容量行为以及控制平面请求延迟。基准测试不属于默认 CI，因为结果取决于集群规模、节 … 运维指南 本指南涵盖当前 cluster-wide kruntimes 安装模式的 day-two 运维操作。 kruntimes 目前仍是 v0.x experimental，使用 v1alpha1 API。升级前请备份 manifests 和 … 自定义 Runtime 开发指南 自定义 Runtime 允许你将 workload-specific execution environment 接入 kruntimes，同时将 Kubernetes watches、Run 认领、重试、artifact 上传、日志和状态 …