aipipeline/kubeclient

kubectl-wrapper

镜像概述和主要用途

kubectl-wrapper是一个包装了kubectl的容器镜像，主要作为https://github.com/tektoncd/pipeline%E7%9A%84%E6%AD%A5%E9%AA%A4%EF%BC%88step%EF%BC%89%E4%BD%BF%E7%94%A8%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E6%B5%81%E6%B0%B4%E7%BA%BF%E4%B8%AD%E5%AF%B9Kubernetes%E8%B5%84%E6%BA%90%E6%89%A7%E8%A1%8C%E5%88%9B%E5%BB%BA%E3%80%81%E5%88%A0%E9%99%A4%E3%80%81%E5%BA%94%E7%94%A8%E3%80%81%E8%A1%A5%E4%B8%81%E3%80%81%E6%9B%BF%E6%8D%A2%E7%AD%89%E6%93%8D%E4%BD%9C%E3%80%82

核心功能和特性

• 支持多种Kubernetes资源操作：包括get、create、apply、delete、replace、patch
• 条件判断机制：通过success-condition和failure-condition表达式评估资源状态，判断步骤执行结果
• 灵活的补丁合并策略：支持strategic（默认）、merge和json三种补丁合并策略
• 资源字段提取：通过JSONPath从资源中提取指定字段，并输出到Tekton结果文件
• 所有者引用设置：可选择将步骤所在Pod设置为资源的所有者引用

使用场景和适用范围

适用于Tekton流水线中需要与Kubernetes集群交互的场景，例如：

• 在流水线中部署Kubernetes资源（如Deployment、Job、ConfigMap等）
• 检查资源部署状态或特定条件是否满足
• 从Kubernetes资源中提取关键信息供后续步骤使用
• 清理流水线执行过程中创建的临时资源

使用方法和配置说明

参数说明

action

• 描述：对资源执行的操作
• 支持值：get、create、apply、delete、replace、patch
• 必需：是

manifest

• 描述：要部署的资源内容
• 格式：Kubernetes资源清单（YAML格式）
• 必需：是（除get操作外）

success-condition/failure-condition

• 描述：可选的状态评估表达式，在资源每次更新时进行评估
  • 若failure-condition评估为true，步骤判定为失败
  • 若success-condition评估为true，步骤判定为成功
• 语法：使用Kubernetes标签选择器语法，可应用于资源的任何字段（不仅限于标签）
• 多个条件：通过逗号分隔表示AND关系
• 参考文档：[***]
• 必需：否

merge-strategy

• 描述：补丁合并策略
• 支持值：strategic（默认）、merge、json
• 适用操作：patch
• 必需：否（patch操作时建议指定）

output

• 描述：从资源字段中提取的内容，仅支持JSONPath
• 格式：YAML数组（即使只有一个项也需使用数组形式）
• 输出位置：提取的值将写入/tekton/results/$(name)
• 示例：

yaml
- name: output
  value: |
    - name: job-name
      valueFrom: '{.metadata.name}'
    - name: job-namespace
      valueFrom: '{.metadata.namespace}' 

• 必需：否

set-ownerreference

• 描述：是否将步骤所在Pod设置为资源的ownerReferences
• 类型：布尔值
• 默认值：false
• 必需：否