如何在Tekton步骤中使用自定义容器镜像？附构建配置方法

一、自定义容器镜像的定义（Dockerfile示例） #

Tekton对自定义容器的核心要求是：容器内必须存在可执行的shell（如/bin/sh或/bin/bash），因为Tekton的script字段依赖shell执行命令。以下是两种常见场景的Dockerfile示例：

场景1：自定义命令为脚本（如Python） #

假设你的customCommand是一个Python脚本，Dockerfile可这样编写：

# 选择轻量基础镜像，alpine自带/bin/sh，满足Tekton要求
FROM alpine:3.18

# 安装脚本依赖（这里是Python3）
RUN apk add --no-cache python3

# 将自定义脚本复制到系统PATH目录（如/usr/local/bin），确保可以直接调用
COPY customCommand.py /usr/local/bin/customCommand
# 给脚本添加执行权限
RUN chmod +x /usr/local/bin/customCommand

# 可选：设置默认工作目录，Tekton会自动挂载/workspace，提前设置更规范
WORKDIR /workspace

场景2：自定义命令为编译后的二进制（如Go程序） #

用多阶段构建减小镜像体积，同时满足Tekton契约：

# 第一阶段：编译二进制文件
FROM golang:1.21-alpine AS builder

WORKDIR /app
COPY customCommand.go .
RUN go build -o customCommand customCommand.go

# 第二阶段：生成生产镜像
FROM alpine:3.18

# 复制编译好的二进制到PATH目录
COPY --from=builder /app/customCommand /usr/local/bin/

# 安装bash（可选，alpine默认有/bin/sh，若需要bash可添加）
RUN apk add --no-cache bash

WORKDIR /workspace

二、告知Tekton镜像位置及镜像仓库要求 #

1. 必须推送镜像到可被Kubernetes集群访问的仓库：
   Tekton任务运行在Kubernetes Pod中，集群节点需要能拉取到你的自定义镜像。支持的仓库包括Docker Hub、私有Harbor、GCR、ECR等。

2. 在Tekton Task中指定完整镜像路径：
   直接在step的image字段填写镜像的完整仓库地址，格式为[仓库地址]/[用户名]/[镜像名]:[标签]，示例：

   steps:
     - name: custom-step
       image: docker.io/your-username/custom-container:v1
       script: |
         #!/bin/sh
         customCommand arg1 arg2
   

3. 私有仓库的处理：
   如果使用私有镜像仓库，需要给Kubernetes配置镜像拉取密钥：

   • 创建docker-registry类型的Secret：

     kubectl create secret docker-registry regcred \
       --docker-server=你的仓库地址 \
       --docker-username=你的用户名 \
       --docker-password=你的密码 \
       --docker-email=你的邮箱
     

   • 将密钥挂载到Task使用的ServiceAccount：

     kubectl patch serviceaccount default -p '{"imagePullSecrets": [{"name": "regcred"}]}'
     

三、完整操作示例 #

1. 编写自定义命令脚本 #

创建customCommand.py：

#!/usr/bin/env python3
import sys

if __name__ == "__main__":
    args = sys.argv[1:]
    print(f"自定义命令执行成功！参数：{args}")

2. 构建并推送镜像 #

# 构建镜像，替换为你的仓库地址
docker build -t docker.io/your-username/custom-tekton-container:v1 .

# 登录镜像仓库
docker login docker.io

# 推送镜像到仓库
docker push docker.io/your-username/custom-tekton-container:v1

3. 编写Tekton Task #

创建custom-task.yaml：

apiVersion: tekton.dev/v1beta1
kind: Task
metadata:
  name: custom-task
spec:
  steps:
    - name: custom-step
      image: docker.io/your-username/custom-tekton-container:v1
      script: |
        #!/bin/sh
        customCommand hello tekton

4. 运行并查看结果 #

# 部署Task到集群
kubectl apply -f custom-task.yaml

# 启动Task并查看日志
tkn task start custom-task --showlog

执行后会看到类似如下输出：

[custom-step] 自定义命令执行成功！参数：['hello', 'tekton']

内容的提问来源于stack exchange，提问作者Geoff Alexander