进阶 docs.lap.dev 2026-11-18 04:52:34 · 7 阅读
第7章 Lapdev 架构详解:Kubernetes 开发环境的核心组件与协作机制
完整文档索引请见 llms.txt。本页面也提供 Markdown 版本。
Architecture
本文介绍 Lapdev 的工作原理,以及各组件之间如何协作,为你提供无缝衔接的 Kubernetes 开发环境。
Overview
Lapdev 由三个核心组件构成:
- Lapdev API Server(SaaS)—— 负责用户管理、认证鉴权,并协调环境的创建
- Lapdev-Kube-Manager(部署在你的集群内)—— 读取生产环境 manifest,管理开发环境,并将路由/拦截状态推送到 sidecar
- Devbox CLI(运行在开发者本机)—— 让本地调试能连接集群
此外,每个 pod 还会自动注入一个 Sidecar Proxy,在运行时执行路由和流量拦截。
Architecture Diagram
Component Details
Lapdev API Server (SaaS)
Lapdev 云服务负责:
- 用户认证与授权 —— 支持 GitHub/GitLab OAuth、团队管理
- 环境编排 —— 接收用户发起的环境创建请求
- 安全隧道管理 —— 在你的集群和 Lapdev 之间建立 websocket 隧道
- Preview URL 路由 —— 将自动生成的 HTTPS URL 的流量路由到你的集群
安全机制:
- 通过加密 websocket 隧道(TLS)与你的集群通信
- 不直接访问集群的 API server
- 从 lapdev-kube-manager 接收工作负载 manifest(Deployment、StatefulSet、ConfigMap、Secret),用于构建 App Catalog
- 通过 App Catalog 选择,由你决定 Lapdev 可以访问哪些工作负载
- 无法访问运行时应用数据(数据库、日志、持久化卷)
Lapdev-Kube-Manager (In Your Cluster)
lapdev-kube-manager 以单个 Kubernetes deployment 的形式部署在你的集群中,它负责:
- 读取生产 manifest —— 从生产 namespace 中发现 Deployment、StatefulSet、ConfigMap、Secret 和 Service,构建 App Catalog
- 创建开发环境 —— 将选定的工作负载复制到隔离或共享的 namespace 中
- 管理同步 —— 监控生产 manifest 的变更并更新开发环境
- 发布流量路由 —— 针对 branch environment,计算路由表并分发到 sidecar(路由由 sidecar 执行,详见 Traffic Routing Architecture)
- 建立安全隧道 —— 与 Lapdev API Server 维持 websocket 连接,用于编排调度
权限说明:
- 对生产 namespace 只有读取权限(用于读取 manifest)
- 对 Lapdev 管理的 namespace 拥有完整权限(用于创建/更新环境)
- 无权访问集群中的其他资源
Devbox CLI (Developer Machine)
lapdev devbox 命令行工具支持本地开发:
- 流量拦截 —— 将对特定服务的请求路由到 localhost(可通过 Lapdev 控制台控制)
- 集群连接 —— 透明访问集群内的服务(数据库、API、缓存)
- 安全隧道 —— 与 Lapdev API Server 建立加密连接,由其代理到你的集群
工作流程:
- 开发者运行 lapdev devbox connect,并在控制台中设置当前活跃的环境
- Devbox 建立安全隧道:Developer → Lapdev API
- Lapdev-Kube-Manager 始终处于控制平面,向 sidecar 推送拦截元数据和(可选的)直连提示,但不参与数据传输路径
- Sidecar 接收拦截配置后,针对该工作负载自行建立到 Lapdev API 的隧道,并通过隧道将拦截到的 pod 流量转发给 Devbox CLI
- 开发者的代码在 localhost 上处理请求,响应经同一隧道回流到 pod
- 未被拦截的流量则透明地继续发往集群内的服务
了解更多:Devbox Concept | Local Development with Devbox
Learn More
专项架构文档:
- Traffic Routing Architecture —— Lapdev 如何在组件之间路由流量
- Branch Environment Architecture —— 高性价比环境模式的详细说明
核心概念:
- Cluster —— 集群如何接入 Lapdev
- App Catalog —— 应用蓝图
- Environment —— 应用的运行实例
- Preview URL —— 服务的 HTTPS 访问入口
快速上手:
- Connect Your Kubernetes Cluster
- Create an App Catalog
- Create Lapdev Environment
Previous | Use Preview URLs
Next | Traffic Routing Architecture
Last updated 11 months ago