服务网格云原生可观测性【免费下载链接】linkerd2Ultralight, security-first service mesh for Kubernetes. Main repo for Linkerd 2.x.项目地址https://gitcode.com/gh_mirrors/li/linkerd2点击查看免费下载Linkerd 是一个面向 Kubernetes 的轻量级、安全优先security-first服务网格本仓库是 Linkerd 2.x 主线开发的主仓库包含控制平面与命令行工具CLI的全部源码。阅读本文后你将掌握 Linkerd 的整体架构与仓库组织方式、分钟级快速部署流程、控制平面核心配置参数以及如何从源码构建、运行和测试这套系统。Linkerd 是什么根据仓库根目录 README.md 的定义Linkerd 是一个ultralight超轻量、security-first安全优先的 Kubernetes 服务网格。它向现有的 Kubernetes 应用栈注入三类关键能力安全security自动为服务间通信提供 mTLS 加密与身份认证可观测性observability提供成功率、延迟、流量拓扑等指标与实时请求流tap可靠性reliability重试、超时、熔断等流量治理能力。这些能力的获取不需要修改任何业务代码——通常只需在部署时通过注入inject机制为 Pod 添加一个轻量 sidecar 代理即可。Linkerd 同时也是云原生计算基金会CNCF旗下的项目其 1.x 与 2.x 版本分别维护在不同的仓库中。仓库家族与职责划分Linkerd 2.x 并非单一仓库而是由多个职责清晰的仓库共同组成。README 明确列出的完整仓库清单如下仓库职责linkerd2本仓库Linkerd 2.x 主线包含控制平面组件与linkerdCLIlinkerd2-proxy2.x 数据平面代理Rust 实现linkerd2-proxy-api数据平面代理所需的 gRPC API 的 Protobuf 定义linkerdLinkerd 1.x 版本线websitelinkerd.io 官网包含 1.x 与 2.x 的文档源码从 BUILD.md 可以进一步确认本仓库内部的语言与技术栈控制平面及其扩展使用 Go 编写数据平面代理使用 Rust 编写Dashboard 用户界面则是 React 应用。仓库根目录的 go.modGo 模块与 Cargo.toml、rust-toolchain.tomlRust 工具链从侧面印证了这一多语言布局。本仓库内部结构控制平面、CLI 与扩展本仓库linkerd2的组织方式围绕控制平面 CLI 扩展展开关键目录如下cli/linkerd命令行工具的 Go 源码是用户驱动控制平面的主要入口controller/控制平面核心微服务viz/Viz 扩展可观测性multicluster/Multicluster 扩展跨集群policy-controller/ 与 policy-test/Rust 编写的策略控制器及其测试charts/控制平面、CRD 与代理注入所需的 Helm Chartstest/、testutil/端到端集成测试与测试辅助库。控制平面核心组件根据 BUILD.md 的组件说明控制平面由以下 Go 微服务构成destination源码位于 controller/api/destination接收来自代理proxy的请求并返回服务发现信息是代理获取端点与策略的核心服务proxy-injector源码位于 controller/proxy-injector一个 Mutating Admission Webhook在 Pod 创建时被触发把代理容器以 sidecar 形式注入identity源码位于 controller/identity充当 CA向代理签发证书使代理之间能够建立 mTLS 连接此外还包括 heartbeat心跳上报、sp-validatorServiceProfile 校验等组件统一入口见 controller/cmd。以注入链路为例controller/proxy-injector/webhook.go 中的Inject函数接收 AdmissionRequest依据请求对象的元数据与类型构造ResourceConfig随后生成注入报告与 JSON Patch若资源存在 Owner如 Deployment 下的 Pod还会通过事件机制记录注入或跳过事件。这解释了无需改代码、只改部署背后的自动化机制。CLI 命令体系linkerdCLI 使用 Cobra 框架组织命令根命令定义在 cli/cmd/root.go。从源码可见其全局参数与子命令结构全局参数包括--linkerd-namespace/-L默认linkerd、--cni-namespace默认linkerd-cni、--kubeconfig、--context、--as/--as-group模拟身份、--api-addr直连控制平面、--verbose调试日志等核心子命令有install、upgrade、uninstall、inject、uninject、check、version、profile、diagnostics、identity、install-cni-plugin等扩展子命令通过multicluster.NewCmdMulticluster()与viz.NewCmdViz()挂载同时dashboard、stat、tap、top、routes、edges等旧命令被标记为 deprecated提示改用linkerd viz 子命令。快速上手分钟级部署README 指出Linkerd 可以在任何现代 Kubernetes 集群上于数秒到数分钟内完成部署详细步骤见官方 Getting Started 指南。结合 BUILD.md 中的安装流程核心两步安装法如下# 第一步安装 CRDCustom Resource Definitions linkerd install --crds | kubectl apply -f - # 第二步安装控制平面 linkerd install | kubectl apply -f -在 cli/cmd/install.go 中可以看到这条链路的实现细节不带--crds时install会先渲染 CRD 清单并调用healthcheck.CheckCustomResourceDefinitions检查集群中是否已存在所需 CRD若缺失会提示必须先执行linkerd install --crdsinstall同时检查集群中是否已存在linkerd-configConfigMap若已存在则提示改用linkerd upgrade避免重复安装覆盖支持--set、--values、--set-string、--set-file等 Helm 风格参数对安装进行定制输出格式可用--output/-o在json|yaml间切换若只想生成安装清单而不连接集群可使用--ignore-cluster标志。安装完成后可用linkerd check校验集群是否符合运行条件、linkerd version核对 CLI 与服务器版本若安装了 Viz 扩展还可通过linkerd viz dashboard打开图形化面板、linkerd viz stat deployments查看各工作负载的成功率与延迟、linkerd viz tap观察实时请求流。控制平面核心配置要点控制平面的全部可配置项集中在 Helm Chart 的 charts/linkerd-control-plane/values.yaml 中共 700 余行注释即 helm-docs 文档来源。以下是最常用的一组参数参数默认值说明clusterDomaincluster.localKubernetes 集群 DNS 域名clusterNetworks多个 IPv4 私网段 fd00::/8服务发现覆盖的集群网络范围imagePullPolicyIfNotPresent镜像拉取策略controllerLogLevelinfo控制平面组件日志级别linkerdVersion占位符linkerdVersionValue控制平面版本安装前需替换为实际版本号identityTrustAnchorsPEM空信任根证书ECDSA安装时必须提供identityTrustDomain默认取clusterDomain身份信任域proxy.image.namecr.l5d.io/linkerd/proxy代理镜像仓库proxy.ports.admin/control/inbound/outbound4191/4190/4143/4140代理四个端口的固定约定proxy.opaquePorts25,587,3306,4444,5432,6379,9300,11211默认 opaque 端口集SMTP/MySQL/PostgreSQL/Redis 等 server-first 协议proxy.nativeSidecartrue是否启用 Kubernetes 原生 sidecar 容器模式proxy.defaultInboundPolicyall-unauthenticated无Server选中 Pod 时的默认入站策略policyController.probeNetworks0.0.0.0/0、::/0允许执行探针的网络范围controller.tracing.enabledfalse控制平面分布式追踪开关其中linkerdVersion的占位符问题在 BUILD.md 中有专门说明使用 Helm Chart 前必须将其替换为合适的版本字符串例如edge-20.2.2。此外Chart 结构上还包含三个辅助 Chartcharts/linkerd-crds安装所需 CRD、charts/patch代理容器规格供 proxy-injector 注入时引用、charts/partials三者共用的子 Chart。安全优先安全策略与第三方审计安全是 Linkerd 的第一优先级。README 指向的安全策略文档 SECURITY.md 明确说明开发全程贯彻安全理念采用代码评审、依赖卫生与供应链安全Dependabot、模糊测试Fuzz testing、第三方安全审计以及人工/静态/动态检查等多种手段发现漏洞时应通过 GitHub Security Advisory 提交维护者会根据严重程度评估处理优先级影响 Linkerd 安全姿态的关键问题会得到即时修复且一旦合入 main将在下一个 edge 版本中发布修复。尤为重要的是Linkerd 将 CNCF 提供的第三方安全审计报告原样公开在仓库的 audits/ 目录下目前包含 2019 年、2022 年Final Report 与 Threat Model 两份以及 2024 年LNK-01的审计成果任何人可直接查阅体现了安全必须可验证的项目姿态。在仓库中工作从源码构建与开发BUILD.md 是仓库开发的总纲它提供了从零构建 Linkerd2 的完整指引其中包含几种典型的开发配置。综合开发环境k3d Docker最贴近生产发布形态的开发方式是使用 k3d 集群 Docker 镜像构建的综合配置流程如下# 创建 k3d 集群 bin/k3d cluster create # 构建全部 Docker 镜像 bin/docker-build # 将镜像加载进 k3d bin/image-load --k3d # 安装 Linkerd先 CRD 后控制平面 bin/linkerd install --crds | kubectl apply -f - bin/linkerd install | kubectl apply -f - # 安装 viz 扩展 bin/linkerd viz install | kubectl apply -f - # 校验安装 bin/linkerd check --expected-version $(bin/root-tag) # 打开 Dashboard 并注入示例应用emojivoto bin/linkerd viz dashboard curl https://run.linkerd.io/emojivoto.yml | bin/linkerd inject - | kubectl apply -f -由于tap依赖注入时写入的元数据对控制平面组件执行linkerd viz tap前需要先重启它们kubectl -n linkerd rollout restart deploy使 tap-injector 生效。若需把自建镜像发布到外部环境使用可设置DOCKER_REGISTRY环境变量默认官方仓库为cr.l5d.io/linkerd并在linkerd install时以--registry指定扩展则通过 Helm value 指定如linkerd viz install --set defaultRegistry...。Go 组件的快速迭代仓库提供了bin/go-run脚本替代go run利用go build缓存加快编辑-构建-调试循环。例如在分支代码上运行linkerd checkbin/go-run cli check要在本地单独运行某个控制平面组件如 destination可结合-kubeconfig与-log-levelbin/go-run controller/cmd destination -kubeconfig ~/.kube/config -log-level debug配套的测试客户端位于 controller/script/destination-client可向 destination 服务发送测试请求bin/go-run controller/script/destination-client -path hello.default.svc.cluster.local:80代码质量方面Go 代码使用golangci-lint做静态检查统一用goimports格式化版本以 go.mod 为准CI 通过bin/fmt校验。CLI 二进制默认通过 Docker 构建bin/docker-build-cli-bin目标平台由 cli/Dockerfile 的最终阶段决定可用DOCKER_TARGET交叉编译本地直接构建则用bin/build-cli-bin。Helm Chart 开发开发 Chart 时务必使用 bin/helm 包装脚本以保持与 CI 一致的 Helm 版本例如bin/helm install linkerd-crds -n linkerd --create-namespace charts/linkerd-crds bin/helm install linkerd-control-plane -n linkerd \ --set-file identityTrustAnchorsPEMca.crt \ --set-file identity.issuer.tls.crtPEMissuer.crt \ --set-file identity.issuer.tls.keyPEMissuer.key \ charts/linkerd-control-plane修改 charts/linkerd-control-plane/templates 或 charts/partials 下的模板后需运行bin/helm-build刷新依赖并 lint 模板。Chart 文档由 helm-docs 根据values.yaml中的# --注释自动生成扩展 Chart 则分别位于 viz/charts/linkerd-viz 与 multicluster/charts/linkerd-multicluster。测试体系从单元测试到多云集成测试TEST.md 系统性地介绍了仓库内全部测试的运行方式这些测试大部分在 CI 中自动执行也可按以下方式在本地复现。单元测试Gogo test -cover -race ./...需要可视化覆盖率时用go tool cover -html模板文本断言失败时可用LINKERD_TEST_PRETTY_DIFF环境变量输出彩色全文差异cli/cmd/testdata/*.golden这类黄金文件可用go test ./cli/cmd/... --update自动重新生成JavaScriptDashboard依赖由 yarn 管理用 jest 运行常用命令为bin/web setup、bin/web test并支持-o仅测最近变更、-t 名称按 spec 名过滤、--watch/--watchAll监听模式Shellbin/shellcheck -x bin/*对仓库脚本做静态检查。集成测试端到端测试套件位于 test/integration默认通过 k3d 自动创建 k3s 集群运行该路径无需额外前置条件若要在已有集群上运行则需传入--skip-cluster-create并确保被测镜像对集群可见本地 k3d/KinD 可用bin/image-load --kind|k3d加载。入口脚本为bin/tests要求传入linkerd二进制的绝对路径# 运行全部测试使用已安装的 CLI bin/tests which linkerd # 只运行单个测试如 upgrade bin/tests --name upgrade /path/to/linkerd # 使用本地构建产物 bin/docker-build bin/tests $PWD/bin/linkerd其中cluster-domain、cni-calico-deep、multicluster三个特殊测试需要定制集群配置自定义集群域名、Calico CNI、双集群共享信任根因此默认不随全套运行需显式用--name指定。编写新测试时在 test/ 下新建_test.go文件并放入testdata/配置即可被自动发现测试辅助库集中在 testutil可用godoc github.com/linkerd/linkerd2/testutil查看说明。此外还有规模测试bin/test-scale单控制平面下扩展数百 Pod与多云测试bin/test-clouds面向 EKS/GKE/AKS/DO 四个云厂商。社区参与与治理README 列出了完整的参与途径用户/开发者/公告三个邮件列表、Twitter 与 Slack并欢迎 Pull Request贡献规范见 CONTRIBUTING.md。项目治理资料同样存放在仓库中包括 GOVERNANCE.md、MAINTAINERS.md、STEERING.md、ADOPTERS.md采纳者名单与 AMBASSADORS.md布道者名单。Linkerd Steering Committee 定期举行线上会议会议时间在用户邮件列表上公告所有人都可旁听音频视频参与限于委员会成员与维护者。社区行为准则见 CODE_OF_CONDUCT.md。开源许可本仓库采用 Apache License 2.0详见 LICENSE版权归 Linkerd Authors2025所有。只要遵循许可条款即可自由使用、修改与再分发这些文件按 README 中 LICENSE 章节的说明可访问https://www.apache.org/licenses/LICENSE-2.0获取许可文本副本。小结通过本仓库的 README 及其配套文档与源码可以完整勾勒出 Linkerd 2.x 的全貌一个安全优先、无需改码的轻量 Kubernetes 服务网格由 Go 控制平面、Rust 数据平面代理与 React Dashboard 构成配套完整的 CLI、Helm Charts、测试体系与公开的安全审计机制。无论是快速部署、定制配置还是深入源码参与开发本仓库的文档与代码都提供了清晰、可验证的指引。赞分享服务网格云原生可观测性【免费下载链接】linkerd2Ultralight, security-first service mesh for Kubernetes. Main repo for Linkerd 2.x.项目地址https://gitcode.com/gh_mirrors/li/linkerd2点击查看免费下载相关推荐SuperpowersClaude Code技能库完整指南SuperpowersClaude Code技能库完整指南 Superpowers 是 Claude Code 技能库一套可组合的 AI 开发工作流它约束AI 技能AI 插件开发工具andrej-karpathy-skills 使用指南用一份 CLAUDE.md 约束 AI 编码助手andrej karpathy skills 使用指南用一份 CLAUDE.md 约束 AI 编码助手 andrej karpathy skills 是一个行AI 技能提示工程Apache InLong vs 传统数据流工具为什么它是企业级首选Apache InLong vs 传统数据流工具为什么它是企业级首选 在当今数据驱动的时代企业对实时数据处理的需求日益增长。Apache InLong作为大数据后端创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考