Tekton Pipelines完全入门指南如何在Kubernetes上5分钟搭建云原生CI/CD流水线【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址: https://gitcode.com/gh_mirrors/pipelin/pipelineTekton Pipelines 是一个开源的 Kubernetes 云原生 CI/CD 流水线引擎它把构建、测试、部署等连续交付流程声明为标准的 Kubernetes 资源。本文带你从零开始先用一条命令 5 分钟装好 Tekton Pipelines再跑通第一个 Task最后搭建一条真实的云原生 CI/CD 流水线并附上调试技巧与资源目录速查。什么是 Tekton Pipelines一句话理解Tekton Pipelines 让你在 Kubernetes 集群上用声明式 YAML定义 CI/CD 流水线。它具备三个鲜明特点见 README.md特点含义对新手的好处☁️云原生运行在 Kubernetes 上以容器为构建块无需额外 Agent集群即 CI 引擎解耦一条 Pipeline 可部署到任意集群Task 可独立运行换仓库、换集群只需改参数类型化资源如镜像构建有类型抽象构建工具kaniko / buildkit可随意替换核心概念只有 4 个记住它们就懂了 80%Task最小执行单元由若干 Step容器组成对应 docs/taskruns.mdTaskRun一次 Task 的运行实例Pipeline按依赖关系编排多个 Task 的流水线对应 docs/pipelines.mdPipelineRun一次 Pipeline 的运行实例对应 docs/pipelineruns.md5分钟安装一条命令部署 Tekton Pipelines安装前检查一个Kubernetes 1.28 及以上的集群版本要求见 README.md 的 Required Kubernetes Version 一节配置好的kubectl当前用户具备cluster-admin权限一键安装步骤运行官方安装命令详细步骤见 docs/install.mdkubectl apply --filename https://infra.tekton.dev/tekton-releases/pipeline/latest/release.yaml验证安装成功观察控制器组件是否全部就绪全部显示1/1即安装完成kubectl get pods --namespace tekton-pipelines --watch仓库内也保留了完整的控制器部署清单方便阅读源码对照例如 config/controller.yaml、config/webhook.yaml以及各自定义资源的 CRD 定义目录 config/300-crds/如 300-pipeline.yaml、300-taskrun.yaml。 生产环境建议使用 Tekton Operator 管理升级与高可用快速安装方式更适合上手体验。快速上手跑通第一个 Task 和 TaskRun写一个最小 TaskTask 就是一个带步骤的容器任务。下面的最小示例只会打印一句话适合验证环境apiVersion: tekton.dev/v1 kind: Task metadata: name: hello-world spec: steps: - name: hello image: ubuntu script: | echo Hello, Tekton Pipelines!保存为hello.yaml并应用kubectl apply -f hello.yaml创建 TaskRun 触发执行TaskRun 通过taskRef引用 Task运行后每个 Step 会在集群里变成一个真实的 PodapiVersion: tekton.dev/v1 kind: TaskRun metadata: name: hello-run spec: taskRef: name: hello-world实时跟踪状态直到出现Succeededkubectl get taskrun --watch查看运行日志先找到 Pod 名再看step-hello容器的输出kubectl get pods kubectl logs pod名称 -c step-hello日志的完整用法包括 sidecar 日志、终止消息等见 docs/logs.md。搭建真实 CI/CD 流水线你的第一条 PipelinePipeline 的核心字段一条 Pipeline 只需声明参数params、工作区workspaces和任务列表tasks。任务之间用runAfter指定顺序用workspaces共享数据。仓库自带的完整示例可直接学习examples/v1/pipelineruns/pipelinerun.yaml示例拉代码 → 构建镜像apiVersion: tekton.dev/v1 kind: Pipeline metadata: name: build-app spec: params: - name: repo-url type: string workspaces: - name: shared-data tasks: - name: fetch-source taskRef: name: git-clone # 社区常用 Task克隆代码 workspaces: - name: output workspace: shared-data - name: build-image runAfter: [fetch-source] # 拉完代码再构建 taskRef: name: build-imagePipelineRun一次运行只需绑定参数和存储apiVersion: tekton.dev/v1 kind: PipelineRun metadata: name: build-app-run-1 spec: pipelineRef: name: build-app params: - name: repo-url value: https://example.com/myapp.git workspaces: - name: shared-data volumeClaimTemplate: spec: accessModes: [ReadWriteOnce] resources: requests: storage: 1Gi执行kubectl apply -f pipelinerun.yaml后流水线即自动调度先克隆代码再构建镜像共享同一块存储卷。Workspace 的更多玩法PVC、emptyDir、subPath 等见 docs/workspaces.md。实用进阶4 个新手必备特性1️⃣params 与 results 传递数据上游 Task 的results可以直接作为下游 Task 的params传入比如把克隆到的 commit SHA 传给构建步骤让每次构建可追溯。变量替换语法见 docs/variables.md。2️⃣when 表达式条件执行用when表达式按参数或上游结果决定某个 Task 是否运行例如只在branch main时才触发部署实现主干自动发布、分支只跑测试。3️⃣finally 任务失败也执行的收尾finally中的 Task 无论流水线成功与否都会执行适合放通知、清理、上报等收尾动作。4️⃣远程 Task直接从 Git 仓库或镜像仓库拉取不必把每个 Task 都存在集群里。Git Resolver 支持在 Pipeline 中直接引用远端仓库的 TaskresolverRef: git实现代码即流水线配置方法见 docs/git-resolver.md 与 docs/resolution-getting-started.md。此外Matrix 特性可以一条 Task 展开成多实例并行执行如一次构建多平台镜像文档在 docs/matrix.md。调试指南状态、日志与常见问题场景命令 / 入口查看运行状态kubectl get taskrun -w/kubectl get pipelinerun -w查看某次运行详情kubectl describe taskrun 名称查看某一步日志kubectl logs pod -c step-step名排查 Pod 调度/启动失败kubectl describe pod pod小技巧TaskRun 卡在Pending多半是 ServiceAccount 权限或调度资源问题用kubectl describe看事件。想看每一步的退出码与耗时describe输出的 Conditions 里都有。更深入的调试手段日志、指标、追踪可参考 docs/debug.md 与 docs/metrics.md。资源目录速查文档都在哪里仓库内置了完整文档与示例建议按此路径学习 安装docs/install.md Task / TaskRundocs/taskruns.md Pipeline 全字段说明docs/pipelines.md 工作区与数据共享docs/workspaces.md 变量替换docs/variables.md 官方示例TaskRun 与 PipelineRun 各几十个examples/v1/taskruns/ 与 examples/v1/pipelineruns/如 step-script.yaml、pipelinerun-with-params.yaml️ 控制器内部机制进阶docs/developers/README.md 与 DEVELOPMENT.md️ 版本发布与路线图releases.md、roadmap.md写在最后回到开头的问题——如何在 Kubernetes 上 5 分钟搭建云原生 CI/CD 流水线答案就是三步一条kubectl apply装好 Tekton Pipelines → 一个 YAML 跑通 TaskRun → 一条 Pipeline 串起拉代码到构建镜像的全流程。相比传统 CI 工具Tekton Pipelines 的云原生 声明式 可组合特性让流水线像 K8s 工作负载一样可版本化、可复用、可移植。下一步建议直接从 examples/v1/ 中挑一个最贴近你业务的示例改起来你会发现上手远比你想象的快。【免费下载链接】pipelineA cloud-native Pipeline resource.项目地址: https://gitcode.com/gh_mirrors/pipelin/pipeline创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考