tekton中无官方python pipeline模板，最小可行组合是：指定python版本的基础镜像、显式挂载workspace的task、串联构建/测试/推送的pipeline；需分步执行pip安装与命令运行，验证pip存在，用绝对路径并避免windows特有语法。
Python Pipeline 在 Tekton 中没有现成模板
Tekton 本身不提供官方的 Python Pipeline 模板，所有所谓“Python 模板”都是社区或团队自建的 Task 组合。直接找 tekton-pipeline-python-template 这类仓库，大概率是某公司内部封装、版本陈旧，或强行把通用 Task 堆在一起没做验证。
真正能跑通 Python Pipeline 的最小组合
核心就三块：一个带 python:3.11-slim（或你项目指定版本）的基础镜像、一个执行命令的 Task、一个串起构建/测试/推送的 Pipeline。别被“模板”二字带偏——重点是镜像内容和 Task 的输入输出设计是否匹配你的工作流。
-
Task必须显式挂载workspace，否则git-clone下来的代码根本进不去 Python 容器 - 不要在
Task的steps[0].script里写多行 pip install + python setup.py；拆成两个step：一个装依赖（用--user或venv），一个跑命令，否则失败时无法定位是环境问题还是代码问题 -
Pipeline的params尽量只传必要字段，比如pythonVersion、testPattern；别传整个requirements.txt内容作为参数，Tekton 不处理大文本参数的编码/截断边界
pip install 失败但日志只显示 “command not found”
这不是网络或源的问题，是镜像里压根没装 pip。Alpine 镜像默认没 pip，python:3.11-slim 虽有但可能被删了（某些定制镜像干这事）。运行前先加一步验证：
steps:
- name: check-pip
image: python:3.11-slim
script: |
which pip || (echo "pip missing" && exit 1)更稳妥的做法是在 Dockerfile 构建阶段显式安装：RUN apt-get update && apt-get install -y python3-pip（Debian 系），或 RUN apk add py3-pip（Alpine）。
立即学习“Python免费学习笔记（深入）”；
本地调试 Task 时容器秒退
常见原因是 Task 的 step 没设 workingDir，或 workspace 挂载路径和脚本里写的路径对不上。比如 git-clone 默认把代码放 /workspace/source，但你的 script 直接写 cd src && pytest，当然找不到目录。
- 始终用绝对路径：把
workingDir: /workspace/source显式写进step - 调试时临时加个
ls -la /workspace步骤，确认文件结构 - 别依赖
ENTRYPOINT或CMD—— Tekton 的step是直接调sh -c，镜像原有启动逻辑不会生效
真正麻烦的是跨平台路径差异：Windows 开发者写的 script 里含 \ 或 dir，一到 Linux 容器就挂。CI 环境只认 POSIX，这点没法妥协。
