进阶 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

评论 (0)