Tekton Dashboard 镜像文档

镜像概述

gcr.io/tekton-releases/github.com/tektoncd/dashboard/cmd/dashboard是Tektoncd项目***提供的仪表盘镜像，用于在Kubernetes集群中部署Tekton Dashboard Web UI。该镜像作为Tekton CI/CD框架的核心组件，提供直观的图形化界面，简化Tekton资源的管理、监控与操作流程。

核心功能与特性

• 资源可视化：以图形化方式展示Tekton核心资源，包括Pipeline（流水线）、Task（任务）、PipelineRun（流水线运行实例）、TaskRun（任务运行实例）等。
• 实时状态监控：实时显示资源运行状态（待处理、运行中、成功、失败等），支持状态筛选与快速定位。
• 操作界面：提供便捷的操作入口，支持手动触发PipelineRun、查看/停止运行中的资源。
• 日志集成：直接展示任务运行日志，支持日志搜索与下载，便于问题排查。
• 权限控制：与Kubernetes RBAC集成，基于用户权限展示可访问的资源，确保操作安全性。
• 多集群支持：（需配置）支持管理多Kubernetes集群中的Tekton资源。

使用场景与适用范围

• CI/CD流水线管理：开发与运维人员通过Web界面监控和管理Tekton流水线，替代纯命令行操作。
• 故障排查：通过可视化日志与状态流转，快速定位流水线或任务失败原因。
• 团队协作：非技术人员可通过界面查看CI/CD流程进度，降低使用门槛。
• Kubernetes环境：仅适用于已部署Tekton Pipelines的Kubernetes集群（1.21+版本推荐）。

使用方法与配置说明

前置条件

• Kubernetes集群（1.21+）
• 已安装Tekton Pipelines组件（参考Tekton***安装文档）
• 集群网络可访问gcr.io镜像仓库（或配置镜像代理/私有仓库同步）

部署方式

Tekton Dashboard通常通过Kubernetes资源清单部署，***提供了预配置的yaml文件：

1. 部署最新稳定版

bash
kubectl apply -f [***]

2. 部署指定版本

bash
# 替换{VERSION}为具体版本，如v0.38.0
kubectl apply -f [***]{VERSION}/release.yaml

访问方式

部署后，默认通过ClusterIP服务暴露（服务名：tekton-dashboard，命名空间：tekton-pipelines），可通过以下方式访问：

方式1：端口转发（开发环境常用）

bash
kubectl port-forward -n tekton-pipelines service/tekton-dashboard 9097:9097

访问 http://localhost:9097 即可打开Dashboard界面。

方式2：通过Ingress暴露（生产环境推荐）

创建Ingress资源（示例）：

yaml
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: tekton-dashboard-ingress
  namespace: tekton-pipelines
spec:
  rules:
  - host: tekton-dashboard.example.com
    http:
      paths:
      - path: /
        pathType: Prefix
        backend:
          service:
            name: tekton-dashboard
            port:
              number: 9097

配置参数

环境变量

Dashboard容器支持通过环境变量调整配置，常见参数如下：

自定义配置示例

通过修改Deployment资源添加环境变量：

yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: tekton-dashboard
  namespace: tekton-pipelines
spec:
  template:
    spec:
      containers:
      - name: tekton-dashboard
        image: gcr.io/tekton-releases/github.com/tektoncd/dashboard/cmd/dashboard:v0.38.0  # 指定版本标签
        env:
        - name: READ_ONLY
          value: "true"  # 启用只读模式
        - name: LOG_LEVEL
          value: "debug"  # 调整日志级别为debug

版本选择

建议使用带版本标签的镜像（如:v0.38.0）而非:latest，以确保部署稳定性。版本需与集群中Tekton Pipelines版本兼容，兼容性信息可参考Tekton Dashboard Release Notes。

注意事项

• 镜像拉取：gcr.io镜像在国内可能无法直接拉取，需配置镜像代理或使用同步至私有仓库的镜像。
• 权限配置：Dashboard默认使用tekton-dashboard服务账户，需确保其具有访问Tekton资源的RBAC权限（***部署文件已包含默认权限配置）。
• 升级：升级Dashboard时需确保与Tekton Pipelines版本匹配，避免兼容性问题。