# Tilt — Kubernetes 开发工具包 Tilt 自动化本地 Kubernetes 开发循环：监视文件、构建镜像、部署到集群。配置位于“Tiltfile”（Starlark，一种 Python 方言）中。 **资源** 将映像构建 + k8s 部署（或本地命令）捆绑到单个可管理单元中。 ## CLI 操作代理用于与正在运行的 Tilt 实例交互的命令。 ### 生命周期任务|命令 ---|--- 启动开发环境 | `向上倾斜 [-- ]` 从终端日志流开始 | `向上倾斜--流` 仅启动特定资源 | `倾斜前端后端` 以 CI/批处理模式运行（成功/失败时退出）| `倾斜 ci --超时 30m` 停止并删除已部署的资源 | ‘向下倾斜’ 更改运行时 Tiltfile 参数 | `倾斜参数 -- --标志值` 更改运行时参数（全部清除）| `倾斜参数--清除` 在“向上倾斜”中按 Ctrl+C：K8s 和 Docker Compose 资源**继续运行**。本地 `serve_cmd` 进程停止。使用“向下倾斜”进行清理。 ### 查看日志任务|命令 ---|--- 流式传输所有日志 | `倾斜日志-f` 一种资源的流日志 | `倾斜日志 -f <资源>` 仅显示错误 | `倾斜日志--级别错误` 仅显示构建日志 | `倾斜日志--源构建` 仅显示运行时日志 | `倾斜日志--源运行时` 5 分钟前的日志 | `倾斜原木--自 5m` 最后 100 行 | `倾斜日志--tail 100` JSON 输出（用于解析）| `倾斜日志--json` ### 资源管理任务|命令 ---|--- 列出所有资源 | `倾斜获取uiresources` JSON 格式的资源状态 | `倾斜获取 uiresources -o json` 详细描述资源 | `倾斜描述uiresource <名称>` 强制重建资源 | `倾斜触发器<资源>` 启用已禁用的资源 | `倾斜启用<资源>` 禁用资源 | `倾斜禁用<资源>` 等待资源就绪 | `倾斜等待--for=条件=就绪uiresource/<名称>` ### 检查与调试任务|命令 ---|--- 诊断（版本、集群）| 「倾斜医生」检查文件手表 | `倾斜获取文件手表` 描述特定文件watch | `倾斜描述文件监视<名称>` 完整的引擎状态转储 (JSON) | `倾斜倾卸发动机` 完整的 UI 状态转储 | `倾斜转储网页视图` 像 Tilt 一样测试 Docker 构建 | `倾斜 docker -- 构建 ` 列出 API 资源类型 | `tilt api 资源` Tilt API 服务器默认在 `localhost:10350` 上运行。所有“tilt get/describe/trigger”命令都与它对话。 ## 构建策略选择器情况|功能|关键细节 ---|---|--- 标准 Dockerfile | `docker_build（参考，上下文）` |监视上下文目录，自动注入到 k8s 中自定义工具链（Bazel、ko、Buildpacks）| `custom_build(ref, cmd, deps)` |必须使用 `$EXPECTED_REF` 环境变量进行标记非 Docker 构建器（Buildah、kaniko）| `custom_build(...,skips_local_docker=True)` | Builder 独立处理推送 Docker Compose 服务 | `docker_compose(configPaths)` |管理撰写生命周期舵图 | `k8s_yaml(helm('./chart'))` |本地渲染，部署到集群自定义叠加 | `k8s_yaml(kustomize('./overlay'))` |本地渲染，部署到集群 ## 实时更新决策树实时更新使用就地容器文件同步替换完整映像重建 - 秒而不是分钟。步骤|目的|订购 ---|---|--- `fall_back_on（文件）` |当这些文件更改时强制完全重建 |必须先来 `同步（本地，远程）` |将更改的文件复制到正在运行的容器 |在fall_back_on之后 `运行（cmd，触发器=文件）` |在容器中执行命令（例如，安装 deps）|同步后 `restart_container()` |重启容器进程 |必须最后来 docker_build('myapp', '.', live_update=[ fall_back_on(['requirements.txt']), 同步（'./src'，'/app/src'）， run('pip install -rrequirements.txt',trigger=['requirements.txt']), ]） **当实时更新中断时：** 对 `docker_build` 上下文之外的文件进行更改会触发完全重建。任何“sync()”路径之外的更改也会触发完全重建。首先“倾斜”总是进行完整的构建——实时更新需要一个正在运行的容器。 ## 资源配置 # 具有端口转发和依赖项的 Kubernetes 资源 k8s_resource('前端', port_forwards=['3000:3000'], resource_deps=['api', '数据库'], 标签=['网络'], 触发器模式=TRIGGER_MODE_MANUAL，） # 本地资源（构建工具、测试运行器、代码生成器） local_resource('代码生成', cmd='生成', deps=['./proto'], 标签=['工具'], ） # 本地服务器（持续运行） local_resource('故事书', serve_cmd='npm 运行故事书', deps=['./src/components'], 允许并行=真， readiness_probe=探针(http_get=http_get_action(端口=6006)), ） **并行性：**本地资源默认串行运行。为独立资源设置“allow_parallel=True”。图像构建默认为 3 个并发 — 使用 update_settings(max_parallel_updates=N) 进行调整。 **依赖项：** `resource_deps` 仅在首次准备就绪时进行控制 - 一旦依赖项准备好一次，依赖项将永久解锁该会话。 ## 调试流程服务崩溃？ → 倾斜日志 -f <资源> --source 运行时构建失败？ → 倾斜日志 -f <资源> --source build tilt docker -- build （重现 Tilt 的精确构建）重建错误的文件？ → 倾斜获取文件表倾斜描述 filewatch <名称> 检查 .tiltignore、watch_settings(ignore=)、ignore= param 强行重建？ → 倾斜触发器<资源> 资源卡住了？ → 倾斜描述 uiresource <名称> 检查resource_deps链对于 CRD： pod_readiness='ignore' 一般诊断？ → 倾斜医生完整的状态转储？ → 倾斜自卸发动机 | jq . ## 十大陷阱陷阱|修复 ---|--- `local()` 调用不跟踪文件依赖 |用 `read_file()` 换行或添加 `watch_file()` docker_build 上下文之外的实时更新路径 |确保同步本地路径位于上下文目录内本地资源相互阻塞|在独立资源上设置“allow_parallel=True” `resource_deps` 不会重新控制更新 |它仅检查首次准备情况，而不检查当前版本 Starlark 没有 while/try- except/class/recursion |使用 for 循环，“fail()”表示错误，字典表示状态 `.tiltignore` 不会影响 Docker 构建上下文 |使用 `.dockerignore` 从重建触发器和上下文中排除在 custom_build 中未使用 `$EXPECTED_REF`构建脚本必须使用此环境变量标记图像 `run()` 触发文件不在 `sync()` 步骤中 |同步步骤还必须覆盖触发路径第一个“向上倾斜”总是进行完整构建 |在容器运行之前，实时更新无法工作 CRD Pod 陷入待处理状态 |在 CRD 资源上设置 pod_readiness='ignore'` ## 其他资源 ### 参考文件有关详细的 API 签名和高级模式，请参阅： * **`references/api-reference.md`** — 按类别组织的完整 Tiltfile API 目录，Starlark 语言注释，忽略机制比较 * **`references/patterns.md`** — 多服务架构、环境配置、CI 集成、性能优化、程序化 Tilt 交互、扩展生态系统

倾斜

包含技能