4.1 KiB
title, lifecycle, evidence, last_reviewed, last_verified, sources
| title | lifecycle | evidence | last_reviewed | last_verified | sources | |
|---|---|---|---|---|---|---|
| Gitea Dynamic Runner | experimental | documented | 2026-09-16 | null |
|
Gitea Dynamic Runner
原名 gitea-microvm-runner，现为
gitea-dynamic-runner。
它为 Gitea Actions 按需创建一次性执行环境，支持 Kubernetes Pod 和 Cloud Hypervisor
microVM；每个环境只执行一个 job，结束后销毁环境及本地状态。
更名由维护者提供；以下内容依据 2026-09-16 查阅的项目 README。 README 描述了 bootstrap 实现与后续路线，没有明确记录当前部署范围或端到端上线验收。 本页因此按试验阶段记录，不表示现场 runner 已注册或下面的 labels 已可调度；本轮未查询现场。
workflow 如何选择执行环境
README 定义两种稳定接口，在 workflow 的 job 中选择：
runs-on: [self-hosted, pod]
runs-on: [self-hosted, vm]
| 接口 | 执行方式 | 使用时需要理解的边界 |
|---|---|---|
pod |
动态 Kubernetes privileged Pod；workflow 使用 host executor | Docker、BuildKit、kind 等工具由 pipeline 按需 setup；这里的 host executor 指 Pod 内执行环境 |
vm |
动态 Cloud Hypervisor microVM | 每个任务创建独立 COW disk、seed 和 TAP，guest runner 执行一个 job 后关机并清理 |
两种接口不能仅凭“环境一次性”就认定具有相同的隔离边界。
接入前需要结合项目设计约束和实际部署确认任务的信任范围。
旧 homelab-infra 文档中的 kind-microvm 是早期记录，不作为本项目当前 workflow 接口。
组件如何协作
当前 README 描述的 bootstrap 路径为：
Gitea workflow_job webhook
→ controller 筛选 queued job / label
→ NATS JetStream WorkQueue
→ worker 领取任务并限制并发
→ Pod 或 microVM backend 创建一次性执行环境
→ 执行一个 job，随后清理环境
microvm-runner-launch 管理 VM 的临时磁盘、网络及清理，guest-runner 领取一次性
注册凭据并以 ephemeral 模式注册。pod-worker 创建 Kubernetes 执行 Pod。
同一 runner label 的 worker 共享同一个 durable consumer，通过增加 worker 或 capacity 扩容。
webhook → NATS 是尽快验证 Pod/VM 生命周期的 bootstrap 实现。 长期目标是 controller 兼容 Gitea Runner 协议，直接注册、声明 labels、领取 task， 再交给 Pod/VM executor；不能把该目标描述为已经实现。
身份与基础设施归属
jwt-broker是早期共享 Kubernetes runner 的过渡实验；目标架构不部署它， 每个动态 Pod/VM 直接取得自己的 SPIFFE 身份。该目标不代表真实 workload 身份接入已经完成。- NATS 密码、webhook secret 和 registration token 从文件读取，不复制进知识库。
- registration token 不写入 seed image；worker 通过单次 nonce endpoint 交给 guest。
- base image 不携带 runner identity、registration token、SSH 密码或 host key。
- runner 软件保存在本项目；Kubernetes、OpenBao、LXC、bridge 和容量配置保留在 homelab-infra。
- homelab-infra 的
platform/gitea-runner/是此前的常驻 runner；本 README 不能证明它已被替换或退役。
继续阅读
- 项目 README：接口、组件、开发命令与安全边界，本轮已查阅。
- 设计原则：README 指向的完整设计约束，本轮未逐篇复核。
- Runner 协议路线：README 指向的长期调度路线与迁移边界，本轮未逐篇复核。
- SPIFFE/SPIRE：统一机器身份的设计定位与阶段依据。
后续需补充实际启用范围、workflow 验收示例和失败任务排障入口；查询前先向维护者对齐动态工作。